Anthropic Messages Compatible
接入 Anthropic Messages API
使用支持 Anthropic Messages 兼容协议的分组 API Key，通过 https://api.xmapi.me/v1/messages 发送 Messages 格式请求。
端点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 网关"}
]
}'成功标志
- 请求返回 HTTP
200，响应正文没有error对象。 - 响应 JSON 的
type为message，且content数组中存在模型返回内容。 - 登录后打开
/usage使用记录，能按请求时间和模型找到这次调用。
模型输出文案并不固定。验证时应检查 HTTP 状态、Messages 响应结构和站内使用记录。
配置第三方客户端
不同客户端对“Base URL”的定义并不一致。请先确认客户端会自动追加哪些路径，并以最终请求发往 POST https://api.xmapi.me/v1/messages 为准。
| 客户端要求 | 填写内容 | 最终请求应为 |
|---|---|---|
API 主机或根地址，客户端明确会自行追加 /v1/messages | 只有“使用密钥”或该客户端当前文档明确要求时，才填写 https://api.xmapi.me | https://api.xmapi.me/v1/messages |
包含版本的 API Base URL，客户端只追加 /messages | https://api.xmapi.me/v1 | https://api.xmapi.me/v1/messages |
| 完整 Messages 端点 | https://api.xmapi.me/v1/messages | 与填写内容相同 |
不要让最终路径变成 /v1/v1/messages 或 /v1/messages/messages。请优先使用控制台“使用密钥”指引；若客户端只支持 OpenAI 格式，请改用OpenAI 兼容接入和相应分组，而不是混用请求格式。
分组与模型
一把 Key 只绑定一个分组。使用 Anthropic Messages 兼容接口时，应选择当前支持该协议的分组；如果还需要 OpenAI 兼容协议，应为对应分组另建一把 Key。同一分组内可通过 model 字段切换当前可用模型。
去 /usage 核对用量与费用
- 登录同一账户并打开使用记录。
- 按调用时间、模型或 API Key 名称定位记录，核对输入、输出等用量字段。
- 以该次调用记录中的实际费用为准；模型和价格会动态调整，本文不复制固定单价。
常见排查
- 确认请求方法为
POST，路径只出现一次/v1/messages。 - 确认发送
x-api-key、anthropic-version和Content-Type: application/json。 - 确认
max_tokens、messages与model均存在且格式正确。 - 确认模型属于 Key 所绑定的分组，并以响应体中的错误信息为准。
本页说明的是虾马AI 提供的 Anthropic Messages 兼容接口，不表示虾马AI与 Anthropic、Claude 或其他模型厂商存在官方合作、授权或背书。