---
title: Claude Sonnet 5.5 API：模型 ID、定价与迁移 | RunAPI
description: 通过 Anthropic Messages API 调用 claude-sonnet-5-5。按 token 计费、100 万上下文、effort 默认值及 Sonnet 5 迁移变化。
url: https://runapi.ai/zh-CN/models/claude/sonnet-5-5.md
canonical: https://runapi.ai/zh-CN/models/claude/sonnet-5-5
locale: zh-CN
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
en: https://runapi.ai/models/claude/sonnet-5-5
zh-CN: https://runapi.ai/zh-CN/models/claude/sonnet-5-5
es: https://runapi.ai/es/models/claude/sonnet-5-5
ja: https://runapi.ai/ja/models/claude/sonnet-5-5
de: https://runapi.ai/de/models/claude/sonnet-5-5
fr: https://runapi.ai/fr/models/claude/sonnet-5-5
pt-BR: https://runapi.ai/pt-BR/models/claude/sonnet-5-5
ko: https://runapi.ai/ko/models/claude/sonnet-5-5
it: https://runapi.ai/it/models/claude/sonnet-5-5
nl: https://runapi.ai/nl/models/claude/sonnet-5-5
pl: https://runapi.ai/pl/models/claude/sonnet-5-5
tr: https://runapi.ai/tr/models/claude/sonnet-5-5
zh-TW: https://runapi.ai/zh-TW/models/claude/sonnet-5-5
zh-HK: https://runapi.ai/zh-HK/models/claude/sonnet-5-5
ar: https://runapi.ai/ar/models/claude/sonnet-5-5
x-default: https://runapi.ai/models/claude/sonnet-5-5
model: Claude
provider: Anthropic
variant_id: claude-sonnet-5-5
sdk_model_id: claude-sonnet-5-5
modality: text
billing_unit: 1K tokens
status: active
---
> HTML version: https://runapi.ai/zh-CN/models/claude/sonnet-5-5
> Site index for agents: https://runapi.ai/llms.txt
# claude-sonnet-5-5 API
通过 RunAPI 调用 Claude 系列的 claude-sonnet-5-5。按 token 计费，无需订阅，响应开始前失败的请求不计费。
**Anthropic / [Claude](https://runapi.ai/zh-CN/models/claude.md)**
**运行中 · text · 可商用**
## 迁移到 Claude Sonnet 5.5 会有哪些变化
Anthropic 于 2026 年 9 月 28 日发布了 Claude Sonnet 5.5。它的输入和输出单价与 Sonnet 5 相同，自 2026 年 10 月 7 日起，缓存读取价格为 Sonnet 5 的一半。Anthropic 将它定位为范围明确、完成标准清晰的日常任务，例如修复 bug 或生成文档，开放式问题则推荐使用 Opus 5.5。
为 Sonnet 5 编写的代码需要调整几处请求参数。用 thinking: {type: "disabled"} 关闭思考现在会返回 400，请在 effort 为 high 或更低时改传 {type: "between_tools"}。把 tool_choice 设为 any 或指定某个工具的强制工具调用同样返回 400，请改用 auto 并配合 strict 工具定义。Sonnet 5.5 还会拒绝非默认的 temperature、top_p 或 top_k。
在 RunAPI 上，claude-sonnet-5-5 只通过 Anthropic Messages 端点（/v1/messages）提供。以 OpenAI Chat Completions、Responses 或 Gemini 格式请求该模型会被 RunAPI 拒绝，请使用 Anthropic SDK 或 Claude Code 调用。
**模型 ID:** claude-sonnet-5-5
**发布日期:** 2026 年 9 月 28 日
**上下文窗口:** 100 万 token
**最大输出:** 12.8 万 token
**知识截止时间:** 2026 年 6 月
**默认 effort（API）:** high
**RunAPI 上的协议:** Anthropic Messages
## 体验 Claude Sonnet 5.5
选择任意模型，几秒内开始生成。
**模型:**
- **Message** — `message` · `claude-sonnet-5-5` · 输入 $1.60 / 百万 tokens | 输出 $8.00 / 百万 tokens
**提示词:** 描述你想创建的内容……
**预计：** 输入 $1.60 / 百万 tokens | 输出 $8.00 / 百万 tokens
- [生成](https://runapi.ai/zh-CN/login)
登录后即可使用 RunAPI 生成。
### 切换变体
- [claude-fable-5](https://runapi.ai/zh-CN/models/claude/fable-5.md)
- [claude-fable-5-1](https://runapi.ai/zh-CN/models/claude/fable-5-1.md)
- [claude-haiku-4-5-20251001](https://runapi.ai/zh-CN/models/claude/haiku-4-5-20251001.md)
- [claude-haiku-5-5](https://runapi.ai/zh-CN/models/claude/haiku-5-5.md)
- [claude-opus-4-1-20250805](https://runapi.ai/zh-CN/models/claude/opus-4-1-20250805.md)
- [claude-opus-4-5-20251101](https://runapi.ai/zh-CN/models/claude/opus-4-5-20251101.md)
- [claude-opus-4-6](https://runapi.ai/zh-CN/models/claude/opus-4-6.md)
- [claude-opus-4-7](https://runapi.ai/zh-CN/models/claude/opus-4-7.md)
- [claude-opus-4-8](https://runapi.ai/zh-CN/models/claude/opus-4-8.md)
- [claude-opus-5](https://runapi.ai/zh-CN/models/claude/opus-5.md)
- [claude-opus-5-5](https://runapi.ai/zh-CN/models/claude/opus-5-5.md)
- [claude-sonnet-4-5-20250929](https://runapi.ai/zh-CN/models/claude/sonnet-4-5-20250929.md)
- [claude-sonnet-4-6](https://runapi.ai/zh-CN/models/claude/sonnet-4-6.md)
- [claude-sonnet-5](https://runapi.ai/zh-CN/models/claude/sonnet-5.md)
- **claude-sonnet-5-5** (current)
15 个版本可用
claude-sonnet-5-5 是 RunAPI 上 Claude 系列的模型之一。它与其他所有模型使用同一个 API key，只需修改请求中的模型 ID 即可切换。每次调用为同步调用，按输入、输出和缓存 token 以 USD 计费，无订阅，无最低消费。响应开始前失败的请求不计费；响应开始流式输出后，已生成的 token 会计费，即使客户端断开连接。
- 按 token 以 USD 计费，无需订阅
- 响应开始前失败的请求不计费
- 逐 token 流式输出
- 修改一个模型 ID 即可切换模型
- 所有模型和供应商共用一个 API key、一张账单
## 使用指标
- **API 调用量 / 天:** 1
- **成功率:** 100.0%
- **平均生成时间:** 2.1s
该模型暂无已验证的用户反馈。
## 技术细节
| 字段 | 值 |
|---|---|
| 提供商 | Anthropic |
| 模型 ID | claude-sonnet-5-5 |
| 模态 | 文本 |
| 任务类型 | Synchronous |
| API 端点 | `/v1/messages` |
| 计费单位 | 1K tokens |
| 目录状态 | 运行中 |
**工作原理**
## 3 步使用此模型
1. **获取 API 密钥** - 免费注册后，在控制台创建用于 claude-sonnet-5-5 的 API 密钥。
2. **发送请求** - 向 /v1/messages 发送 POST 请求，并传入 claude-sonnet-5-5 模型 ID 和参数。
3. **获取结果** - 直接从端点读取已完成的 claude-sonnet-5-5 响应。
## 该模型的核心能力
- **Endpoint 覆盖** — 提供 1 个公开 endpoint：message。
- **按量计费** — 按 1K tokens 计量，无需订阅。
## Claude Sonnet 5.5 定价
| 端点 | 价格 |
|---|---|
| `message` | 输入: $1.60 / 百万 tokens
输出: $8.00 / 百万 tokens
缓存读取: $0.08 / 百万 tokens
缓存写入（5 分钟）: $2.00 / 百万 tokens
缓存写入（1 小时）: $3.20 / 百万 tokens |
**API 参考**
## 端点规格
| Field | Value |
|---|---|
| 端点 | `POST /v1/messages` |
| 模型 ID | `claude-sonnet-5-5` |
| 任务类型 | `message` |
## 请求参数
此端点尚未发布请求参数。
**Request example**
```json
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "审查这个 PR 的安全漏洞和性能问题，并给出具体改进建议。"
}
]
}
```
### 模型 Skill — claude-sonnet-5-5
安装一次 skill，开发时使用本页的变体 ID。
Base URL: `https://runapi.ai`
| Endpoint | Protocol |
|---|---|
| `POST /v1/messages` | Anthropic compatible |
使用 Anthropic SDK，配合您的 RunAPI API key 和 `model: "claude-sonnet-5-5"` 调用。
### 用 model skill 使用 claude-sonnet-5-5
1. **安装** — 安装 Claude 系列对应的 model skill，它会把文档、请求格式和价格说明加载到您的编码工作区。
2. **配置** — 把 SDK 指向 https://runapi.ai，并设置您的 RunAPI API key。同一个 key 适用于所有模型和供应商。
3. **调用** — 使用该模型支持的 API 格式发送请求，并把 model 字段设置为本页展示的模型 ID。RunAPI 会把请求转发给供应商。
4. **接收** — 从同一次调用中读取响应，或在生成过程中以流式方式接收。usage 字段显示您被计费的 token。
### claude-sonnet-5-5 与其它变体的差异
- **VS CLAUDE-FABLE-5: 100 万上下文；Sonnet 5 的后继版本，面向日常编码与智能体任务** — Mythos 级 100 万上下文；编码、推理和视觉全面领先
- **VS CLAUDE-FABLE-5-1: 100 万上下文；Sonnet 5 的后继版本，面向日常编码与智能体任务** — 100 万上下文；Fable 5 后继
- **VS CLAUDE-HAIKU-4-5-20251001: 100 万上下文；Sonnet 5 的后继版本，面向日常编码与智能体任务** — Haiku 4.5，用于可复现输出
## 应用场景
**客户支持**
基于私有知识库回答客户问题，减少工单量。
**文档分析**
起草合同摘要并标记关键条款供律师审阅。
**代码生成**
在 CI 中自动生成单元测试、代码审查和重构建议。
## Claude Sonnet 5.5 常见问题
### Claude Sonnet 5.5 API 的价格是多少？
Sonnet 5.5 对输入、输出、缓存写入和缓存读取分别按 token 计费，本页的价格表列出了 RunAPI 当前的各项单价。Anthropic 沿用了 Sonnet 5 的输入和输出单价，并在 2026 年 10 月 7 日把缓存读取单价降到 Sonnet 5 的一半。长上下文没有额外加价，90 万 token 的提示与短提示的每 token 单价相同。
### Claude Sonnet 5.5 比 Sonnet 5 便宜吗？
按 token 计，输入和输出价格相同，缓存读取便宜一半。Anthropic 表示，由于 Sonnet 5.5 用更少的 token 得出答案，典型任务的成本最多可降低 30%。token 用量取决于你设置的 effort 等级，迁移大批量工作负载之前，请先对比自己请求中的 usage 字段。
### 应该选 Sonnet 5.5 还是 Opus 5.5？
Anthropic 建议：任务有明确规格且能验证结果时用 Sonnet 5.5，复杂的开放式任务用 Opus 5.5。两者在 RunAPI 上共用同一个 API key，只需修改模型 ID 就能按任务分流。
### Sonnet 5.5 应该使用哪个 effort 等级？
API 默认值为 high。Anthropic 建议：规格明确的智能体编程和多步骤工具调用先用 medium，困难任务用 high，聊天场景用 medium 或 low。等级越高，消耗的思考 token 越多，思考 token 按输出价格计费。
### 为什么 Sonnet 5 的代码在 Sonnet 5.5 上返回 400 错误？
Sonnet 5.5 拒绝三种 Sonnet 5 原本接受的请求写法：thinking 设为 disabled（请在 effort 为 high 或更低时使用 between_tools）、tool_choice 设为 any 或指定某个工具（请改用 auto 配合 strict 工具）、以及非默认的 temperature、top_p 或 top_k。思考块还与产生它的对话绑定，因此回放被修改过的历史消息可能失败。
### 为什么请求返回了 stop_reason 为 refusal？
Sonnet 5.5 会运行 Anthropic 的安全分类器。请求被拒绝时，响应为 HTTP 200，stop_reason 为 refusal，并带有指明类别的 stop_details 对象。读取内容之前请先检查 stop_reason。RunAPI 会原样返回这一响应。
### 能在 RunAPI 上用 OpenAI SDK 调用 Claude Sonnet 5.5 吗？
不能。RunAPI 只通过 Anthropic Messages API 提供 claude-sonnet-5-5。请使用 Anthropic SDK，将 ANTHROPIC_BASE_URL 设为 https://runapi.ai 并填入你的 RunAPI key，或使用 Claude Code 等 Messages 客户端。
### 如何选择 claude-sonnet-5-5？
传入 quickstart 中显示的模型 ID。
### 该变体的限流？
Key 级限流随使用层级伸缩。当前限制见定价页。
### 能切到其它变体吗？
可以——变体只是参数，改 model 字段即可。
### 支持流式吗？
模型支持流式时，RunAPI 端到端流式。
### 质量问题在哪里报？
在公共 GitHub 仓库提 issue 或邮件联系 support。
### 需要单独的提供方账户吗？
不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型，无需底层提供方账户。
### 相关
- [claude-haiku-5-5](https://runapi.ai/zh-CN/models/claude/haiku-5-5.md) — 由 Anthropic 提供 · 输入 $0.08-$0.40 / 百万 tokens | 输出 $0.40-$2.00 / 百万 tokens
- [claude-haiku-4-5-20251001](https://runapi.ai/zh-CN/models/claude/haiku-4-5-20251001.md) — 由 Anthropic 提供 · 输入 $0.80 / 百万 tokens | 输出 $4.00 / 百万 tokens
- [claude-sonnet-5](https://runapi.ai/zh-CN/models/claude/sonnet-5.md) — 由 Anthropic 提供 · 输入 $1.60 / 百万 tokens | 输出 $8.00 / 百万 tokens
- [claude-sonnet-4-5-20250929](https://runapi.ai/zh-CN/models/claude/sonnet-4-5-20250929.md) — 由 Anthropic 提供 · 输入 $2.40 / 百万 tokens | 输出 $12.00 / 百万 tokens
### 立即体验 Claude。
- [免费注册](https://runapi.ai/zh-CN/login)
- [阅读快速开始 →](https://runapi.ai/zh-CN/docs/api/anthropic/messages)
## 需要团队接入支持？
我们可以协助团队接入、完成系统集成并解答技术问题。
[联系我们](https://runapi.ai/zh-CN/contact.md)
---
## More from RunAPI
- [Home](https://runapi.ai/zh-CN/.md)
### 产品
- [模型目录](https://runapi.ai/zh-CN/models.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [提供方](https://runapi.ai/zh-CN/models#all-models)
### 开发者
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [x402](https://runapi.ai/zh-CN/x402.md)
### 指南
- [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md)
- [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md)
### 公司
- [企业版](https://runapi.ai/zh-CN/contact.md)
- [联系](https://runapi.ai/zh-CN/contact.md)
### 法律
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)
Contact: contact@runapi.ai
## Structured data
```json
[
{
"@context": "https://schema.org",
"inLanguage": "zh-CN",
"@type": "WebSite",
"name": "RunAPI",
"url": "https://runapi.ai/zh-CN",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
},
{
"@context": "https://schema.org",
"inLanguage": "zh-CN",
"@type": "Organization",
"name": "RunAPI",
"url": "https://runapi.ai/zh-CN",
"logo": {
"@type": "ImageObject",
"url": "https://runapi.ai/zh-CNicon.svg"
},
"sameAs": [
"https://github.com/runapi-ai"
]
},
{
"@context": "https://schema.org",
"inLanguage": "zh-CN",
"@type": "SoftwareApplication",
"name": "Claude claude-sonnet-5-5",
"applicationCategory": "DeveloperApplication"
},
{
"@context": "https://schema.org",
"inLanguage": "zh-CN",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://runapi.ai/zh-CN"
},
{
"@type": "ListItem",
"position": 2,
"name": "Models",
"item": "https://runapi.ai/zh-CN/models"
},
{
"@type": "ListItem",
"position": 3,
"name": "Claude",
"item": "https://runapi.ai/zh-CN/models/claude"
},
{
"@type": "ListItem",
"position": 4,
"name": "claude-sonnet-5-5",
"item": "https://runapi.ai/zh-CN/models/claude/sonnet-5-5"
}
]
},
{
"@context": "https://schema.org",
"inLanguage": "zh-CN",
"@type": "HowTo",
"name": "用 model skill 使用 claude-sonnet-5-5",
"description": "通过 RunAPI 调用 Claude 系列的 claude-sonnet-5-5：按 token 计费、模型 ID、支持的 API 格式和接入指南。",
"totalTime": "PT5M",
"step": [
{
"@type": "HowToStep",
"position": 1,
"name": "安装",
"text": "安装 Claude 系列对应的 model skill，它会把文档、请求格式和价格说明加载到您的编码工作区。",
"url": "https://runapi.ai/zh-CN/models/claude/sonnet-5-5#how-step-1"
},
{
"@type": "HowToStep",
"position": 2,
"name": "配置",
"text": "把 SDK 指向 https://runapi.ai，并设置您的 RunAPI API key。同一个 key 适用于所有模型和供应商。",
"url": "https://runapi.ai/zh-CN/models/claude/sonnet-5-5#how-step-2"
},
{
"@type": "HowToStep",
"position": 3,
"name": "调用",
"text": "使用该模型支持的 API 格式发送请求，并把 model 字段设置为本页展示的模型 ID。RunAPI 会把请求转发给供应商。",
"url": "https://runapi.ai/zh-CN/models/claude/sonnet-5-5#how-step-3"
},
{
"@type": "HowToStep",
"position": 4,
"name": "接收",
"text": "从同一次调用中读取响应，或在生成过程中以流式方式接收。usage 字段显示您被计费的 token。",
"url": "https://runapi.ai/zh-CN/models/claude/sonnet-5-5#how-step-4"
}
]
},
{
"@context": "https://schema.org",
"inLanguage": "zh-CN",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Claude Sonnet 5.5 API 的价格是多少？",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sonnet 5.5 对输入、输出、缓存写入和缓存读取分别按 token 计费，本页的价格表列出了 RunAPI 当前的各项单价。Anthropic 沿用了 Sonnet 5 的输入和输出单价，并在 2026 年 10 月 7 日把缓存读取单价降到 Sonnet 5 的一半。长上下文没有额外加价，90 万 token 的提示与短提示的每 token 单价相同。"
}
},
{
"@type": "Question",
"name": "Claude Sonnet 5.5 比 Sonnet 5 便宜吗？",
"acceptedAnswer": {
"@type": "Answer",
"text": "按 token 计，输入和输出价格相同，缓存读取便宜一半。Anthropic 表示，由于 Sonnet 5.5 用更少的 token 得出答案，典型任务的成本最多可降低 30%。token 用量取决于你设置的 effort 等级，迁移大批量工作负载之前，请先对比自己请求中的 usage 字段。"
}
},
{
"@type": "Question",
"name": "应该选 Sonnet 5.5 还是 Opus 5.5？",
"acceptedAnswer": {
"@type": "Answer",
"text": "Anthropic 建议：任务有明确规格且能验证结果时用 Sonnet 5.5，复杂的开放式任务用 Opus 5.5。两者在 RunAPI 上共用同一个 API key，只需修改模型 ID 就能按任务分流。"
}
},
{
"@type": "Question",
"name": "Sonnet 5.5 应该使用哪个 effort 等级？",
"acceptedAnswer": {
"@type": "Answer",
"text": "API 默认值为 high。Anthropic 建议：规格明确的智能体编程和多步骤工具调用先用 medium，困难任务用 high，聊天场景用 medium 或 low。等级越高，消耗的思考 token 越多，思考 token 按输出价格计费。"
}
},
{
"@type": "Question",
"name": "为什么 Sonnet 5 的代码在 Sonnet 5.5 上返回 400 错误？",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sonnet 5.5 拒绝三种 Sonnet 5 原本接受的请求写法：thinking 设为 disabled（请在 effort 为 high 或更低时使用 between_tools）、tool_choice 设为 any 或指定某个工具（请改用 auto 配合 strict 工具）、以及非默认的 temperature、top_p 或 top_k。思考块还与产生它的对话绑定，因此回放被修改过的历史消息可能失败。"
}
},
{
"@type": "Question",
"name": "为什么请求返回了 stop_reason 为 refusal？",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sonnet 5.5 会运行 Anthropic 的安全分类器。请求被拒绝时，响应为 HTTP 200，stop_reason 为 refusal，并带有指明类别的 stop_details 对象。读取内容之前请先检查 stop_reason。RunAPI 会原样返回这一响应。"
}
},
{
"@type": "Question",
"name": "能在 RunAPI 上用 OpenAI SDK 调用 Claude Sonnet 5.5 吗？",
"acceptedAnswer": {
"@type": "Answer",
"text": "不能。RunAPI 只通过 Anthropic Messages API 提供 claude-sonnet-5-5。请使用 Anthropic SDK，将 ANTHROPIC_BASE_URL 设为 https://runapi.ai 并填入你的 RunAPI key，或使用 Claude Code 等 Messages 客户端。"
}
},
{
"@type": "Question",
"name": "如何选择 claude-sonnet-5-5？",
"acceptedAnswer": {
"@type": "Answer",
"text": "传入 quickstart 中显示的模型 ID。"
}
},
{
"@type": "Question",
"name": "该变体的限流？",
"acceptedAnswer": {
"@type": "Answer",
"text": "Key 级限流随使用层级伸缩。当前限制见定价页。"
}
},
{
"@type": "Question",
"name": "能切到其它变体吗？",
"acceptedAnswer": {
"@type": "Answer",
"text": "可以——变体只是参数，改 model 字段即可。"
}
},
{
"@type": "Question",
"name": "支持流式吗？",
"acceptedAnswer": {
"@type": "Answer",
"text": "模型支持流式时，RunAPI 端到端流式。"
}
},
{
"@type": "Question",
"name": "质量问题在哪里报？",
"acceptedAnswer": {
"@type": "Answer",
"text": "在公共 GitHub 仓库提 issue 或邮件联系 support。"
}
},
{
"@type": "Question",
"name": "需要单独的提供方账户吗？",
"acceptedAnswer": {
"@type": "Answer",
"text": "不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型，无需底层提供方账户。"
}
}
]
}
]
```