请输入
菜单

Claude Messages 对话

按 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28