请求头
| 请求头 | 值 | 用途 |
|---|---|---|
x-api-key | 控制台 API Key | 鉴权 |
anthropic-version | 2023-06-01 | 指定协议版本 |
Content-Type | application/json | JSON 请求体 |
不要使用 Bearer 鉴权
Messages 接口读取 x-api-key。同时检查 anthropic-version 是否存在。
curl 请求
curl https://api-models.com/v1/messages \
-H "x-api-key: $API_MODELS_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "<MODEL_ID>",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "解释什么是幂等请求。"}
]
}'max_tokens 为必填项。模型 ID 需要与控制台显示值完全一致。
请求体
| 字段 | 是否必填 | 说明 |
|---|---|---|
model | 是 | 控制台中的模型 ID |
max_tokens | 是 | 最大输出 token 数 |
messages | 是 | 用户与助手消息 |
system | 否 | 系统指令，位于 messages 外层 |
stream | 否 | 是否使用流式返回 |
迁移步骤
- 将域名改为
https://api-models.com。 - 保留
/v1/messages路径。 - 使用 API Models 的 API Key。
- 从模型与价格页面复制模型 ID。
- 先发送非流式最小请求，再恢复 system、tools 和 stream。
错误排查
| 状态码 | 检查项 |
|---|---|
| 400 | max_tokens、messages 结构、版本头 |
| 401 | x-api-key 的值和请求头名称 |
| 403 | 令牌分组与模型权限 |
| 404 | /v1/messages 路径和模型 ID |
| 429 | 余额、额度和并发限制 |
| 5xx | 记录请求 ID、时间和脱敏请求体后联系支持 |