API 参考
Messages(Anthropic 格式)
这个接口能用的模型(5)
POST
/v1/messagesAnthropic 原生线格式,用同一把 Bearer 密钥。Claude Code 和官方 anthropic SDK 只改 base URL 就能用——没有适配层,不做格式转换。
#请求参数
modelstring必填Claude 模型 ID,见模型页,例如 claude-opus-5-5。
max_tokensinteger必填Anthropic 格式要求必填——输出硬上限。
messagesarray必填Anthropic 风格轮次:{role: user|assistant, content}。
systemstring可选系统提示词——这里是顶层字段,不是 message 角色。
streamboolean可选流式返回 Anthropic 原生 SSE 事件(message_start、content_block_delta……)。
temperaturenumber可选Anthropic 标度下 0 到 1。
toolsarray可选Anthropic 工具定义;tool_use 块随 content 返回。
anthropic-version 头
按官方 API 要求带上 anthropic-version: 2023-06-01。Authorization: Bearer 可用;原版 Anthropic SDK 发的 x-api-key 也接受。
#相关错误码
- 400 invalid_request_error请求体格式错误,或该模型不支持某个参数。
- 401Bearer 令牌无效或缺失。这条路径不带 error.code,请按状态码判断。
- 402 insufficient_user_quota钱包余额不足以覆盖预扣估算。
- 429密钥级限流。响应体为空,按 Retry-After 等待。若 429 带有 insufficient_user_quota,那是每日消费上限,不是限流。
- 503 model_not_found模型名不存在,或当前没有健康渠道可以服务它。
#请求示例
curl https://www.aisplice.store/v1/messages \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 512,
"messages": [{"role": "user", "content": "Say hello."}]
}'#响应
response.json
{
"id": "msg_…",
"type": "message",
"role": "assistant",
"model": "claude-opus-5-5",
"content": [{"type": "text", "text": "Hello!"}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 10, "output_tokens": 5}
}还是没解决?
把请求 ID 或报错信息发给我们,我们来查。