anthropic/claude-sonnet-5-5 的 API 参考,由 Comfy Router 从 Anthropic 提供。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk 和 npm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发起的同一调用。
模型 ID: anthropic/claude-sonnet-5-5
端点: POST https://api.comfy.org/v2/models/anthropic/claude-sonnet-5-5
- 等待结果
- 提交并稍后收取
相同的请求体,发送到
POST https://api.comfy.org/v2/models/anthropic/claude-sonnet-5-5/requests。只要运行被接纳,Router 就会返回 201 和 request_id,结果准备就绪后即可收取,可由当前进程或另一个进程完成。队列投递介绍了状态查询、取消和收取的完整流程。Schema
输入
integer
必填
停止之前可生成的最大 token 数量。
object[]
必填
对话轮次。完整的内容块分类参见 Anthropic Messages API 文档。
object
必填
可以是字符串简写,也可以是内容块数组(text、image、document、tool_use、tool_result 等)。
string
必填
可选值:
user、assistantstring
Anthropic 模型标识符(例如
claude-sonnet-4-5、claude-opus-4-7)。boolean
当该值为 true 时,响应是 Anthropic 消息事件的
text/event-stream,而不是单个 JSON 正文。object
顶层 system 提示词。可以是字符串,也可以是内容块数组;两者都会原样传递给 Anthropic。
GET /v2/models/anthropic/claude-sonnet-5-5/openapi.json 提供的 schema 生成,也就是请求到达提供商之前用于校验调用的同一份文档。
输出
string
string
string
string
string
string
object
一次 Anthropic Messages API 调用的 token 用量。
object
一次 Anthropic Messages API 调用中按 TTL 细分的缓存写入输入 token。
integer
integer
integer
integer
integer
integer
object[]
必填
回复的内容块,按顺序排列。每条已完成的消息中都会出现;该轮次没有产生任何内容时为空。
string
该块的文本。仅在
text 块中出现,其他类型均不包含。string
块的类型。
text 是携带 text 的那一种;thinking、redacted_thinking、tool_use、server_tool_use 以及工具结果块是 Anthropic 目前发送的其他类型,且该列表是开放的。示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入,413 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载,因为结果 URL 会过期。
上文任何字段描述中提到的尺寸限制,都是提供商对该字段自身的限定,引自提供商的规范。Router 会对整个请求体另行设置上限,base64 编码的媒体内容也计入其中:参见请求体大小。
本页记录的是通过 Comfy Router 调用的某一个合作伙伴模型。同一个 comfy-sdk / @comfyorg/sdk 包还提供第二个客户端,用于在 Comfy Cloud 上运行完整的 ComfyUI 工作流图:Comfy(api_key=...) / new Comfy({ apiKey }),并带有 client.workflows、client.assets 和 client.jobs。请参阅 Comfy SDKs。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、验证错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。