创建 Claude 消息

Anthropic Claude Messages API 格式的请求。需要在请求头中包含 anthropic-version。

POST /v1/messages

服务根地址: https://getrouter.ai

协议: Anthropic Messages

认证: x-api-key: YOUR_API_KEY

请求参数

参数	位置	类型	必填	说明
`anthropic-version`	header	`string`	是	Anthropic API 版本
`x-api-key`	header	`string`	否	Anthropic API 密钥（可选，也可使用 Bearer Token）

请求体

请求体可选。媒体类型: application/json

请求字段

字段	类型	必填	说明
`model`	`string`	是	—
`messages`	`array<object>`	是	—
`system`	`string or array<object>`	否	—
`cache_control`	`object`	否	—
`inference_geo`	`string`	否	—
`max_tokens`	`integer`	是	范围: 1–∞
`temperature`	`number`	否	范围: 0–1
`top_p`	`number`	否	—
`top_k`	`integer`	否	—
`stream`	`boolean`	否	—
`stop_sequences`	`array<string>`	否	—
`tools`	`array<object>`	否	—
`tool_choice`	`object`	否	—
`thinking`	`object`	否	—
`context_management`	`object`	否	—
`output_config`	`object`	否	—
`output_format`	`object`	否	—
`container`	`string or object`	否	—
`mcp_servers`	`array<object>`	否	—
`metadata`	`object`	否	—
`speed`	`string`	否	可选值: `standard`, `fast`
`service_tier`	`string`	否	可选值: `auto`, `standard_only`

请求示例

curl --request POST \
  --url https://getrouter.ai/v1/messages \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下自己。"
    }
  ],
  "max_tokens": 1,
  "stream": false,
  "temperature": 0
}'

响应

状态码	说明
`200`	成功创建响应

成功响应字段

字段	类型	必填	说明
`id`	`string`	否	—
`type`	`string`	否	—
`role`	`string`	否	—
`content`	`array<object>`	否	—
`model`	`string`	否	—
`stop_reason`	`string`	否	可选值: `end_turn`, `max_tokens`, `stop_sequence`, `tool_use`
`usage`	`object`	否	—

响应示例

{
  "id": "string",
  "type": "string",
  "role": "user",
  "content": [
    {
      "type": "string",
      "text": "string"
    }
  ],
  "model": "MODEL_ID",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_creation_input_tokens": 1,
    "cache_read_input_tokens": 1
  }
}

#创建 Claude 消息

#请求参数

#请求体

#请求字段

#请求示例

#响应

#成功响应字段

#响应示例

#相关指南