端点https://api.xmapi.me/v1/messages
鉴权x-api-key: <API_KEY>
协议版本anthropic-version: 2023-06-01
准备工作
- 登录控制台，为当前支持 Anthropic Messages 兼容协议的分组创建一把 API Key。
- 从模型广场确认该分组当前支持的模型，并复制模型标识。
- 确认客户端使用 Anthropic Messages 请求格式，而不是 OpenAI Chat Completions 格式。
curl 请求示例
示例使用 x-api-key 请求头。请替换 Key 与模型占位符；不要把真实 Key 写入脚本仓库。
export XIAMA_API_KEY="<XIAMA_API_KEY>"
curl https://api.xmapi.me/v1/messages \
-H "x-api-key: $XIAMA_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "<MODEL_ID>",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "用一句话介绍 API 网关"}
]
}'配置第三方客户端
不同客户端对“Base URL”的定义并不一致：有的要求填写 API 根地址，有的要求填写包含 /v1 的地址，还有的直接要求完整 Messages 端点。请优先使用控制台“用 Key”指引，并核对客户端最终请求是否发往：
POST https://api.xmapi.me/v1/messages不要在 Base URL 后重复拼接 /v1/v1/messages。若客户端只支持 OpenAI 格式，请改用OpenAI 兼容接入和相应分组，而不是混用请求格式。
分组与模型
一把 Key 只绑定一个分组。使用 Anthropic Messages 兼容接口时，应选择当前支持该协议的分组；如果还需要 OpenAI 兼容协议，应为对应分组另建一把 Key。同一分组内可通过 model 字段切换当前可用模型。
常见排查
- 确认请求方法为
POST，路径只出现一次/v1/messages。 - 确认发送
x-api-key、anthropic-version和Content-Type: application/json。 - 确认
max_tokens、messages与model均存在且格式正确。 - 确认模型属于 Key 所绑定的分组，并以响应体中的错误信息为准。
本页说明的是虾马AI 提供的 Anthropic Messages 兼容接口，不表示虾马AI与 Anthropic、Claude 或其他模型厂商存在官方合作、授权或背书。