Claude Platform Docs
Documentation

迁移到 Claude Mythos 5 和 Claude Fable 5

从 Claude Mythos Preview、Claude Opus 5 或 Claude Opus 4.8 迁移到 Claude Mythos 5 和 Claude Fable 5：模型 ID、API 变更以及迁移检查清单。

Claude Fable 5 专为高要求的推理和长周期智能体工作而构建。Claude Fable 5.1 在其基础上进一步发展。Claude Fable 5 可在 Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud 和 Microsoft Foundry 上使用。Claude Mythos 5 具有相同的能力，仅向 Project Glasswing 中获得批准的客户提供。

claude-fable-5 和 claude-mythos-5 共享的基线设置：

  • 思考： "Adaptive thinking"（自适应思考）始终开启。模型会在每个请求中自行决定何时思考以及思考多少，无需任何 thinking 配置。thinking: {type: "disabled"} 和手动 "extended thinking"（扩展思考）（thinking: {type: "enabled", budget_tokens: N}）都会返回 400 错误。
  • 预填充： 预填充助手消息会返回 400 错误。请改用系统提示指令。
  • 上下文窗口和输出： 默认提供 1M 令牌的 "context window"（上下文窗口），每个请求最多可输出 128k 令牌。
  • 定价： 每百万输入令牌 10 美元，每百万输出令牌 50 美元。请参阅 Claude 定价。
  • 数据保留： 两个模型都要求 30 天数据保留，除非获得 Anthropic 明确授权，否则不适用于 "zero data retention"（零数据保留），即 ZDR 安排。两者均被指定为 Covered Models（受保护模型）。在 Claude API 上，如果某组织的数据保留配置不满足此要求，则其向 Claude Fable 5 发出的请求会返回 400 invalid_request_error。拥有 ZDR 安排的组织应联系其 Anthropic 客户团队讨论数据保留配置，或按工作区配置数据保留。有关各平台的详细信息，请参阅特定模型的数据保留要求。

两个模型的不同之处：

  • 可用性： Claude Fable 5 不需要访问审批。Claude Mythos 5 仅向 Project Glasswing 中获得批准的客户提供。
  • 安全分类器： Claude Fable 5 运行安全分类器，可能会以 stop_reason: "refusal" 拒绝请求。Claude Mythos 5 不包含这些分类器。请参阅拒绝与回退。
  • Priority Tier： Priority Tier 在 Claude Fable 5 上受支持，但在 Claude Mythos 5 上不受支持。

从 Claude Mythos Preview 迁移到 Claude Mythos 5 和 Claude Fable 5

Claude Mythos 5 是 Claude Mythos Preview（仅限受邀的研究预览版）的访问受限继任者。Claude Fable 5 提供相同的能力，且不需要访问审批。本节中的变更同样适用于这两个目标模型。

迁移基本上是即插即用的。Claude Mythos 5 和 Claude Fable 5 使用与 Claude Mythos Preview 相同的 Messages API 和相同的 "tool use"（工具使用）模式，并且由于三个模型使用相同的分词器，令牌计数大致不变。需要检查的关键变更是不再可用的功能（在下一节中列出）以及思考输出。如果您迁移到 Claude Fable 5，还需为安全分类器拒绝做好准备，这是 Claude Mythos Preview 和 Claude Mythos 5 所没有的；请参阅拒绝与回退。

有关 Claude Mythos Preview 的退役时间表，请参阅模型弃用。

更新您的模型名称

model = "claude-mythos-preview"  # Before
model = "claude-mythos-5"  # After

# 或者，使用具有相同能力且无需访问审批的模型：
model = "claude-fable-5"  # After

