이 페이지는 현재 중국어로만 제공됩니다. 내비게이션과 메뉴는 한국어로 표시됩니다.

Anthropic Messages

如需引用文件，先通过文件 API 上传素材，再使用返回的 file_id。网关负责转换，服务商是否接受由上游返回结果。

在 messages[].content 使用 {"type":"document","source":{"type":"file","file_id":"..."}}。图片使用 type: image；音频、视频使用扩展类型 audio、video，且类型必须匹配实际文件。/v1/messages/count_tokens 同样支持。

使用 POST /v1/messages 调用 Anthropic 兼容 Messages 接口。它适合 Claude 风格客户端：使用 content blocks、max_tokens、system 和 stop_reason，而不是 OpenAI Chat Completions 的 choices。

接口地址

https://api.inoneapi.com/v1/messages

# -H "X-APP-NAME: Your App Name"
# -H "X-APP-URL: https://your-app.example.com"
curl "https://api.inoneapi.com/v1/messages" \
  -H "x-api-key: $INONEAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}'

参数

字段	类型	必填	说明
model	string	是	已启用 Anthropic 协议的 InOneAPI 公共模型 ID。
max_tokens	number	是	最大生成 token 数。Anthropic 风格请求需要该字段。
messages	array	是	有序对话轮次，角色通常为 `user` 和 `assistant`。
system	string/array	否	位于 `messages` 外的系统指令。
temperature	number	否	采样随机性，受模型和供应商限制。
top_p	number	否	核采样控制。
top_k	number	否	支持时使用的 Anthropic 风格候选采样上限。
stop_sequences	array	否	自定义停止字符串。
stream	boolean	否	支持时返回 Anthropic 事件流。
tools	array	否	Anthropic 兼容工具定义。
tool_choice	object	否	控制工具自动、强制或指定名称调用。
metadata	object	否	业务侧元数据，不要放密钥。

Content blocks

消息 content 可以是字符串，也可以是带类型的 block 数组。最常见的是 text block；支持视觉的模型可根据映射接受 image block。

{
  "role": "user",
  "content": [
    { "type": "text", "text": "提取关键风险。" }
  ]
}

使用 Anthropic 工具调用时，工具结果应作为 user message 的 tool_result block 回传，并保持模型返回的 tool ID 不变。

响应

响应包含 assistant content blocks 和 Anthropic 风格 token 用量。

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "YOUR_MODEL_ID",
  "content": [
    { "type": "text", "text": "从入口生成稳定的 Trace ID 开始..." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 42,
    "output_tokens": 28
  }
}

Token 统计

兼容映射开放时，可以使用 POST /v1/messages/count_tokens 预估输入 token。请求体与 Messages 字段一致，返回 input_tokens。

curl https://api.inoneapi.com/v1/messages/count_tokens \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      { "role": "user", "content": "统计这段内容。" }
    ]
  }'

流式与错误

流式响应返回供应商风格事件。客户端应分别处理 content delta、tool-use delta、message stop 和终止错误，并保存 X-Gateway-Trace-ID 用于诊断。

常见错误包括缺少 max_tokens、不支持的 content block、模型限制、预算限制和上游映射错误。401/403 检查密钥和权限，402 检查余额或预算，429 检查速率，5xx 结合 Trace ID 排查网关或上游失败。