Claude Opus 4.7 API

Anthropic 旗舰, 复杂推理/代码/分析

POST /v1/messages

claude-opus-4-7:Messages 消息,含必填项、嵌套响应和虚构示例。

基础调用

必填参数: model, max_tokens, messages

可用参数: model, max_tokens, messages, system, stream

请求参数

参数类型必填说明
modelstring是精确型号;仅使用本页名称,不用显示别名替代。 可选: claude-opus-4-7
max_tokensinteger是输出预算,必填;示例值只为演示,不表示型号上限。
messagesarray是对话消息;系统说明单独放在 system。
systemstring否可选系统说明。
streamboolean否使用 SSE 增量事件。
## 使用与响应约定 - 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。 - 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。 - 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。 - 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。 - 生成文件请及时保存;不要假设结果链接永久有效。 ### 多轮与流式 基础示例是单次非流式调用。多轮调用需要保留本协议要求的历史消息;工具调用时应把调用标识与工具结果配对后再发下一轮。流式调用应按协议解析完整SSE事件,不能把任意一个网络分块当成完整JSON;检查最终事件或结束原因。可将已支持的stream选项设为true读取流式结果。 ## 参考 参数术语参考[Anthropic Messages官方说明](https://platform.claude.com/docs/en/api/messages);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 请求头 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `Content-Type` | string | 是 | 请求体格式为application/json。 | | `anthropic-version` | string | 是 | Messages协议版本为2023-06-01。 | ### 请求体 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:claude-opus-4-7 | | `max_tokens` | integer | 是 | 输出预算,必填;示例值只为演示,不表示型号上限。 最小值:1 | | `messages` | array[object] | 是 | 对话消息;系统说明单独放在 system。 | | `messages[].role` | string | 是 | 消息角色。 可选值:user, assistant | | `messages[].content` | string | 是 | 基础文本;图片、工具结果等使用对应内容块。 | | `system` | string | 否 | 可选系统说明。 | | `stream` | boolean | 否 | 使用 SSE 增量事件。 默认:false | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 否 | 消息标识。 | | `type` | string | 否 | 对象类型 message。 | | `role` | string | 否 | 响应角色 assistant。 | | `model` | string | 否 | 响应型号。 | | `content` | array[object] | 否 | 响应内容块,可能包含文本、思考或工具调用。 | | `content[].type` | string | 否 | 内容块类型。 | | `content[].text` | string | 否 | 文本内容。 | | `content[].thinking` | string | 否 | 模型返回时的思考内容。 | | `content[].id` | string | 否 | 工具调用标识。 | | `content[].name` | string | 否 | 工具名称。 | | `content[].input` | object | 否 | 工具参数对象。 | | `stop_reason` | string | 否 | 如 end_turn、max_tokens、tool_use;以返回值为准。 | | `stop_sequence` | string | 否 | 命中的停止序列,可能为 null。 | | `usage` | object | 否 | 本次消息用量,字段缺失时保持未知。 | | `usage.input_tokens` | integer | 否 | 输入 Token。 | | `usage.output_tokens` | integer | 否 | 输出 Token。 | | `usage.cache_read_input_tokens` | integer | 否 | 缓存读取分项。 | | `usage.cache_creation_input_tokens` | integer | 否 | 缓存创建分项。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 错误详情;以本次返回为准。 | | `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 | | `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 | | `error.code` | string | 否 | 错误码,可能为空。 |

请求示例

curl --request POST https://api.router.ai/v1/messages \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --header "anthropic-version: 2023-06-01" \
  --data-raw '{
  "model": "claude-opus-4-7",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Describe a fictional blue paper boat in one sentence."
    }
  ],
  "stream": false
}'

接口通用说明: 创建消息请求 (Claude 原生)