Messages

/v1/messages 是 Anthropic Messages 兼容入口，适合 Claude Code 和 Anthropic 协议客户端。请求模型需要对当前 API Key 可用。

接口说明

项目	值
Method	POST
Path	/v1/messages
Content-Type	application/json
认证	Authorization: Bearer YOUR_API_KEY

请求参数

参数	类型	必填	说明
model	string	是	请求模型。
messages	array	是	Anthropic Messages 格式消息数组。
max_tokens	integer	通常必填	最大输出 token。
system	string 或 array	否	系统提示。
stream	boolean	否	是否流式响应。
thinking	object	否	推理相关配置，按模型和平台能力生效。
metadata.user_id	string	否	可用于会话亲和和请求追踪。

请求示例

curl https://api.llmapi.site/v1/messages \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 512,
    "messages": [
      { "role": "user", "content": "Summarize this request." }
    ]
  }'

响应 — 200 OK

{
  "id": "msg_123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-5",
  "content": [
    {
      "type": "text",
      "text": "Summary text."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 24,
    "output_tokens": 12
  }
}

当 stream 为 true 时，响应使用 Anthropic 兼容事件流。

Token Count

/v1/messages/count_tokens 用于 Anthropic token 统计。它会校验订阅和余额，但不计算并发、不记录使用量。

项目	值
Method	POST
Path	/v1/messages/count_tokens
Content-Type	application/json
限制	OpenAI 平台分组不支持

请求示例：

curl https://api.llmapi.site/v1/messages/count_tokens \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

OpenAI 分组响应示例：

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "Token counting is not supported for this platform"
  }
}

Token Count 成功响应：

{
  "input_tokens": 42
}

错误码

状态码	原因
400	请求体、模型名或消息 payload 无效。
401	API Key 缺失或无效。
403	余额、额度、分组或订阅校验失败。
404	当前平台不支持该接口，或请求模型不可用。
429	达到频率限制或并发限制。
500 / 502 / 503	网关或上游服务商失败。