Claude Messages - AIMax

适用于已使用 Anthropic Messages SDK 的应用。请保持 Anthropic 原生请求头与消息结构，不要改用 OpenAI 的 Bearer 请求头或 choices[] 响应读取方式。

请求鉴权

x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
content-type: application/json

正式接口

POST /v1/messages

完整地址：https://api.aimaxa.cn/v1/messages。

请求参数

字段	类型	必填	说明
`model`	`string`	是	当前 API Key 可见的模型名称，Claude 系与国产模型均可，如 `claude-sonnet-4-6`、`deepseek-v4-pro`、`glm-5.3`、`kimi-k3`、`qwen3.8-flash`。
`max_tokens`	`integer`	是	本次响应允许生成的最大 token 数。
`messages`	`array`	是	对话消息数组。最小纯文本请求使用 `role` 和字符串 `content`。

调用示例

Claude 系模型：

curl --request POST \
  --url https://api.aimaxa.cn/v1/messages \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'anthropic-version: 2023-06-01' \
  --header 'content-type: application/json' \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 8,
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

国产模型（保持相同的 Anthropic Messages 请求结构，仅替换 model）：

curl --request POST \
  --url https://api.aimaxa.cn/v1/messages \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'anthropic-version: 2023-06-01' \
  --header 'content-type: application/json' \
  --data '{
    "model": "deepseek-v4-pro",
    "max_tokens": 8,
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

成功响应

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    {
      "type": "text",
      "text": "OK"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "output_tokens": 1,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

从 content[] 中筛选 type: "text" 的项并读取 text。用量读取 usage.input_tokens 与 usage.output_tokens；当响应提供缓存统计时，可读取 cache_creation_input_tokens 与 cache_read_input_tokens。

注意事项

anthropic-version: 2023-06-01 是该协议请求的一部分，不能省略。
max_tokens 为 Messages 请求必填字段，即使只预期短回答也需要设置。
已完成纯文本 Messages 与工具调用验证；prompt caching 写入控制与 computer use 暂不承诺。
国产模型通过平台转译接入，请求与响应结构保持 Anthropic Messages 格式，但各模型对工具调用、文件操作和多回合 Agent 的支持程度需以实测为准。