文本生成
Claude 消息接口
为已有 Anthropic SDK 的应用保留的原生 Messages 接口
POST
Anthropic 原生 Messages 接口,为已有 Anthropic SDK 的应用保留,GPT-5.6、GPT-6、GPT-6.1 系列与 Responses 专用模型之外的全部文本模型都可调用。除联网搜索(见文本模型总览 · 计费口径)外,本接口不提供 Chat 之外的额外能力,新接入建议直接用通用对话接口。
Anthropic SDK 的 base URL 设为
鉴权
string
string
API 密钥用于身份验证,与
x-api-key 二选一string
必填
API 版本号指定要使用的 Claude API 版本示例:
2023-06-01https://api.qingbo.ai,SDK 会自行追加 /v1/messages,不需要再补 /v1。
请求参数
string
必填
模型 ID除以下模型外,全部文本模型都可调用本接口:GPT-5.6、GPT-6 与 GPT-6.1 系列(
gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra、gpt-6-astra、gpt-6-luna、gpt-6-sol、gpt-6.1-sol),以及只接受 Responses 接口的 gpt-5-pro、gpt-5.2-pro、gpt-5.4-pro、gpt-5.3-codex、o3-pro。这些模型发到本接口返回 400。各模型的缓存档位与支持的能力见文本模型总览。本接口不支持图像输入。array
必填
消息列表,支持交替的
user 和 assistant 角色integer
必填
最大生成 token 数生成停止前的最大 token 数量。模型可能会在达到此限制前停止。不同模型有不同的最大值,请参考模型文档。最小值:1
string | array
系统提示词系统提示词用于设置 Claude 的角色、个性、目标和指令。字符串格式:结构化格式:
number
温度参数,范围 0-1控制输出的随机性:
- 低值(如 0.2):更确定、更保守
- 高值(如 0.8):更随机、更有创意
number
核采样参数,范围 0-1使用 nucleus sampling。建议使用
temperature 或 top_p 其中之一,不要同时使用。默认值:1.0integer
Top-K 采样只从概率最高的 K 个选项中采样,用于移除”长尾”低概率响应。建议仅在高级用例中使用。
boolean
是否启用流式输出
true: 通过服务器发送事件 (SSE) 逐步返回响应false: 一次性返回完整响应
array
停止序列自定义文本序列,遇到时停止生成。最多 4 个序列,每个最长 32 个 token。
object
元数据用于追踪或标识请求的对象。
响应
string
消息的唯一标识符
string
对象类型,固定为
messagestring
角色类型,固定为
assistantarray
消息内容数组
string
实际使用的模型名称
string
停止原因可能的值:
end_turn- 自然结束max_tokens- 达到最大 token 限制stop_sequence- 遇到停止序列tool_use- 工具使用
string
触发停止的序列(如果有)
object
token 使用统计
使用示例
单次对话
多轮对话
使用系统提示词
预填充响应
流式
在同一个 URL 上设置stream: true。依次读取 message_start、内容块事件、message_delta(携带实际 usage 与 stop_reason),最后是 message_stop。message_start 里的初始用量不是最终账单,不能据此计费。
用量与计费
原生input_tokens 与 Chat 的 prompt_tokens 语义不同:原生的 input_tokens 不包含缓存命中和缓存写入,总输入等于三者相加;output_tokens 已包含思考 token。原生响应不带 usage.cost 字段,实际扣费到控制台用量记录查询。计费口径见文本模型总览 · 计费口径。
当前不支持
- 结构化输出——Claude 模型不接受
response_format的json_schema与json_object。 - 工具调用限制——不支持工具调用的模型(见文本模型总览「JSON / 工具」列)传
tools/tool_choice;Fable 系列、claude-opus-5-5与claude-sonnet-5-5的tool_choice取any或tool(只接受auto)。 - 图像输入。
400,不计费。显式缓存在本接口可用:把要复用的长前缀放进 system 数组,写法与命中条件见文本模型总览 · 缓存。