常见问题

进入 xapi.to 控制台 → API Keys → 新建。 密钥仅在创建时显示一次,请妥善保管;丢失后无法找回,需删除原密钥重新创建。

无硬性数量限制。建议为每个使用场景(团队成员、CI、Agent、不同项目) 分别签发独立密钥,并通过 balanceLimit 配置各自的扣费上限, 避免单点异常影响整体余额。

控制台 → API Keys → 选择目标密钥 → 设置 balanceLimit(USD)。 该密钥累计扣款达到上限后,后续调用返回 HTTP 402, 但不影响主账户余额池及其他密钥。

立即在控制台 → API Keys → 撤销(Revoke)。 撤销后即时失效,同时建议核查 Usage Records 是否存在异常调用。

兼容 Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM 等主流模型, 与上游同步更新。完整清单见 模型与价格。

按所选上游的原生命名填写。例如 SkyAPI 上 Claude 系使用横线 (claude-opus-4-7),OpenRouter 风格使用斜杠加点 (anthropic/claude-opus-4.6)。

聚合路由 ai.xapi.to 会执行不区分大小写的模糊匹配; 直连上游子域时必须精确匹配该上游的支持列表。

• Anthropic Messages(POST /v1/messages):聚合路由
• OpenAI Chat Completions(POST /v1/chat/completions):直连上游子域

所有兼容上述两套协议的客户端(Claude Code、Cursor、Codex、Continue 等)均可直接接入。

支持。在请求体中设置 "stream": true,xAPI 透明透传上游的 SSE 流。

注意:流式响应不会在 response headers 中返回最终的 X-AI-Cost —— 响应头在流式传输开始时即已发送至客户端。 如需查询费用,请通过控制台 → Usage Records 获取, 或从最后一个 chunk 的 usage 字段解析。

支持。请求体中的 tools 与 tool_choice 字段全量透传给上游。 具体支持情况由上游决定 —— Claude 系全部支持;GPT-5.5 支持; Gemini 通过 OpenAI 协议层适配。

支持。在 messages 中传入 image_url(OpenAI 格式)或 content: [{type: "image", source: {...}}](Anthropic 格式)即可, 网关原样透传。

控制台 → Billing → Top up。支持加密货币(BSC 链 USDT / USDC, 通过 x402 协议自动确认)与 Stripe 信用卡。

• 非流式:响应头 X-AI-Cost(USD,8 位小数)
• 流式:控制台 → Usage Records,该行的 cost 字段
• 批量查询:控制台支持按日期、密钥、模型筛选,并导出 CSV

按 per-model 动态定价:

费用 = inputTokens × inputPrice
    + outputTokens × outputPrice
    + cacheCreationTokens × cacheCreationPrice
    + cacheReadTokens × cacheReadPrice

部分模型(如 Claude >200K 上下文)有阶梯定价。 完整价格表见 模型与价格。

后续调用直接返回 HTTP 402,不会扣至负值。 充值后即恢复服务,已扣金额不予退还。

通常不扣费。xAPI 采用预扣 → 结算两阶段:

• 同时设置了 ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN 时,前者优先。 执行 unset ANTHROPIC_API_KEY 并重启终端
• 当前 shell 未加载新环境变量:source ~/.zshrc
• 在 session 中输入 /status 确认当前 base URL

• Base URL 缺少 /v1 后缀。正确格式:https://ai.xapi.to/v1
• API Key 字段直接填 sk-xapi-...,客户端会用 Authorization: Bearer 发出,xAPI 直接接受
• 密钥含空格或不可见字符,重新复制粘贴
• 公司网络拦截:关闭 VPN / 代理后重试

当前模型不在所选上游的支持列表中:

1. 改为 模型清单 中明确列出的模型
2. 或改用聚合路由 ai.xapi.to(支持跨上游模糊匹配)

• 密钥拼写错误或包含空格。 通过 echo -n "$XAPI_KEY" | wc -c 检查字符数
• 密钥未生效或已被撤销。在控制台 → API Keys 中确认密钥状态
• 所有端点都接受 xapi-key、Authorization: Bearer、x-api-key 三种头之一

上游限频。聚合路由会自动重试至其他健康上游 (通过 X-Routing-Attempts > 1 确认)。 直连上游时建议等待几秒重试或切换至其他上游。

不存储。xAPI 仅记录元数据:模型、token 数量、扣费金额、 HTTP 状态码、响应时间,用于计费与监控。

全程 HTTPS 加密。网关侧通过 SHA-256 哈希进行缓存校验, 明文密钥不写入日志。

不能。xAPI 在调用上游时使用平台维护的上游凭据 (数据库中 AES 加密存储),sk-xapi-... 仅用于 xAPI 内部识别用户。