API 参考
Anthropic Messages
配置 Messages 请求头、输出上限和消息内容,解析文本块。
发送请求
准备支持 Messages 的模型与线路,按 API 概览设置密钥。下面使用兼容示例版本头 2023-06-01,输出上限为示例值。
curl --fail-with-body 'https://gateway.irouter.io/v1/messages' \
-H "x-api-key: $IROUTER_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","max_tokens":256,"messages":[{"role":"user","content":"Reply with a short greeting."}]}'字段与返回
model、messages 和 max_tokens 是基础请求字段。系统提示放在顶层 system,不要直接照搬 Chat Completions 的系统消息写法。
响应 content 是内容块数组;遍历其中 type: text 的 text,同时保留其他类型供相应逻辑处理。检查 stop_reason,区分正常结束、输出限制和工具调用。usage 中的输入输出计数可用于诊断,结算在控制台核对。
SDK 地址与能力边界
原始 HTTP 的完整路径包含 /v1/messages,Anthropic SDK 的 Base URL 则填写 https://gateway.irouter.io,由 SDK 添加路径。详见 Anthropic SDK。
iRouter 当前文档对应的网关版本未开放 /v1/messages/count_tokens,不要把该接口作为接入前置步骤。工具、图片、扩展思考和特定版本头需要模型与线路支持;不要只依据官方 API 新增字段推断 iRouter 已支持。
字段参考 Anthropic Messages。