Messages（Anthropic 格式）

POST https://api.scirouter.cn/v1/messages
POST https://api.scirouter.cn/v1/messages/count_tokens

请求与响应格式与 Anthropic Messages API 一致。Anthropic SDK、Claude Code 等按 Anthropic 格式发送请求的客户端，替换 base URL 与 Key 即可调用。平台上的所有对话模型均可通过此接口调用；模型的线路没有 Anthropic 入口时，网关转换请求并尽量保留内容，见请求的转发方式。

Anthropic SDK 与 Claude Code 会在 base URL 后拼接 /v1/messages，因此 base URL 为 https://api.scirouter.cn，不带 /v1。Key 为控制台创建的 API Key，携带方式见认证与 API Key。

Python：

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["SCIROUTER_API_KEY"],
    base_url="https://api.scirouter.cn",  # SDK 自己会拼 /v1/messages
)

msg = client.messages.create(
    model="YOUR_MODEL_ID",
    max_tokens=1024,
    messages=[{"role": "user", "content": "这段序列的二级结构倾向？"}],
)
print(msg.content)

TypeScript：

import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  apiKey: process.env.SCIROUTER_API_KEY,
  baseURL: 'https://api.scirouter.cn',
})

const msg = await client.messages.create({
  model: 'YOUR_MODEL_ID',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '这段序列的二级结构倾向？' }],
})

curl：

curl https://api.scirouter.cn/v1/messages \
  -H "x-api-key: $SCIROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "这段序列的二级结构倾向？"}]
  }'

anthropic-version 可省略，默认值见请求头。

Claude Code 的安装、settings.json 写法、环境变量与使用要点见 Claude Code。

请求体上限为 32 MB（对话补全为 4 MB），超过时返回 413 payload_too_large。

max_tokens

对话补全接口的 max_tokens 超限返回 400，与本接口不同。

模型背后的每条线路对应同一个上游账号，可接入多种协议，每种协议是线路的一个入口（见多厂商差异「字段生效规则」）。Anthropic 格式的调用在一条线路上按以下顺序处理，前一级无法处理时进入下一级：

每一级去掉或改写的内容记录在响应头 X-SciRouter-Param-Actions 与扩展块 param_actions 中（dropped / reshaped）。

线路有 Anthropic 入口时，请求原样转发，只修改以下几处：

• model 换成上游的模型名；
• 去掉 metadata；
• max_tokens 写入生效值；
• 按平台的提示词缓存策略处理 cache_control 断点；
• 去掉签名为空的思考块。这类块来自其他模型的思考过程，厂商会因签名无效拒绝整个请求。

厂商自定义参数、思考块与签名、文档块、anthropic-beta 均到达上游，响应原样返回。「原样」指请求的格式与字段：鉴权、计费、限额与线路选择仍由平台完成，发给厂商的 x-api-key 是平台在该厂商的凭据，调用方的 SciRouter Key 不会到达厂商。

线路没有 Anthropic 入口时，网关将请求转为主入口的协议后调用，再将结果转回 Anthropic 格式。只保留能对应的字段：

cache_control 断点、思考块的签名与 anthropic-beta，线路未配置的不带并留痕。字段对照见多厂商差异与参数如何被处理。

转回的响应与原生响应的差异：

多轮工具调用时，将上一轮的思考块原样带回。平台优先将请求发回签发该签名的线路；落到其他线路时签名可能无效，厂商返回 400，平台原样交回该错误。

OpenAI 格式中没有对应概念的块，改写为等价的文字或普通工具。内容完整保留，只缺少厂商对这些块的专门处理：

每条改写在 param_actions 中记为 reshaped。带这些内容的请求，模型有带 Anthropic 入口的线路时一定走该线路（优先于权重与粘性），没有时才降级。

以下内容无法用文字表达：

• Files API 来源的文件与图片（文件在厂商侧，平台无法获取）；
• 按需压缩 compaction；
• max_tokens: 0；
• 非 JSON Schema 的输出格式；
• 没有可提取文字的块与工具（代码执行结果、memory_* 等）。

模型没有带 Anthropic 入口的线路时，返回 400 unsupported_param，details.reason 为 unsupported_content，details.unsupported_content 列出相应内容（如 ["document:file", "param:compaction"]）。平台不会丢弃这些内容后作答。该错误由请求内容引起，重试无效。

非流式：

