切换外观
创建 Anthropic 消息
POST/messages接口说明
使用 x-api-key 或 Bearer API Key 调用 Anthropic Messages;支持 JSON、全部官方 SSE 事件、工具、Thinking、Prompt Cache、图片、内联 PDF/文档和结构化输出,成功终态必须包含真实 Usage。
请求
方法:
POST鉴权:
x-api-key: ${TOKENFACTORY_API_KEY}或Authorization: Bearer ${TOKENFACTORY_API_KEY}(二选一)
请求头
| 名称 | 必填 | 值或类型 | 说明 |
|---|---|---|---|
x-api-key | 二选一 | ${TOKENFACTORY_API_KEY} | Anthropic 官方 SDK 使用的 API Key 请求头 |
Authorization | 二选一 | Bearer ${TOKENFACTORY_API_KEY} | Bearer API Key 请求头 |
Content-Type | 是 | application/json | 请求体媒体类型 |
anthropic-version | 否 | string (date) | Anthropic API 版本;可选,缺省时按 2023-06-01 处理,官方 SDK 会自动发送。显式值须为有效的 YYYY-MM-DD 日期,原样交给供应商判断版本支持;格式或日期无效返回 400 invalid_request_error。 |
anthropic-beta | 否 | string | 可选的 Anthropic Beta 功能列表;官方 SDK 按所用功能发送。 |
anthropic-user-profile-id | 否 | string | 当前不支持;为遵守用户 PII 不进入 AI 上下文的边界,发送该请求头即返回 400 invalid_request_error。 |
路径参数:无
查询参数:无
请求字段
| 字段 | 类型 | 必填 | 说明 | 示例或约束 |
|---|---|---|---|---|
cache_control | object | 否 | Anthropic Prompt Cache 控制块。 | 示例:{"ttl":"5m","type":"ephemeral"};可为 null |
cache_control.ttl | string | 否 | 缓存生存时间。 | 示例:"5m";最短:1 字符 |
cache_control.type | string | 父字段存在时必填 | 固定为 ephemeral。 | 示例:"ephemeral";可选值:"ephemeral" |
container | string 或 object | 否 | 官方容器引用;允许为 null。Token Factory 当前没有 Anthropic Containers 生命周期与同供应商亲和,提供非 null 值会返回 400 invalid_request_error。 | 可为 null;形式:string 或 object |
inference_geo | string | 否 | 推理处理地域;允许为 null,官方值域保持开放。 | 可为 null |
max_tokens | integer (int32) | 是 | 允许生成的最大 Token 数;0 可用于 Prompt Cache 预热。 | 示例:1024;最小值:0 |
messages | object[] | 是 | Anthropic 消息数组;每项必须包含 role 与 content。 | 示例:[{"content":[{"text":"解释图片和文档","type":"text"},{"source":{"data":"...","media_...;最多:100000 项 |
messages[].content | string 或 object[] | 是 | 消息正文字符串或内容块数组;可承载文本、图片、内联文档、工具结果和 Thinking 上下文。Anthropic Messages 没有标准音频输入内容块。 | 示例:[{"text":"解释图片和文档","type":"text"},{"source":{"data":"...","media_type":"image...;形式:string 或 object[] |
messages[].content[].cache_control | object | 否 | Anthropic Prompt Cache 控制块。 | 可为 null |
messages[].content[].cache_control.ttl | string | 否 | 缓存生存时间。 | 最短:1 字符 |
messages[].content[].cache_control.type | string | 父字段存在且匹配该形式时必填 | 固定为 ephemeral。 | 可选值:"ephemeral" |
messages[].content[].caller | object | 否 | 工具调用来源;官方允许省略或为 null,存在时必须是对象。 | 可为 null |
messages[].content[].content | object | 否 | 工具结果正文;可为字符串或内容块数组。 | — |
messages[].content[].data | string | 否 | 不透明的已编辑 Thinking 数据。 | — |
messages[].content[].file_id | string | 否 | container_upload 的远程文件 ID。该结构可识别,但 Token Factory 当前没有 Anthropic Files/Containers 生命周期与亲和,发送 container_upload 会返回 400 invalid_request_error。 | — |
messages[].content[].id | string | 否 | 工具调用 ID。 | — |
messages[].content[].input | object | 否 | 工具调用的结构化输入。 | — |
messages[].content[].is_error | boolean | 否 | 工具结果是否表示错误。 | — |
messages[].content[].name | string | 否 | 工具名。 | — |
messages[].content[].signature | string | 否 | 不透明的 Thinking 签名;可省略或为空字符串,省略时转发补空。已有字符串原样保留,平台不认证来源;非字符串拒绝。 | — |
messages[].content[].source | object 或 string | 否 | 图片/文档来源对象,或 search_result 的来源字符串;由 type 决定。 | 形式:object 或 string |
messages[].content[].source.data | string | 否 | Base64 或纯文本正文。 | — |
messages[].content[].source.file_id | string | 否 | 官方 Files 引用 ID;Token Factory 当前未实现 Files 生命周期,发送即返回 400 invalid_request_error。 | — |
messages[].content[].source.media_type | string | 否 | MIME 类型。 | — |
messages[].content[].source.type | string | 父字段存在且匹配该形式时必填 | 来源类型。 | 可选值:"base64"、"url"、"text" |
messages[].content[].source.url | string | 否 | HTTPS 资源 URL。 | — |
messages[].content[].text | string | 否 | 文本内容。 | 示例:"解释图片和文档" |
messages[].content[].thinking | string | 否 | 扩展思考内容。 | — |
messages[].content[].title | string | 否 | search_result 标题。 | — |
messages[].content[].tool_use_id | string | 否 | 对应的工具调用 ID。 | — |
messages[].content[].toolset_name | string | 否 | 工具所属工具集名称。 | — |
messages[].content[].type | string | 匹配该形式时必填 | 当前官方内容块类型;对象对未来新增字段保持开放。 | 示例:"text";可选值:"text"、"image"、"document"、"tool_use"、"tool_result"、"thinking"、"redacted_thinking"、"search_result"、"server_tool_use"、"web_search_tool_result"、"web_fetch_tool_result"、"code_execution_tool_result"、"bash_code_execution_tool_result"、"text_editor_code_execution_tool_result"、"tool_search_tool_result"、"container_upload" |
messages[].content[].url | string | 否 | search_result URL。 | — |
messages[].role | string | 是 | 消息角色;system 仅用于官方支持模型的中途系统消息,并须遵守官方位置规则;初始系统提示使用顶层 system。 | 示例:"user";可选值:"user"、"assistant"、"system" |
metadata | object | 否 | Anthropic 请求元数据。 | 示例: |
metadata.user_id | string | 否 | 非识别性的 opaque 用户 ID;不得发送姓名、邮箱、手机号或其他 PII。 | 示例:"usr_opaque_9f4c2a";最长:512 字符;可为 null |
model | string | 是 | 要调用的模型 ID。 | 示例:"YOUR_MODEL_ID" |
output_config | object | 否 | Anthropic 输出配置。 | 示例:{"effort":"high","format":{"schema":{"properties":{"answer":{"type":"string"}... |
output_config.effort | string | 否 | 模型思考与响应的 effort;可用值取决于模型。 | 示例:"high";最短:1 字符;可为 null |
output_config.format | object | 否 | JSON Schema 结构化输出格式。 | 示例:{"schema":{"properties":{"answer":{"type":"string"}},"required":["answer"],"t...;可为 null |
output_config.format.schema | object | 父字段存在时必填 | 输出 JSON Schema。 | 示例:{"properties":{"answer":{"type":"string"}},"required":["answer"],"type":"obje... |
output_config.format.type | string | 父字段存在时必填 | 固定为 json_schema。 | 示例:"json_schema";可选值:"json_schema" |
service_tier | string | 否 | 服务等级选择。 | 示例:"auto";最短:1 字符 |
stop_sequences | string[] | 否 | 自定义停止字符串数组。 | 示例:["<END>"] |
stream | boolean | 否 | 是否使用 Anthropic SSE 事件流。 | 示例:false |
system | string 或 object[] | 否 | 系统提示词字符串或可带 cache_control 的文本内容块数组。 | 示例:[{"cache_control":{"type":"ephemeral"},"text":"请准确回答","type":"text"}];形式:string 或 object[] |
system[].cache_control | object | 否 | Anthropic Prompt Cache 控制块。 | 示例:{"type":"ephemeral"};可为 null |
system[].cache_control.ttl | string | 否 | 缓存生存时间。 | 最短:1 字符 |
system[].cache_control.type | string | 父字段存在且匹配该形式时必填 | 固定为 ephemeral。 | 示例:"ephemeral";可选值:"ephemeral" |
system[].text | string | 父字段存在且匹配该形式时必填 | 系统提示词文本。 | 示例:"请准确回答" |
system[].type | string | 父字段存在且匹配该形式时必填 | 固定为 text。 | 示例:"text";可选值:"text" |
temperature | number | 否 | 已弃用的采样温度,范围 0 到 1。 | 最小值:0;最大值:1 |
thinking | object 或 object 或 object | 否 | Anthropic Thinking 设置;具体结构由 type 决定。 | 示例:{"budget_tokens":1024,"type":"enabled"};形式:object 或 object 或 object |
thinking.budget_tokens | integer (int32) | 父字段存在且匹配该形式时必填 | 非负 Thinking 预算;最低预算及其与 max_tokens 的关系由供应商判断。 | 示例:1024;最小值:0 |
thinking.display | string | 否 | Thinking 展示方式;允许为 null。 | 最短:1 字符;可为 null |
thinking.type | string | 父字段存在且匹配该形式时必填 | 固定为 enabled。;固定为 adaptive。;固定为 disabled。 | 示例:"enabled";可选值:"enabled";示例:"enabled";可选值:"adaptive";示例:"enabled";可选值:"disabled" |
tool_choice | object | 否 | Anthropic 工具选择设置。 | 示例: |
tool_choice.disable_parallel_tool_use | boolean | 否 | 是否禁用并行工具调用。 | — |
tool_choice.name | string | 否 | type=tool 时指定的工具名。 | — |
tool_choice.type | string | 父字段存在时必填 | 工具选择模式。 | 示例:"auto";可选值:"auto"、"any"、"tool"、"none" |
tools | object[] | 否 | Anthropic 客户端工具或官方服务端工具定义数组;具体可用类型由供应商判断,诊断结果不参与选路。 | 示例:[{"cache_control":{"ttl":"5m","type":"ephemeral"},"description":"查询指定城市天气","i... |
tools[].allowed_callers | string[] | 否 | 允许调用该工具的来源;非空字符串数组,版本与扩展值由供应商判断。 | — |
tools[].cache_control | object | 否 | Anthropic Prompt Cache 控制块。 | 示例:{"ttl":"5m","type":"ephemeral"};可为 null |
tools[].cache_control.ttl | string | 否 | 缓存生存时间。 | 示例:"5m";最短:1 字符 |
tools[].cache_control.type | string | 父字段存在时必填 | 固定为 ephemeral。 | 示例:"ephemeral";可选值:"ephemeral" |
tools[].description | string | 否 | 工具说明。 | 示例:"查询指定城市天气" |
tools[].input_schema | object | 否 | 工具输入 JSON Schema。 | 示例:{"properties":{"city":{"type":"string"}},"required":["city"],"type":"object"} |
tools[].name | string | 否 | 工具名。 | 示例:"lookup_weather" |
tools[].type | string | 否 | 官方内置服务端工具类型;具体可用值由供应商判断,客户端函数工具可省略。 | — |
top_k | integer (int32) | 否 | 已弃用的 top-k 采样参数;应仅用于高级用例。 | 最小值:0 |
top_p | number | 否 | 已弃用的核采样参数,范围 0 到 1。 | 最小值:0;最大值:1 |
请求报文
媒体类型:application/json
json
{
"cache_control": {
"ttl": "5m",
"type": "ephemeral"
},
"max_tokens": 2048,
"messages": [
{
"content": [
{
"text": "解释图片和文档",
"type": "text"
},
{
"source": {
"data": "...",
"media_type": "image/png",
"type": "base64"
},
"type": "image"
},
{
"source": {
"data": "...",
"media_type": "application/pdf",
"type": "base64"
},
"type": "document"
}
],
"role": "user"
}
],
"metadata": {
"user_id": "usr_opaque_9f4c2a"
},
"model": "YOUR_MODEL_ID",
"output_config": {
"effort": "high",
"format": {
"schema": {
"properties": {
"answer": {
"type": "string"
}
},
"required": [
"answer"
],
"type": "object"
},
"type": "json_schema"
}
},
"service_tier": "auto",
"stop_sequences": [
"<END>"
],
"stream": true,
"system": [
{
"cache_control": {
"type": "ephemeral"
},
"text": "请准确回答",
"type": "text"
}
],
"thinking": {
"budget_tokens": 1024,
"type": "enabled"
},
"tool_choice": {
"type": "auto"
},
"tools": [
{
"cache_control": {
"ttl": "5m",
"type": "ephemeral"
},
"description": "查询指定城市天气",
"input_schema": {
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
],
"type": "object"
},
"name": "lookup_weather"
}
]
}响应
成功状态:200
响应头
| 名称 | 值或类型 | 说明 |
|---|---|---|
Content-Type | application/json 或 text/event-stream | 响应媒体类型 |
request-id | string | Token Factory 独立生成的平台请求编号;Anthropic 错误体的 request_id 与其相同。 |
retry-after | string | 可选重试等待提示:非负秒数或标准 HTTP 日期。重试前仍需确认请求可安全重复。 |
x-request-id | string | Token Factory 独立生成的平台请求编号,与 request-id 相同。 |
响应字段
Anthropic Messages 成功终态;官方新增字段保持开放。 下表完整列出当前公开协议明确声明的字段;开放扩展只允许未声明的附加字段,不会放宽已声明字段的必填、类型或枚举约束。
| 字段 | 类型 | 必填 | 说明 | 示例或约束 |
|---|---|---|---|---|
container | object | 否 | 执行容器信息;没有容器时为 null。 | 示例:null;可为 null |
content | object 或 object 或 object 或 object 或 object 或 object 或 object 或 object 或 object 或 object 或 object 或 object 或 object[] | 是 | Anthropic 输出内容块数组;官方允许为空,可返回文本、工具调用、Thinking、已编辑 Thinking 或服务端工具结果。 | 示例:[{"signature":"sig_example","thinking":"先核对输入信息。","type":"thinking"},{"citati... |
content[].citations | object[] | 否 | 引用数组;没有引用时为 null。 | 可为 null |
content[].text | string | 匹配该形式时必填 | 文本内容。 | — |
content[].type | string | 匹配该形式时必填 | 固定为 text。;固定为 thinking。;固定为 redacted_thinking。;工具调用类型。;工具调用类型。;工具结果类型。;工具结果类型。;工具结果类型。;工具结果类型。;工具结果类型。;工具结果类型。;固定为 container_upload。;未列出的有效内容类型;已知类型使用对应结构。 | 示例:"thinking";可选值:"text";示例:"thinking";可选值:"thinking";示例:"thinking";可选值:"redacted_thinking";示例:"thinking";可选值:"tool_use";示例:"thinking";可选值:"server_tool_use";示例:"thinking";可选值:"web_search_tool_result";示例:"thinking";可选值:"web_fetch_tool_result";示例:"thinking";可选值:"code_execution_tool_result";示例:"thinking";可选值:"bash_code_execution_tool_result";示例:"thinking";可选值:"text_editor_code_execution_tool_result";示例:"thinking";可选值:"tool_search_tool_result";示例:"thinking";可选值:"container_upload";示例:"thinking";最短:1 字符 |
content[].signature | string | 匹配该形式时必填 | 不透明的 Thinking 签名;缺省时补空字符串,已有字符串原样保留并可用于续接,平台不认证来源。 | 示例:"sig_example" |
content[].thinking | string | 匹配该形式时必填 | Thinking 文本。 | 示例:"先核对输入信息。" |
content[].data | string | 匹配该形式时必填 | 必须原样续接的不透明数据。 | — |
content[].caller | object | 匹配该形式时必填 | 可选调用来源;可省略或为 null,出现非 null 时必须是对象。;调用来源。;调用来源。 | 可为 null |
content[].id | string | 匹配该形式时必填 | 工具调用 ID。 | — |
content[].input | object | 匹配该形式时必填 | 工具调用输入 JSON 对象。 | — |
content[].name | string | 匹配该形式时必填 | 工具名。 | 最短:1 字符 |
content[].toolset_name | string | 否 | 工具集成员所属工具集;官方可省略。 | 可为 null |
content[].content | object | 匹配该形式时必填 | 该服务端工具的结果或错误对象。 | — |
content[].tool_use_id | string | 匹配该形式时必填 | 对应的服务端工具调用 ID。 | — |
content[].file_id | string | 匹配该形式时必填 | 已上传文件 ID。 | — |
id | string | 是 | 消息 ID。 | 示例:"msg_example" |
model | string | 是 | 实际模型 ID。 | 示例:"YOUR_MODEL_ID" |
role | string | 是 | 固定为 assistant。 | 示例:"assistant";可选值:"assistant" |
stop_details | object | 否 | 停止详情;没有详情时为 null。 | 示例:null;可为 null |
stop_reason | string | 是 | 停止原因;未结束时为 null。 | 示例:"end_turn";最短:1 字符;可为 null |
stop_sequence | string | 是 | 命中的自定义停止序列;未命中时为 null。 | 示例:null;可为 null |
type | string | 是 | 固定为 message。 | 示例:"message";可选值:"message" |
usage | object | 是 | Anthropic 官方 Usage;input_tokens 与 output_tokens 必须存在,其余缓存、推理地域、Thinking、服务端工具和等级字段均为可选扩展。 | 示例:{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_toke... |
usage.cache_creation | object | 否 | 按 TTL 拆分的缓存创建明细。 | 示例:null;可为 null |
usage.cache_creation.ephemeral_1h_input_tokens | integer (int32) | 父字段存在时必填 | 写入 1 小时缓存的输入 Token。 | 最小值:0 |
usage.cache_creation.ephemeral_5m_input_tokens | integer (int32) | 父字段存在时必填 | 写入 5 分钟缓存的输入 Token。 | 最小值:0 |
usage.cache_creation_input_tokens | integer (int32) | 否 | 创建缓存所用输入 Token;可为 null。 | 示例:0;最小值:0;可为 null |
usage.cache_read_input_tokens | integer (int32) | 否 | 从缓存读取的输入 Token;可为 null。 | 示例:0;最小值:0;可为 null |
usage.inference_geo | string | 否 | 实际推理地域;可为 null。 | 示例:null;可为 null |
usage.input_tokens | integer (int32) | 是 | 输入 Token 数。 | 示例:23;最小值:0 |
usage.output_tokens | integer (int32) | 是 | 输出 Token 数。 | 示例:11;最小值:0 |
usage.output_tokens_details | object | 否 | 输出 Token 分类明细。 | 示例:null;可为 null |
usage.output_tokens_details.thinking_tokens | integer (int32) | 父字段存在时必填 | 内部 Thinking Token 数。 | 最小值:0 |
usage.server_tool_use | object | 否 | 服务端工具调用计数。 | 示例:null;可为 null |
usage.server_tool_use.web_fetch_requests | integer (int32) | 父字段存在时必填 | Web Fetch 请求数。 | 最小值:0 |
usage.server_tool_use.web_search_requests | integer (int32) | 父字段存在时必填 | Web Search 请求数。 | 最小值:0 |
usage.service_tier | string | 否 | 实际服务等级;可为 null。 | 示例:"standard";最短:1 字符;可为 null |
返回报文
媒体类型:application/json
json
{
"container": null,
"content": [
{
"signature": "sig_example",
"thinking": "先核对输入信息。",
"type": "thinking"
},
{
"citations": null,
"text": "{\"answer\":\"你好\"}",
"type": "text"
}
],
"id": "msg_example",
"model": "YOUR_MODEL_ID",
"role": "assistant",
"stop_details": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"type": "message",
"usage": {
"cache_creation": null,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"inference_geo": null,
"input_tokens": 23,
"output_tokens": 11,
"output_tokens_details": null,
"server_tool_use": null,
"service_tier": "standard"
}
}SSE 返回报文
媒体类型:text/event-stream
允许事件:message_start、content_block_start、content_block_delta、content_block_stop、message_delta、message_stop、ping、error
协议终态:message_stop、error
text
event: message_start
data: {"type":"message_start","message":{"id":"msg_example","type":"message","role":"assistant","model":"YOUR_MODEL_ID","container":null,"content":[],"stop_details":null,"stop_reason":null,"stop_sequence":null,"usage":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"inference_geo":null,"input_tokens":23,"output_tokens":0,"output_tokens_details":null,"server_tool_use":null,"service_tier":"standard"}}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"thinking","thinking":"","signature":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"thinking_delta","thinking":"先核对输入信息。"}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"signature_delta","signature":"sig_example"}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: content_block_start
data: {"type":"content_block_start","index":1,"content_block":{"type":"text","citations":null,"text":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":1,"delta":{"type":"text_delta","text":"{\"answer\":\"你好\"}"}}
event: content_block_stop
data: {"type":"content_block_stop","index":1}
event: message_delta
data: {"type":"message_delta","delta":{"container":null,"stop_details":null,"stop_reason":"end_turn","stop_sequence":null},"usage":{"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":23,"output_tokens":11,"output_tokens_details":null,"server_tool_use":null}}
event: message_stop
data: {"type":"message_stop"}只有上方列出的协议终态才表示流正常结束;连接中断不代表请求未执行。若已经收到部分内容,不要无条件重放同一请求。
错误
| 适用完整地址 | 状态 | 错误码 | 常见触发 | 重试 | 建议动作 | 结果风险 |
|---|---|---|---|---|---|---|
https://api.tokenfactory.cn/anthropic/v1/messages | 401 | invalid_api_key | x-api-key 与 Bearer API Key 均缺失、格式错误、不可用或账户未实名 | 否 | 检查 x-api-key 或 Bearer API Key、Key 状态与实名状态 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 400 | model_not_found | 当前模型不可用 | 否 | 核对模型名称与请求地址;持续出现时联系支持 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 404 | model_not_found | 模型不存在、未上架或当前入口不可用 | 否 | 调用模型列表并改用当前入口可用模型 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 404 | MODEL_ROUTING_PROTOCOL_UNSUPPORTED | 当前模型不可用 | 否 | 核对模型名称与当前入口的模型列表;持续出现时联系支持 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 503 | MODEL_ROUTING_NOT_CONFIGURED | 当前模型服务不可用 | 视情况 | 稍后重试;持续出现时提供平台请求编号联系支持 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 503 | MODEL_ROUTING_POLICY_INVALID | 当前模型服务不可用 | 视情况 | 稍后重试;持续出现时提供平台请求编号联系支持 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 503 | MODEL_ROUTING_NO_AVAILABLE_ROUTE | 当前模型服务不可用 | 否 | 提供平台请求编号联系支持,确认服务恢复后再发送 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 402 | insufficient_balance | 账户可用余额不足 | 否 | 充值后重新发起请求 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 429 | balance_daily_limit_exceeded | 账户当天余额消费已达到自助上限 | 否 | 调整每日上限或等待次日恢复 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 413 | request_too_large | 请求体超过平台接收上限 | 否 | 缩小请求体后重试 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 400 | invalid_request_error | 请求参数或请求体缺字段、格式错误或不受支持 | 否 | 修正请求后重试 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 502 | upstream_error | 服务响应异常,请稍后重试 | 视情况 | 确认未收到有效结果后再决定是否重试 | 中到高 |
https://api.tokenfactory.cn/anthropic/v1/messages | 504 | upstream_timeout | 请求处理超时,请稍后重试 | 视情况 | 先确认是否已有部分输出,再决定是否重试 | 中到高 |
https://api.tokenfactory.cn/anthropic/v1/messages | 500 | internal_error | 平台内部出现未预期错误 | 视情况 | 确认未收到有效结果并记录请求时间后再决定是否重试 | 中到高 |
https://api.tokenfactory.cn/anthropic/v1/messages | 405 | method_not_allowed | 请求方法不是该公开地址允许的方法 | 否 | 改用文档列出的 HTTP 方法 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 415 | unsupported_media_type | Content-Type 与该公开地址要求的媒体类型不一致 | 否 | 按文档发送正确 Content-Type | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 403 | permission_error | 当前 API Key 无权执行该请求 | 否 | 检查 API Key 权限与当前入口的模型可见性 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 409 | conflict_error | 请求与当前资源状态冲突 | 视情况 | 读取最新状态后修正请求或稍后重试 | 中到高 |
https://api.tokenfactory.cn/anthropic/v1/messages | 503 | service_unavailable | 服务暂不可用,请稍后重试 | 视情况 | 保留平台请求编号,稍后重试或联系支持 | 中到高 |
https://api.tokenfactory.cn/anthropic/v1/messages | 503 | service_busy | 模型服务繁忙,请稍后重试 | 视情况 | 参考 Retry-After 并限制重试次数;已收到输出时先确认是否可安全重复 | 中到高 |
https://api.tokenfactory.cn/anthropic/v1/messages | 400 | context_length_exceeded | 输入超过模型上下文限制 | 否 | 缩短输入或减少历史上下文后再发送 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 400 | missing_required_parameter | 缺少必填请求参数 | 否 | 按文档补齐错误指出的公开参数后再发送 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 400 | invalid_parameter | 请求参数的类型或格式不正确 | 否 | 修正错误指出的公开参数类型或格式后再发送 | 无 |
https://api.tokenfactory.cn/anthropic/v1/messages | 502 | upstream_usage_missing | 服务响应缺少可验证的用量信息 | 视情况 | 保留平台请求编号联系支持;确认可安全重复后再发送 | 中到高 |
错误返回报文
适用完整地址
https://api.tokenfactory.cn/anthropic/v1/messages
HTTP 400;Content-Type: application/json;响应头:request-id: string、retry-after: string、x-request-id: string
json
{
"error": {
"message": "当前模型不可用",
"type": "invalid_request_error"
},
"request_id": "req_0123456789abcdef0123456789abcdef",
"type": "error"
}适用完整地址:https://api.tokenfactory.cn/anthropic/v1/messages
供应商非 2xx 响应会归一化为当前公开协议的错误信封,并只保留安全响应头;502、504 或连接中断时,调用结果可能未知。
限制与计费
| 适用完整地址 | 限制或计费说明 |
|---|---|
https://api.tokenfactory.cn/anthropic/v1/messages | 请求成功后按通用余额计费;余额不足时调用失败。 受全局请求体上限约束。 模型上下文与输出限制依当前模型和上游事实而定。 支持文本、图片、内联 PDF/文档、Tools、Thinking、Structured Output 与 Prompt Cache。 不增加 Anthropic 私有音频字段;不支持 Files/Containers 生命周期、container 引用、container_upload、Realtime 或独立 Audio API。 |
相关说明
请求与响应按当前 OpenAI 兼容能力开放;供应商扩展字段可能随所选模型变化。