Claude Mythos 5 和 Claude Fable 5 上不可用的功能

  1. 扩展思考和思考令牌预算： 手动扩展思考（thinking: {type: "enabled", budget_tokens: N}）在 claude-mythos-5 或 claude-fable-5 上不受支持，会返回 400 错误。自适应思考始终开启：模型会在每个请求中自行决定何时思考以及思考多少，无需任何 thinking 配置。thinking: {type: "disabled"} 会返回错误。budget_tokens 没有直接的替代项：思考是自适应的，而 effort 参数是一个独立的输出级控制，而非思考预算。

    之前（Claude Mythos Preview）：

    client.messages.create(
    model="claude-mythos-preview",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)

    之后（Claude Mythos 5）：

    client.messages.create(
    model="claude-mythos-5",
    max_tokens=16000,
    messages=[{"role": "user", "content": "..."}],
)

    Claude Fable 5 的变更完全相同，只是模型名称为 claude-fable-5。

  2. 助手预填充： 预填充助手消息在 claude-mythos-5 或 claude-fable-5 上不受支持，会返回 400 错误，与 Claude Mythos Preview 相同。请改用系统提示指令。

  3. 思考输出： 在 claude-mythos-5 和 claude-fable-5 上，原始思维链永远不会被返回，但当 thinking.display 设置为 summarized 时，思考块仍会携带可读的摘要文本。在同一模型上继续对话时，请原样传回思考块。请参阅 Claude Fable 和 Claude Mythos 模型上的思考输出。

令牌计数和计费

claude-mythos-5 和 claude-fable-5 使用与 claude-mythos-preview 相同的分词器（随 Claude Opus 4.7 引入的分词器）。从 claude-mythos-preview 迁移时，令牌计数大致不变。与 Claude Opus 4.7 之前的模型相比，相同内容的分词结果可能会多出大约 30% 的令牌，具体因内容和工作负载形态而异。

与 claude-mythos-preview 相比，/v1/messages/count_tokens 对 claude-mythos-5 和 claude-fable-5 返回的值大致不变。请在您自己的工作负载上重新建立成本和延迟基线。

迁移检查清单

  • 将模型名称从 claude-mythos-preview 更新为 claude-mythos-5，或更新为 claude-fable-5，后者提供相同的能力且不需要访问审批。
  • 移除手动扩展思考配置（thinking: {type: "enabled", budget_tokens: N}）。自适应思考始终开启，无需 thinking 字段。
  • 移除任何 thinking: {type: "disabled"} 配置。在 claude-mythos-5 和 claude-fable-5 上禁用思考会返回错误。
  • 移除 budget_tokens。它没有直接的替代项：思考是自适应的，而 effort 参数是一个独立的输出级控制，而非思考预算。
  • 确认任何解析 thinking 字段的代码仅将其视为显示文本，并在同一模型上继续对话时原样传回思考块。thinking.display 在 claude-mythos-5 和 claude-fable-5 上默认为 "omitted"，与 Claude Mythos Preview 相同。设置 display: "summarized" 以接收可读摘要。请参阅 Claude Fable 和 Claude Mythos 模型上的思考输出。
  • 如果您在较早的模型上重放对话历史，请先从之前的助手轮次中剥离 thinking 和 redacted_thinking 块。来自 claude-fable-5 和 claude-mythos-5 的思考块只能由生成它们的模型或更新的模型读取：较早的模型会静默忽略它们，而 Claude Fable 5.1 和 Claude Mythos 5.1 可以读取它们，因此当您将对话升级到这些模型时请保留它们（请参阅保留的思考）。剥离可使发往较早模型的请求保持最小化和统一。
  • 如果您迁移到 Claude Fable 5，请处理 stop_reason: "refusal" 并读取 stop_details.category 字段。Claude Fable 5 运行 Claude Mythos Preview 和 Claude Mythos 5 所没有的安全分类器。请参阅拒绝与回退。
  • 在您自己的工作负载上重新建立令牌计数和成本基线。从 claude-mythos-preview 迁移时，令牌计数大致不变。

从 Claude Opus 5 迁移到 Claude Mythos 5 和 Claude Fable 5

Claude Fable 5 和 Claude Mythos 5 使用与 Claude Opus 5 相同的 Messages API 和相同的工具使用模式，默认具有相同的 1M 令牌上下文窗口和相同的 128k 最大输出令牌。预填充和采样参数限制以及思考显示行为均从 Claude Opus 5 原样延续。需要检查的变更是始终开启的思考、定价、Priority Tier 和数据保留。

