Documentation

原生Claude格式

Last updated: Nov 4, 2026

POST
/v1/messages

Anthropic Claude Messages API 格式的请求。

Authorization

BearerAuth
headerAuthorizationBearer <token>

使用 API Key 认证,格式:Authorization: Bearer <token>。

Header Parameters

anthropic-version?string

Anthropic API 版本号,Anthropic 官方 SDK 会自动携带。

Request Body

application/json
  1. body
model*string

模型 ID,如 kimi-k3。

messages*array<>

对话消息列表,每项含 role、content。

max_tokens*integer

最大生成 Token 数。

Range1 <= value
system?|array<>

系统提示,独立于 messages 传入。

temperature?number

采样温度。

Range0 <= value <= 1
top_p?number

核采样参数。

top_k?integer

Top-K 采样参数。

stream?boolean

是否流式响应。

stop_sequences?array<string>

停止序列。

tools?array<>

工具定义。

tool_choice?

工具选择策略。

thinking?

思考 / 推理配置。

metadata?

元数据。

Response Body

成功创建响应

application/json
  1. response
id?string

消息 ID。

type?string

对象类型。

role?string

消息角色。

content?array<>

内容块列表。

model?string

实际使用的模型 ID。

stop_reason?string

停止原因。

usage?

Token 用量统计。

Example Request
curl -X POST 'https://vod.gz.baidubce.com/v1/messages' \  -H 'Content-Type: application/json' \  -d '{  "model": "kimi-k3",  "messages": [    {      "role": "user",      "content": "string"    }  ],  "max_tokens": 1}'
Example Response200
{  "id": "string",  "type": "string",  "role": "string",  "content": [    {      "type": "string",      "text": "string"    }  ],  "model": "string",  "stop_reason": "string",  "usage": {    "input_tokens": 0,    "output_tokens": 0,    "cache_creation_input_tokens": 0,    "cache_read_input_tokens": 0  }}