建立 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 訊息

#參數

#請求主體

#請求欄位

#請求範例

#回應

#成功回應欄位

#回應範例

#相關指南