更新您的模型名称

model = "claude-opus-5"  # Before
model = "claude-fable-5"  # After

# 或者，使用具有相同功能的 Project Glasswing 模型：
model = "claude-mythos-5"  # After

变更内容

  1. 思考不再可以禁用： 在 Claude Opus 5 上，思考默认开启，并且可以在 effort 级别为 high 或更低时通过 thinking: {type: "disabled"} 关闭。在 claude-fable-5 和 claude-mythos-5 上，自适应思考始终开启，thinking: {type: "disabled"} 在任何 effort 级别下都会返回 400 错误。请移除 thinking: {type: "disabled"} 配置，改用较低的 effort 级别来控制令牌消耗。

    如果您的 Claude Opus 5 请求禁用了思考，则响应形态会发生变化：响应可能在第一个 text 块之前以一个或多个 thinking 块开头，在默认的 display: "omitted"（与 Claude Opus 5 相同的默认值）下，这些块返回时 thinking 字段为空。按位置读取回复的代码（例如 content[0].text，或将第一个内容块视为文本的流处理程序）必须改为按 type 字段选择内容块，并且工具使用循环必须将 thinking 块连同其工具结果完整且未经修改地传回。API 会以 400 错误拒绝经过编辑、重新排序或部分丢弃的思考块（请参阅保留思考块）。即使思考文本未被返回，思考令牌也会按输出令牌计费。

  2. 定价： Claude Fable 5 和 Claude Mythos 5 的定价为每百万输入令牌 10 美元、每百万输出令牌 50 美元，而 Claude Opus 5 为 5 美元和 25 美元。请参阅 Claude 定价。

  3. Priority Tier： Priority Tier 在 Claude Opus 5 上不受支持，因此现有流量不受影响。如果您的组织有 Priority Tier 承诺，Claude Fable 5 支持它；Claude Mythos 5 不支持。

  4. 数据保留： Claude Fable 5 和 Claude Mythos 5 要求 30 天数据保留，除非获得 Anthropic 明确授权，否则不适用于零数据保留（ZDR）安排。两者均被指定为 Covered Models（受保护模型）。请参阅特定模型的数据保留要求。

迁移检查清单

  • 将模型名称从 claude-opus-5 更新为 claude-fable-5（或 claude-mythos-5）。
  • 移除任何 thinking: {type: "disabled"} 配置；它在 claude-fable-5 和 claude-mythos-5 上会返回 400 错误。改用较低的 effort 级别来控制令牌消耗，并为在 Claude Opus 5 上禁用思考运行的工作负载重新审视 max_tokens。
  • 如果这些工作负载按位置读取内容（例如 content[0].text），请将其更新为按 type 选择内容块：thinking 块现在会在 text 块之前到达。在工具使用循环中完整且未经修改地传回 thinking 块；修改过的块会返回 400 错误。
  • 如果您的组织有零数据保留（ZDR）安排，请在迁移前确认资格：除非获得 Anthropic 明确授权，否则这些模型不适用于 ZDR。请参阅特定模型的数据保留要求。
  • 在您自己的工作负载上重新建立成本基线。令牌计数大致不变；每令牌定价不同，并且之前禁用思考运行的工作负载现在会产生思考令牌，这些令牌按输出令牌计费。

从 Claude Opus 4.8 迁移到 Claude Mythos 5 和 Claude Fable 5

迁移基本上是即插即用的。Claude Fable 5 和 Claude Mythos 5 使用与 Claude Opus 4.8 相同的 Messages API 和相同的工具使用模式，默认具有相同的 1M 令牌上下文窗口和相同的 128k 最大输出令牌。由于这些模型使用相同的分词器，令牌计数大致不变。需要检查的关键变更是始终开启的自适应思考、思考输出、安全分类器拒绝（仅 Claude Fable 5）以及定价。

更新您的模型名称

model = "claude-opus-4-8"  # Before
model = "claude-fable-5"  # After

