跳到主要内容

聊天补全

API 参考/Chat Completions/Claude 兼容聊天补全

创建 Claude 聊天补全

POST/v1/chat/completions

通过 OpenAI 兼容接口调用 Claude 系列模型。适合已使用 OpenAI SDK 或统一聊天补全格式的项目。

认证​

OpenAI 兼容协议使用 Bearer Token。

Authorizationstring必填

API Key，格式为 Bearer YOUR_API_KEY。

默认值：-
Content-Typestring必填

请求体格式。

默认值：application/json
Request-Idstring可选

客户侧生成的唯一请求标识，用于追踪和排查。

默认值：-

请求​

请求结构与 OpenAI Chat Completions 一致，只需将 model 换成 Claude 模型 ID。

modelstring必填

Claude 模型 ID，例如 claude-sonnet-4-6。

默认值：-
messagesarray必填

OpenAI 兼容格式的对话消息列表。

默认值：-
messages[].contentstring | array必填

字符串内容或多模态内容块。

默认值：-
streamboolean可选

是否启用 SSE 流式输出。

默认值：false
temperaturenumber可选

采样温度。

默认值：1
top_pnumber可选

核采样参数。

默认值：1
max_tokensinteger可选

限制本次响应最多生成的 Token 数。

默认值：4096
stopstring | array可选

停止序列。

默认值：-
toolsarray可选

工具定义列表。

默认值：-
tool_choicestring | object可选

工具调用策略。

默认值：-
response_formatobject可选

输出格式控制。

默认值：-

响应​

响应保持 OpenAI 兼容结构；usage 中可能包含 Anthropic 缓存相关统计。

idstring必填

本次补全唯一标识。

默认值：-
objectstring必填

对象类型。

默认值：chat.completion
createdinteger必填

创建时间，Unix 时间戳。

默认值：-
modelstring必填

实际执行请求的 Claude 模型。

默认值：-
choicesarray必填

补全结果列表。

默认值：-
choices[].messageobject可选

非流式响应中的模型消息。

默认值：-
choices[].finish_reasonstring可选

停止原因，例如 stop、length 或 tool_calls。

默认值：-
usageobject可选

Token 用量统计，Anthropic 模型会额外返回缓存相关字段。

默认值：-

多模态输入​

Claude 模型支持数组形式的 messages[].content，可传入文本和图片内容块。

{
  "role": "user",
  "content": [
    {"type": "text", "text": "描述这张图片"},
    {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}}
  ]
}

错误​

状态码说明
400请求体字段错误、消息格式错误或模型不支持指定参数
401API Key 缺失或无效
403当前账户无权调用该模型
429请求超过速率限制
500 / 503平台或上游模型服务异常

相关指南​