介绍

快速开始

通过 curl 完成首次调用 —— ai.xapi.to 同时支持 Anthropic 与 OpenAI 协议。

xAPI 的统一接入点是 https://ai.xapi.to,同时支持 Anthropic Messages 与 OpenAI Chat Completions 两种协议 —— 根据客户端选择对应的 endpoint 路径即可。

所有端点接受两种鉴权头,任选其一:

1x-api-key: sk-xapi-...            # Anthropic SDK 默认
2Authorization: Bearer sk-xapi-... # OpenAI SDK 默认
1

创建 API Key

进入 xapi.to 控制台,在 API Keys 页面创建密钥。

密钥仅在创建时显示一次,请妥善保管 —— 丢失后无法找回, 只能撤销并重新生成。

2

调用 Claude(Anthropic 协议)

$curl https://ai.xapi.to/v1/messages \
>  -H "x-api-key: sk-xapi-..." \
>  -H "anthropic-version: 2023-06-01" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "model": "claude-opus-4-7",
>    "max_tokens": 1024,
>    "messages": [{"role": "user", "content": "Hello"}]
>  }'

x-api-key 是 Anthropic 官方 API 的标准鉴权头,Claude Code 等官方 SDK 默认即可使用。

3

调用 GPT-5.5(OpenAI 协议)

$curl https://ai.xapi.to/v1/chat/completions \
>  -H "Authorization: Bearer sk-xapi-..." \
>  -H "Content-Type: application/json" \
>  -d '{
>    "model": "gpt-5.5",
>    "messages": [{"role": "user", "content": "Hello"}]
>  }'

OpenAI SDK 默认使用 Authorization: Bearer 鉴权 —— 把 OPENAI_BASE_URL 指向 https://ai.xapi.to/v1、OPENAI_API_KEY 填 sk-xapi-... 即可直接使用,无需任何额外配置。

4

路由策略

通过 URL 路径前缀切换路由优先级,不改变请求体或响应体:

路径前缀策略
ai.xapi.to/v1/...(默认)quality — 官方源与高 SLA 上游优先
ai.xapi.to/speed/v1/...speed — 当前延迟最低
ai.xapi.to/cost/v1/...cost — 当前价格最低

例:

$curl https://ai.xapi.to/cost/v1/messages \
>  -H "x-api-key: sk-xapi-..." \
>  -H "anthropic-version: 2023-06-01" \
>  -d '{ "model": "claude-opus-4-7", ... }'
5

流式响应

在请求体中设置 "stream": true:

$curl https://ai.xapi.to/v1/messages \
>  -H "x-api-key: sk-xapi-..." \
>  -H "anthropic-version: 2023-06-01" \
>  -H "Content-Type: application/json" \
>  -N \
>  -d '{"model":"claude-opus-4-7","max_tokens":1024,"stream":true,"messages":[{"role":"user","content":"讲个笑话"}]}'

流式响应不会在 response headers 中返回最终的 X-AI-Cost —— 响应头在流式传输开始时即已发送至客户端。 如需查询费用,请通过控制台 → Usage Records 获取。

响应头说明

Header含义
X-AI-Cost本次扣款金额(USD,8 位小数,仅非流式成功响应返回)
X-AI-Tokens-Input / Output / TotalToken 用量统计
X-Routing-Provider实际命中的上游标识
X-Routing-Attempts尝试次数(>1 表示发生过自动故障转移)
X-Routing-Fallback是否走了 fallback 上游
X-XAPI-Sourceprovider(上游响应)或 platform(网关层错误)
X-XAPI-Request-Id平台请求 ID,排障时附在工单中

后续步骤

IDE / CLI 集成

Claude Code · Codex · Cursor 等

模型清单

跨上游价格对比

API 参考

完整端点与字段说明