# 或者，对于具有相同功能的 Project Glasswing 模型：
model = "claude-mythos-5"  # After

变更内容

本节中的各项描述了在您更换模型 ID 后值得检查的 API 和行为差异。除另有说明外，它们同样适用于 claude-fable-5 和 claude-mythos-5。

  1. 自适应思考始终开启： 自适应思考是 claude-fable-5 和 claude-mythos-5 上唯一的思考模式。模型会在每个请求中自行决定何时思考以及思考多少，无需任何 thinking 配置。thinking: {type: "disabled"} 会返回错误。使用 effort 参数来控制思考深度。

    需要检查的行为变更：在 Claude Opus 4.8 上，没有 thinking 字段的请求在不思考的情况下运行；在 claude-fable-5 和 claude-mythos-5 上，同样的请求会以自适应思考运行。max_tokens 仍然是总输出（思考加响应文本）的硬性限制，因此请为在 Claude Opus 4.8 上不思考运行的工作负载重新审视它。请参阅成本控制。响应也可能在第一个 text 块之前以一个或多个 thinking 块开头，因此按位置读取回复的代码（例如 content[0].text，或将第一个内容块视为文本的流处理程序）必须改为按 type 字段选择内容块。即使思考文本未返回给您，思考令牌也会按输出令牌计费，因此在 Claude Opus 4.8 上不思考运行的工作负载每个请求会产生更多输出令牌，这是在每令牌价格差异之外的额外开销。

    如果您运行工具使用循环，请在返回工具结果时将每个助手响应中的 thinking 块完整且未经修改地传回 API，包括 thinking 字段为空的块。请按接收到的原样回传助手消息，而不是按类型过滤其内容块或重新构建它：API 会以 400 错误拒绝经过编辑、重新排序或部分丢弃的思考块。请参阅保留思考块。

    之前（Claude Opus 4.8）：

    client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

    之后（Claude Fable 5）：

    client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

    Claude Mythos 5 的变更完全相同，只是模型名称为 claude-mythos-5。

  2. 扩展思考和思考预算（未变更）： 手动扩展思考（thinking: {type: "enabled", budget_tokens: N}）在 claude-fable-5 或 claude-mythos-5 上不受支持，会返回 400 错误，与 Claude Opus 4.8 相同。budget_tokens 没有直接的替代项：思考是自适应的，而 effort 参数是一个独立的输出级控制，而非思考预算。

  3. 助手预填充（未变更）： 预填充助手消息在 claude-fable-5 或 claude-mythos-5 上不受支持，会返回 400 错误，与 Claude Opus 4.8 相同。请改用系统提示指令。

  4. 思考输出： 在 claude-fable-5 和 claude-mythos-5 上，原始思维链永远不会被返回，但当 thinking.display 设置为 summarized 时，思考块仍会携带可读的摘要文本。在同一模型上继续对话时，请原样传回思考块。请参阅 Claude Fable 和 Claude Mythos 模型上的思考输出。

  5. 安全分类器和 refusal 停止原因（仅 Claude Fable 5）： claude-fable-5 会对请求以及在响应生成期间运行安全分类器。Claude Mythos 5 不包含这些分类器。当分类器拒绝请求时，Messages API 会以成功的 HTTP 200 响应返回 stop_reason: "refusal"，而不是错误。stop_details.category 字段报告触发的是哪个分类器，类别包括 "cyber"、"bio" 和 "reasoning_extraction" 等，或者当拒绝不对应任何命名类别时为 null。完整列表请参阅拒绝类别表。

    对于在生成任何输出之前被拒绝的请求，您不会被收取输入令牌费用。当分类器在流式传输中途触发时，输入和已流式传输的输出会被计费；请丢弃部分输出。

    要在另一个模型上自动重新运行被拒绝的请求，请传递可选启用的 fallbacks 参数，该参数在 Claude API 上处于 beta 阶段。该参数在 Message Batches API 上以及 Amazon Bedrock、Google Cloud 和 Microsoft Foundry 上不可用；在这三个平台上，请在客户端运行重试或使用 SDK 拒绝回退中间件。请参阅拒绝与回退。

  6. 从 high effort 开始： effort 参数的默认值仍为 high。在 Claude Opus 4.8 上，对于编码和高自主性工作的建议是显式设置 xhigh。在 claude-fable-5 和 claude-mythos-5 上，请将 high 用作大多数任务的默认值，并将 xhigh 保留给对能力最敏感的工作负载。较低的 effort 设置仍然表现良好，并且通常超过先前模型上 xhigh 的性能。如果任务能够完成但耗时超过必要，请降低 effort。请参阅提示 Claude Fable 5。

  7. 更低的提示缓存最小值： claude-fable-5 和 claude-mythos-5 上可缓存的最小提示长度为 512 令牌，低于 Claude Opus 4.8 上的 1,024 令牌。在 Claude Opus 4.8 上因太短而无法缓存的提示现在可以创建缓存条目，无需任何代码更改。有关各模型的最小值，请参阅"prompt caching"（提示缓存）。

