Skip to main content
POST
Anthropic 原生 Messages 接口,为已有 Anthropic SDK 的应用保留,GPT-5.6、GPT-6、GPT-6.1 系列与 Responses 专用模型之外的全部文本模型都可调用。除联网搜索(见文本模型总览 · 计费口径)外,本接口不提供 Chat 之外的额外能力,新接入建议直接用通用对话接口。

鉴权

string
API 密钥用于身份验证,与 Authorization 二选一访问 API Key 管理页面 获取您的 API Key在请求头中添加:
string
API 密钥用于身份验证,与 x-api-key 二选一
string
必填
API 版本号指定要使用的 Claude API 版本示例:2023-06-01
Anthropic SDK 的 base URL 设为 https://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):更随机、更有创意
默认值:1.0
number
核采样参数,范围 0-1使用 nucleus sampling。建议使用 temperature 或 top_p 其中之一,不要同时使用。默认值:1.0
integer
Top-K 采样只从概率最高的 K 个选项中采样,用于移除”长尾”低概率响应。建议仅在高级用例中使用。
boolean
是否启用流式输出
  • true: 通过服务器发送事件 (SSE) 逐步返回响应
  • false: 一次性返回完整响应
默认值:false
array
停止序列自定义文本序列,遇到时停止生成。最多 4 个序列,每个最长 32 个 token。
object
元数据用于追踪或标识请求的对象。

响应

string
消息的唯一标识符
string
对象类型,固定为 message
string
角色类型,固定为 assistant
array
消息内容数组
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 数组,写法与命中条件见文本模型总览 · 缓存。

相关文档