创建消息请求 (Claude 原生)

Anthropic Claude 原生消息格式, 兼容官方 SDK 与工具链

POST /v1/messages

鉴权: {'type': 'bearer', 'prefix': 'sk-', 'description': 'API Key, 使用 `Authorization: Bearer sk-xxx` 鉴权'}

原生 Claude Messages API。如果你的代码已经在用 Anthropic 官方 SDK, 只需把 `base_url` 指向本平台, 其余代码不改即可运行。 - 支持 `stream: true` SSE 流式 - 支持工具调用 / 图片输入 - 与 OpenAI 端点的区别: `system` 是顶层字段而非 messages 元素

请求体

`model`	string	required	要调用的模型名, 填模型广场里的名称。
`messages`	array	required	对话消息数组, 每项含 role 与 content。role 只能是 user / assistant, 系统提示词走独立的 system 字段而不是放进这里。
`role`	string	required
`content`	string	required	字符串, 或多模态数组
`max_tokens`	integer	required	本次回复最多生成多少 token。这个协议下是必填项。
`system`	string		系统提示词。可传字符串, 也可传数组以便对不同片段单独设置。
`stream`	boolean		是否流式返回。true 时以 SSE 逐块推送。
`temperature`	number		采样温度, 越大输出越发散、越小越稳定。
`tools`	array		可供模型调用的工具列表。模型需要时会返回 tool_use 内容块, 由你执行后以 tool_result 回填。
`tool_choice`	object		控制是否/如何选用工具: 由模型决定、强制使用、或指定某个具体工具。需与 tools 一起使用。
`stop_sequences`	array		遇到其中任一字符串就停止生成。
`top_p`	number		核采样, 只在累计概率前 top_p 的候选里挑。与 temperature 选一个调即可。
`top_k`	integer		只在概率最高的 k 个候选里挑。
`thinking`	object		扩展思考设置, 让模型在回答前先推理。开启后思考过程会作为独立内容块返回, 并计入输出用量。仅支持该能力的模型有效。
`metadata`	object		自定义元信息, 便于你自己归类检索。

响应

200 — 返回 Claude Messages 原生结构

调用示例

curl https://api.router.ai/v1/messages \
  -H "Authorization: Bearer sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "system": "用简洁中文回答",
    "messages": [{"role": "user", "content": "你好"}]
  }'

## 其他字段本端点采用 Anthropic 原生请求格式。上表之外的字段按 Anthropic 官方规范原样传入即可, 不需要额外适配。

API 文档