POST /v1/messages

Anthropic 协议的对话端点,字段命名与响应结构与 Anthropic 官方一致。

本页目录
text
POST https://api.apione.ai/v1/messages

SDK 里把 base_url 设为 https://api.apione.ai(不带 /v1)。

请求参数

modelstring必填

模型 ID;非 Anthropic 模型也可用,网关做协议转换。

max_tokensinteger必填

Anthropic 协议下此字段必填,缺失返回 400。

messagesobject[]必填

只含 user 与 assistant 两种角色,须交替出现。

systemstring | object[]

系统提示,是顶层字段而不是 messages 里的一项。

streamboolean

启用具名事件的 SSE 流。

temperaturenumber

0–1(注意上限与 OpenAI 协议不同)。

stop_sequencesstring[]

停止序列,字段名与 OpenAI 协议的 stop 不同。

toolsobject[]

Anthropic 风格的工具定义(input_schema)。

请求示例

json
{
  "model": "claude-opus-4-7",
  "max_tokens": 1024,
  "system": "你是一个严谨的代码审查者。",
  "messages": [
    { "role": "user", "content": "这个函数在空数组时会怎样?" }
  ]
}

响应

json
{
  "id": "msg_01J8ZQ7K3M",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-4-7",
  "content": [
    { "type": "text", "text": "空数组会走到 reduce 的初始值分支……" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 64, "output_tokens": 188 }
}

注意正文在 content[] 数组里,用量字段名是 input_tokens / output_tokens。

流式事件

text
event: message_start
event: content_block_start
event: content_block_delta      ← 正文增量在这里
event: content_block_stop
event: message_delta            ← 携带 stop_reason 与 usage
event: message_stop

联系我们

文档没写清楚,或者需要人工协助?按问题类型选一个渠道即可。

邮箱

技术支持support@apione.ai

WhatsApp

Telegram

工单

计费与账户控制台 › 反馈