Anthropic Messages 适配层字段表
查询 POST /v1/messages 中哪些字段可跨协议承载、哪些只在 Anthropic 上游使用。缓存参数见对话端点。
发送 Messages 请求
curl "https://staging-dp.taotoken.io/v1/messages" \
-H "x-api-key: $TP_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL_ID","max_tokens":64,"messages":[{"role":"user","content":"你好"}]}'先设置 TP_API_KEY,按模型目录替换 MODEL_ID。请求可能产生费用。
一、入站(你的请求 → 平台)保留的字段
| 字段 | 处理方式 |
|---|---|
model / messages | 解析进内部结构,必填 |
system(字符串或内容块数组) | 保留纯文本作为内部审查视图;显式缓存请求在同协议出站时另保留原文本块和断点,其他请求沿用原有合并行为 |
cache_control(顶层或已支持内容块/工具定义) | 同协议已支持形状保留合法 ephemeral 控制及省略/5m/1h TTL和块顺序;跨协议或未支持形状沿原转换并记录限制,不保证缓存语义;严格跨协议拒绝不在本批启用 |
max_tokens | 保留数值,出站时可能被裁剪(见下) |
temperature / top_p | 保留数值 |
stream | 保留 |
tools / tool_choice | 原样保留,出站时按目标协议改写形状 |
thinking({type, budget_tokens}) | 解析出预算值,归一成内部推理结构 |
消息里的 tool_use / tool_result / thinking / redacted_thinking 内容块 | 分别识别并保留(工具调用改写成内部统一形状;thinking/redacted_thinking 连同 signature 整块原样保留,见下方跨协议限制) |
二、入站解析时被静默丢弃的字段
以下字段传了不会报错,但也完全不会生效——平台内部结构根本没有为它们保留位置:
| 字段 | 现象 |
|---|---|
top_k | 传了完全不生效,无论目标供应商是谁 |
stop_sequences | 即使目标供应商也是 Anthropic,你传的停止序列也不会被使用 |
metadata(含 user_id) | 整体丢弃 |
三、出站(平台 → 目标为 Anthropic 的供应商)时的改写
| 字段 | 改写规则 |
|---|---|
max_tokens | 你给了就用,但不超过该模型规格配置的输出上限(超了截断为该上限);你没给则用规格上限,规格也没配则回落 4096;非流式请求这个值另有硬顶 8192 |
temperature | 你给的值 > 1.0 时截断为 1.0(Anthropic 硬性上限),不会报错 |
system | 显式缓存请求保留原支持的文本块形状及顺序;无缓存标记时,多个 system 消息仍以换行符拼接 |
thinking.budget_tokens | 若达到或超过最终的 max_tokens,截断为 max_tokens - 1;若结果小于 1024,整个 thinking 字段不会发送(低于 Anthropic 最小预算,发了必然 400,索性不发等同于"这次没开思考") |
frequency_penalty / presence_penalty / n / seed / logprobs / top_logprobs / response_format | Anthropic 协议没有对应概念,出站请求里完全不会出现这些键——这是协议本身不支持,不是平台缺陷 |
四、跨协议限制:携带签名的推理内容
平台按推理载荷方言判断能否承载,而非按供应商身份判断签名是否互认。发往 Anthropic 且本次启用了思考时,无法承载的跨方言载荷会在出站前返回 4xx;同方言的 thinking/redacted_thinking 按原值回传,不改写签名。换供应商后的签名是否被接受仍由实际上游验证,平台不保证同方言跨供应商互认。缓存承载修复不绕过这项既有检查。
五、流式响应的事件格式与验证范围
Messages 流使用 event: <type> 和对应的 JSON type。正常流以 message_stop 结束,读取上游中断时可能收到 error 事件。客户端应按 Messages 事件处理这个响应。
当上游来自其它协议时,事件载荷、内容块生命周期和用量字段可能与原生 Anthropic 流不同。依赖完整 SDK 消息积累的客户端,应核对所选模型和路径。
六、原生输出与自适应思考参数
以下参数用于 Messages 请求路由到 Anthropic 上游时。
| 参数 | 承载范围 |
|---|---|
output_config.effort | low、medium、high、xhigh、max 字符串;不补默认、不换算固定思考预算 |
output_config.format | 仅 { "type": "json_schema", "schema": { ... } };schema 保留原数值、嵌套及引用,不展开引用、不删改约束或补字段;不使用 OpenAI 的 json_schema 包装或自动添加 name / strict |
thinking | 仅最小 { "type": "adaptive" } 原生承载,不增加 budget_tokens;省略不会自动启用。带预算、display 或其他扩展的 adaptive 组合保留原转换限制,不删字段伪造另一模式 |
output_config 承载表中列出的子字段。这些字段不会映射到 Chat、Responses 或 Gemini。单独使用 effort 或 format 不会自动设置思考模式。
平台仍发送 anthropic-version: 2023-06-01。恢复 wire 字段不保证具体供应商、模型、版本接受或实际输出满足 schema;上游错误沿原链返回,不自动删参或重试。格式与 citations、预填充等组合,以及 adaptive 与强制工具的支持须按所选上游核实。参数可能改变输出/思考用量及缓存命中,费用不保证相同;实际 usage 计价公式未改。
max_tokens: 0 可能按默认值或规格上限处理,请勿用它做零输出预热。