API 参考

本参考仅收录面向客户、保持兼容的正式接口。所有 API 使用同一个服务地址；除公开定价外，请求均需携带 API Key。

export BASE_URL="https://api.xairouter.com"
export API_KEY="sk-Xvs..."

选择文档

• Router API 调用模型，查询可用模型、价格与账号状态。

• 用量统计 API 查询当前账号与后代账号的实时用量、历史趋势、模型明细和排行。

• 账号管理 API 管理 API 账号、额度与访问范围。

• Provider Key API 录入并管理 OpenAI、Anthropic、Gemini 等上游 Provider Key。

最小示例

curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-nano",
    "messages": [{"role": "user", "content": "你好"}]
  }'

约定

• 认证统一使用 Authorization: Bearer <API_KEY>。
• 请求和响应使用 UTF-8 JSON；文件上传接口使用 multipart/form-data。
• 日期使用 YYYY-MM-DD，时间使用 RFC 3339。
• 只有本参考列出的路径和字段属于公开兼容范围。
• API Key 只应保存在服务端或安全的密钥管理系统中。

相关文档

• 快速开始
• 术语表