迁移检查清单

  • 如果您的组织有零数据保留（ZDR）安排，请在迁移前确认资格。claude-fable-5 和 claude-mythos-5 要求 30 天数据保留，除非获得 Anthropic 明确授权，否则不适用于 ZDR。在 Claude API 上，不满足此要求的 claude-fable-5 请求会返回 400 invalid_request_error。Claude Opus 4.8 在 ZDR 下可用。请参阅特定模型的数据保留要求。
  • 将模型名称从 claude-opus-4-8 更新为 claude-fable-5（或 claude-mythos-5）。
  • 移除任何 thinking: {type: "disabled"} 配置。在 claude-fable-5 和 claude-mythos-5 上禁用思考会返回错误，并且没有 thinking 字段的请求会以自适应思考运行。
  • 更新按位置读取内容的响应解析代码（例如 content[0].text）：由于自适应思考始终开启，thinking 块会在 text 块之前到达。请改为按 type 选择内容块，并在工具使用循环中完整且未经修改地传回 thinking 块；修改过的块会返回 400 错误。请参阅保留思考块。
  • 如果您在之前的迁移中已移除手动扩展思考和助手预填充，则无需采取任何操作：两者在 claude-fable-5 和 claude-mythos-5 上仍然不受支持。
  • 确认任何解析 thinking 字段的代码仅将其视为显示文本，并在同一模型上继续对话时原样传回思考块。thinking.display 在 claude-fable-5 和 claude-mythos-5 上默认为 "omitted"，与 Claude Opus 4.8 相同。设置 display: "summarized" 以接收可读摘要。请参阅 Claude Fable 和 Claude Mythos 模型上的思考输出。
  • 如果您在较早的模型上重放对话历史，请先从之前的助手轮次中剥离 thinking 和 redacted_thinking 块。来自 claude-fable-5 和 claude-mythos-5 的思考块只能由生成它们的模型或更新的模型读取：较早的模型会静默忽略它们，而 Claude Fable 5.1 和 Claude Mythos 5.1 可以读取它们，因此当您将对话升级到这些模型时请保留它们（请参阅保留的思考）。剥离可使发往较早模型的请求保持最小化和统一。例外情况是兑换回退额度，这要求按照该功能的确切规则回传请求正文。
  • 如果您迁移到 Claude Fable 5，请处理 stop_reason: "refusal" 并读取 stop_details.category 字段。要在另一个模型上自动重新运行被拒绝的请求，请考虑可选启用的 fallbacks 参数（beta）。请参阅拒绝与回退。
  • 重新评估您的 effort 设置。对于大多数任务，请从 high 开始，包括在 Claude Opus 4.8 上以 xhigh 运行的工作负载。
  • 在您自己的工作负载上重新建立成本和延迟基线。从 claude-opus-4-8 迁移时，令牌计数大致不变；每令牌定价不同，并且思考令牌按输出令牌计费，因此之前不思考运行的工作负载每个请求会产生更多输出令牌。

Was this page helpful?