POST https://51kik.com/anthropic/v1/messages

POST /messages（Messages API）。请求与响应格式与 Anthropic 一致。

认证

x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

或 Authorization: Bearer YOUR_API_KEY。

建议请求头

与 OpenAI 面相同，可选：x-trace-id、x-user-id、x-agent-name（用于用量与排障）。

请求体

字段必填说明
model是目录 id
messages是user / assistant，至少 1 条
max_tokens是最大输出 token
system否字符串或 [{ type: "text", text }] 数组
stream否true → Anthropic SSE 事件流
temperature, top_p, top_k否采样
stop_sequences否字符串数组
tools否{ name, description?, input_schema }[]
tool_choice否{ type: "auto" } / { type: "any" } / { type: "tool", name }
metadata否如 { user_id }
pdf_preprocess否同 OpenAI 面 PDF 扩展
extra_body否并入上游的 JSON 对象

限制： JSON 约 32 MB。

messages[].content

  • 字符串，或
  • 块数组：text、image（base64/url）、tool_use、tool_result、thinking 等（与 Anthropic 一致）。

内容块类型与必填字段由网关校验；非法组合返回 400。

非流式示例

curl -sS "https://51kik.com/anthropic/v1/messages" \
  -H "x-api-key: $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": "用一句话介绍网关" }]
  }'

流式

"stream": true 且 Accept: text/event-stream。事件含 message_start、content_block_delta、message_stop 等。见 流式响应。

Tools 流程

  1. 请求带 tools 与 tool_choice。
  2. 响应 content 中可能出现 tool_use 块。
  3. 下一请求在 user 消息中提交 tool_result 块，tool_use_id 对应。

响应（非流式）

响应为 Anthropic 格式，含 id、type: "message"、role、content[]、model、stop_reason、usage 等。

错误

{
  "type": "error",
  "error": { "type": "invalid_request_error", "message": "..." },
  "request_id": "req_..."
}

见 错误响应 · Anthropic 差异。