Messages API

POST /v1/messages

相容 Anthropic Messages API。閘道透過設定的 Anthropic 或 Bedrock 通道透明地代理到 Claude 模型。

請求主體

參數	類型	說明
`model`*	`string`	要使用的模型 ID（例如 claude-sonnet-4-6）。
`messages`*	`array`	message 物件陣列，包含 role（user/assistant）和 content。
`max_tokens`*	`integer`	要產生的最大 token 數量。
`system`	`string`	用於為對話設定情境的系統提示詞（system prompt）。
`stream`	`boolean`	若為 true，回傳 SSE 事件串流。預設值：false。
`temperature`	`number`	取樣溫度，範圍 0–1。預設值：1。
`tools`	`array`	用於工具呼叫的工具定義清單。

範例請求

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 256,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

範例回應

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "The capital of France is Paris." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 9
  }
}

ℹ

Messages API 同時接受兩種 Authorization: Bearer 和 x-api-key header 進行認證，符合 Anthropic SDK 的慣例。