简体中文

English

简体中文

English

主题

Claude 对话接口 ​

使用 Anthropic Messages 原生格式调用 Claude 模型。

http
POST /v1/messages

Claude Messages 接口保留 Anthropic 原生请求结构，适合已有 Claude SDK 或原生提示词结构的业务迁移。路由会进入 Claude relay 格式，并根据渠道分发到对应上游。

默认示例模型为 。

当前可用模型 ​

模型说明
Claude Opus 5 系列最新
Claude Sonnet 5 系列
Claude Opus 4.7
Claude Opus 4.6 思考模式
Claude Opus 4.5
Claude Sonnet 4.6
Claude Haiku 4.5 轻量模型
Claude 5 系列

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例：
string否Claude 原生认证请求头，可替代 ，示例：
string否Claude 原生版本请求头，与 搭配使用，示例：
string是请求内容类型，必须设置为

请求体 ​

名称类型必填说明
string是Claude 模型名称，默认示例 ；可选值见上方「当前可用模型」
integer是最大输出 token 数。官方必填；生成达到该数量后停止（ 为 ）
array是对话消息数组，角色需为 与 交替
string | array否系统提示词。Claude 不使用 角色消息，而是通过该字段传递；传数组时元素为 内容块，可配合
boolean否是否启用 SSE 流式输出，默认
number否采样温度，范围 –，默认 ；建议与 只调其一
number否核采样参数；建议不要与 同时调整
integer否Top-K 采样，仅从概率最高的 K 个 token 中采样
array否自定义停止序列；模型生成任一序列后即停止，返回内容不包含该序列
array否工具定义列表
object否控制工具选择策略
object否扩展思考配置，仅具备思考能力的模型可用
object否请求元数据
string否服务容量层级：（默认）/
object否结构化输出配置； 可传 JSON Schema
object否上下文管理配置； 数组定义编辑策略
array否MCP 连接器服务器列表
string否容器 ID；可复用之前响应返回的代码执行容器
string否推理地域限制，例如 表示仅在美国执行推理

messages 消息项 ​

名称类型必填说明
string是消息角色： 或
string | array是纯字符串，或内容块数组。常见类型：、（ 支持 / ）、、、、

tools 工具项 ​

名称类型必填说明
string是工具名称
string否工具功能描述，帮助模型判断何时调用
object是工具参数的 JSON Schema，通常为

tool_choice ​

名称类型必填说明
string是（默认，模型自行决定）/ （必须调用某个工具）/ （强制指定工具）/ （禁止调用）
string条件 为 时，指定要强制的工具名称
boolean否设为 时禁止一次回复中并行调用多个工具

thinking ​

名称类型必填说明
string是 开启思考， 关闭
integer否思考 token 预算上限，必须小于

metadata ​

名称类型必填说明
string否终端用户的稳定标识（建议不可逆 ID 或哈希），用于滥用检测

请求示例 ​

基础请求 ​

bash
curl -X POST https://octopusx.ai/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "你是一个严谨的技术顾问。",
    "messages": [
      {
        "role": "user",
        "content": "解释一下 API 网关为什么需要限流。"
      }
    ]
  }'

多模态输入 ​

bash
curl -X POST https://octopusx.ai/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "url",
              "url": "https://example.com/diagram.png"
            }
          },
          {
            "type": "text",
            "text": "请根据这张架构图说明限流应加在哪一层。"
          }
        ]
      }
    ]
  }'

工具调用 ​

bash
curl -X POST https://octopusx.ai/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "获取指定城市的天气",
        "input_schema": {
          "type": "object",
          "properties": {
            "city": { "type": "string" }
          },
          "required": ["city"]
        }
      }
    ],
    "tool_choice": { "type": "auto" },
    "messages": [
      {
        "role": "user",
        "content": "查一下上海今天天气。"
      }
    ]
  }'

响应示例 ​

200 - 非流式 ​

json
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    {
      "type": "text",
      "text": "API 网关限流可以保护上游服务，避免突发流量耗尽资源，并为不同用户提供稳定的服务质量。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 32,
    "output_tokens": 45
  }
}

200 - 流式 ​

流式响应为 text/event-stream。常见事件类型包括 、、、、、。

text
event: message_start
data: {"type":"message_start","message":{"id":"msg_abc123","type":"message","role":"assistant","model":"claude-sonnet-4-6","content":[],"stop_reason":null,"usage":{"input_tokens":32,"output_tokens":0}}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"API 网关限流"}}

event: message_stop
data: {"type":"message_stop"}

响应字段 ​

名称类型说明
string消息 ID
string对象类型，固定为
string消息角色，固定为
string生成响应的模型
array内容块数组；常见块含 （如 ）与
string停止原因，例如 、、、
objectToken 用量；含 、

相关接口 ​