返回指南
故障排查·2026年8月30日·更新于 2026年10月22日·阅读约 6 分钟

Anthropic API 404 not_found_error:“model: …”——为什么存在的模型名称仍然会返回 404

这个 404 令人困惑之处在于,模型通常确实存在——存在于 Anthropic 的文档、博客文章或上一季度的代码中。但它不在你的 API 密钥今天获准调用的模型列表中。

最后审核于 。

这个 404 令人困惑之处在于,模型通常确实存在——存在于 Anthropic 的文档、博客文章或上一季度的代码中。但它不在你的 API 密钥今天获准调用的模型列表中。

错误

响应(HTTP 404)
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "model: claude-3-5-sonnet"
  }
}

原因和解决方法一览

原因解决方法
已退役的日期快照快照会按照已公布的时间表弃用,随后停止解析。请迁移到当前快照。
从未存在过的别名`claude-3-5-sonnet` 是一个系列,而不是可调用的 ID。Anthropic 的 ID 带有版本或日期后缀。
模型真实存在,但未对你的账户启用最新模型可能受到层级限制。404 与拼写错误无法区分——请检查 models 端点,而不是文档。
Anthropic 端点上的 OpenAI 模型名称api.anthropic.com 上的 `gpt-4o` 表示模型缺失,而不是路由错误。如果你希望使用一个端点同时调用两者,请使用网关。

询问 API,而不是文档

文档描述的是模型目录;models 端点描述的是你的目录。当两者不一致时,以端点为准。任何不在此列表中的模型,无论在其他地方看起来多么新,都会返回 404。

list-models.sh
curl -s https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  | grep '"id"'

有意识地固定版本,有意识地升级

硬编码日期快照可以保证可复现性,也会带来一个由你无法选择日期的未来 404。从配置中读取模型 ID,意味着修复只需在部署时修改值,而不是修改代码——当模型繁忙而不是缺失时,同一个开关也能让你进行故障转移。

model_config.py
import os

# One place to change when a snapshot retires.
MODEL = os.environ.get("LLM_MODEL", "claude-sonnet-5")

resp = client.chat.completions.create(
    model=MODEL,
    messages=[{"role": "user", "content": "ping"}],
)

区分 404、400 和 403

404 表示该名称解析不到任何内容。400 表示名称正确但请求有误(参数错误、内容格式错误)。403 表示模型存在,但你无权使用。只有 404 可以通过更改模型字符串修复。

claude-sonnet-4-5-20250929 将于 2026 年 11 月 30 日退役

Anthropic 的模型弃用页面将 claude-sonnet-4-5-20250929 列为 2026 年 9 月 30 日弃用,在 Claude API 上的暂定退役日期为 2026 年 11 月 30 日;超过退役日期后,对该模型的请求会失败(https://platform.claude.com/docs/en/about-claude/model-deprecations, 2026 年 10 月 22 日读取)。Anthropic 推荐的替代模型是 Claude Sonnet 5.5,截至 2026 年 10 月 22 日 Kunavo 没有提供它,所以在 Kunavo 上请求它同样会返回 404。在 Kunavo 上,这个带日期的 Sonnet 4.5 ID 一直返回 404。你能调用的 Sonnet 和 Opus ID 是 GET /v1/models 返回的那些,2026 年 10 月 22 日为 claude-sonnet-5 和 claude-opus-5-5;以目录为准。在 Claude Code 中,sonnet 别名指向 Anthropic 最新的 Sonnet,所以要把它和另外三个模型变量固定到 Kunavo 提供的 ID:

claude-code-models.sh
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

如果你通过 Kunavo 调用

Kunavo 的目录就是其 /v1/models 端点返回的列表,其中每个 ID 都可以由任何已充值的密钥调用——不存在按账户限制模型的机制,因此上面“模型真实存在但未对你启用”的情况不会发生。由于同一端点同时提供 Claude 和 GPT 系列名称,OpenAI ID 也不是端点错误;它会直接路由。上游仍会退役模型,而模型撤下时,其 ID 会被重定向或记录说明,不会无声地任其返回 404。当前 ID 及其每 token 费率见 Claude API 价格表。

常见问题

404 是否可能是临时错误?

不会。与 429、500 和 529 不同,使用相同模型字符串重试 404 只会再次失败。请更改字符串或停止重试。

我如何知道快照何时退役?

Anthropic 会公布日期快照的弃用日期。如果你固定使用快照,该时间表就是日历事项;如果你从配置中读取 ID,则只需修改一行。

为什么同事的密钥使用相同名称却可以工作?

模型可用性可能因账户层级而异。比较两个 /v1/models 响应——差异本身就是答案。

claude-sonnet-4-5-20250929 会在 2026 年 11 月 30 日停止工作吗?

在 Claude API 上,这是它的暂定退役日期,退役后对它的请求会失败。在 Kunavo 上,这个带日期的 ID 已经返回 404:请使用 GET /v1/models 中的 Sonnet 或 Opus ID,例如 claude-sonnet-5 或 claude-opus-5-5,并从配置中读取模型 ID,这样下一次退役时只需修改一行。

相关指南

更多错误语义请参阅 错误参考;通过 注册 和 身份验证指南 获取密钥只需一分钟。