按 Anthropic Messages 协议提交对话。system 指令放在顶层,而不是 messages 中的 system 角色。
请求
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 路径 | /v1/messages |
| 网关地址 | https://ailink.nativex.com |
| 认证 | Authorization: Bearer sk-xxxx,替换为你的 API Key |
| 请求格式 | application/json |
示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。
参数说明
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
anthropic-version |
Header | string | 是 | API 版本,例如 2023-06-01 |
model |
Body | string | 是 | 支持 Claude 协议的模型 |
messages |
Body | object[] | 是 | user / assistant 消息;content 可为文本或内容块 |
max_tokens |
Body | integer | 是 | 正整数,限制最大输出 token 数 |
system |
Body | string / object[] | 否 | 系统指令 |
stream |
Body | boolean | 否 | true 启用流式事件 |
temperature |
Body | number | 否 | 传统范围 0~1;以具体模型为准 |
tools |
Body | object[] | 否 | 工具定义 |
thinking |
Body | object | 否 | 思考配置,需模型支持 |
模型支持的思考参数与采样参数组合可能不同,避免直接照搬其他模型的配置。
调用示例
curl -X POST 'https://ailink.nativex.com/v1/messages' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{
"model": "MODEL_ID",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍自己。"
}
]
}'
响应
以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "我是你的 AI 助手。"
}
],
"stop_reason": "end_turn"
}
| 字段或结果 | 说明 |
|---|---|
| content[] | 文本、工具调用等输出内容块 |
| stop_reason | 结束原因 |
| usage | 输入和输出用量 |
错误处理
非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。