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 的约定。