跳到主要内容

Anthropic Messages

POST /v1/messages 支持普通响应、工具内容块和 SSE 流式响应。请求头转发规则 见下文。

请求​

curl https://yijue.ai/v1/messages \
  -H "x-api-key: ${YIJUE_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "请只回复：连接成功"}
    ]
  }'

必填字段​

字段类型说明
modelstring受支持的原生或 Claude 风格模型名
max_tokensinteger必须显式提供，当前服务端上限默认为 32,000
messagesarrayAnthropic Messages 格式的消息列表

流式响应​

在请求体加入 "stream": true：

curl -N https://yijue.ai/v1/messages?beta=true \
  -H "x-api-key: ${YIJUE_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "从 1 数到 5"}]
  }'

网关会继续读取最终上游用量并完成结算，即使客户端中途断开。上游未提供可靠 用量时，服务端会按预留规则处理费用并记录账本。

工具调用​

tools、tool_choice、tool_use 和 tool_result 内容块按 Anthropic Messages 格式透传。工具实际执行仍由 Claude Code 或你的客户端负责。

查询参数与请求头​

  • ?beta=true 等非敏感查询参数会保留。
  • anthropic-* 和 x-claude-code-* 请求头按白名单转发。
  • URL 中的 api_key、token、password 等敏感查询参数会被拒绝。
  • 客户端 Key 会在网关替换为上游 Key，不会直接发送给上游。

暂未实现​

POST /v1/messages/count_tokens 暂未实现。Claude Code 会使用本地估算； 依赖该接口的其他客户端应在集成前自行兼容这一差异。