{
  "id": "msg_…",
  "type": "message",
  "role": "assistant",
  "model": "YOUR_MODEL_ID",
  "content": [{ "type": "text", "text": "…" }],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 42, "output_tokens": 318 },
  "scirouter": { "request_id": "req_…", "attempts": 1, "cost_quota": 18240, "…": "…" }
}

数值为示例。

顶层的 scirouter 是平台的扩展块，内容与对话补全相同，SDK 忽略该字段。单次调用扣除的配额见 scirouter.cost_quota。

请求带 "stream": true 时按 Anthropic 的事件格式发送：每条事件带 event: 行，事件类型与 Anthropic 相同（message_start、content_block_delta……message_stop）。与对话补全的流式响应的差异：

• 没有 data: [DONE]，流以 message_stop 结束。平台在结算后才发送 message_stop，其中多一个 scirouter 字段（含本次的 cost_quota）。
• 开始输出后出错时，发送一个 event: error 事件（内容为错误中的错误体），随后断开。未收到 message_stop 即结束的流按失败处理。
• 流中有以 : 开头的心跳注释行，SDK 自动忽略。

非流式请求最长等待约 270 秒，超时返回 504 upstream_timeout（details.timeout 为 response），不计费；回答可能很长时使用流式，见 SDK 与框架「重试与超时」。

按厂商返回的 usage 结算，口径与厂商一致：input_tokens、cache_read_input_tokens、cache_creation_input_tokens（含 5 分钟与 1 小时两档写入）分别按各自的单价计费；思考 token 包含在 output_tokens 中，按输出单价计费。

厂商将一次请求中的多次采样拆分在 usage.iterations 中时（服务端压缩 context_management 的 compact_* 编辑、按需压缩 compaction、advisor 工具、fallbacks 回退），按 iterations 逐条计费：

scirouter.cost_quota 为合计。fallbacks 写成模型列表时，每个模型都须在平台上有定价且调用方有权调用，否则返回 400 sub_model_unpriced；写 "default" 时由厂商选择模型，按其返回的模型结算。

/messages 与 /messages/count_tokens 的错误使用 Anthropic 的格式，鉴权失败与路径或方法错误（404 / 405）也是如此：

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后再试",
    "code": "rate_limited",
    "details": { "retry_after_seconds": 12 }
  },
  "request_id": "req_88a1"
}

• 状态码与对话补全逐码相同，error.code 使用同一套小写错误码，按 error.code 分支处理，对照见错误码。
• error.type 按状态码给出；配额、权限、Key 状态等策略拒绝例外，见下表。

平台拒绝请求时的标记：

部分参数会使厂商按另一档单价计费。计价参数由平台配置，当前为走 Anthropic 入口时的以下参数：

模型的线路都没有 Anthropic 入口时，这些参数无法带到线路上，不做检查。请求带有计价参数时：

也可直接将 model 设为变体的 id，或在别名后加后缀（别名:fast）。模型的变体、各变体强制的参数与自动改用的格式，见模型中心的详情页或 GET /models 扩展字段中的 variant_params 与 variant_switch_formats（见模型列表）。对话补全（OpenAI 格式）默认只记录，不改用变体。

curl https://api.scirouter.cn/v1/messages/count_tokens \
  -H "x-api-key: $SCIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "这段序列的二级结构倾向？"}]
  }'

{
  "input_tokens": 1834,
  "scirouter": { "model": "YOUR_MODEL_ID", "estimated": false, "request_id": "req_…" }
}

数值为示例。

GET /models 与 GET /models/{id} 带 anthropic-version 请求头时，按 Anthropic 的格式返回（Claude Code 与 Anthropic SDK 列出模型时会携带）：

{
  "data": [{ "type": "model", "id": "YOUR_MODEL_ID", "display_name": "…", "created_at": "2026-09-01T00:00:00Z" }],
  "has_more": false,
  "first_id": "YOUR_MODEL_ID",
  "last_id": "YOUR_MODEL_ID"
}

一次返回全部模型，has_more 恒为 false；查询单个模型时也接受别名。不带该请求头时按 OpenAI 的格式返回，见模型列表。

其余 X-SciRouter-*、x-ratelimit-* 响应头与对话补全相同，见可观测性。

Idempotency-Key 与平台响应缓存的规则与对话补全相同，见缓存与幂等。

Anthropic SDK 默认自动重试 429 与 5xx，不检查 error.code，但先检查 x-should-retry：平台判定重试无效的 503 与策略拒绝（policy_blocked）带 x-should-retry: false，SDK 与 Claude Code 收到后不再重试。可重试的错误见错误码。