系统使用介绍
开发者文档系统使用介绍
开发者文档

一个端点，连接所有 AI 模型

XAPI 提供兼容 OpenAI 的统一接口。保留熟悉的 SDK，只需修改 Base URL 和 API 密钥，即可在不同模型与供应商之间切换。

API 服务正常最后更新于 2026 年 9 月
统一接入地址https://api.xapi.love/v1
01

5 分钟完成首次调用

创建密钥、安装 SDK，然后发送第一条请求。所有模型共用同一套鉴权和余额。

获取 API 密钥

在控制台创建密钥。密钥只会完整显示一次，请妥善保存，不要写入客户端代码或公开仓库。

前往控制台

安装 OpenAI SDK

XAPI 兼容 OpenAI SDK；已有项目通常只需修改客户端初始化配置。

bash
pip install openai

发送聊天请求

模型名称区分大小写。你可以在模型广场复制当前可用的模型 ID。

查看模型列表
python
from openai import OpenAI

client = OpenAI(
    api_key="$XAPI_API_KEY",
    base_url="https://api.xapi.love/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello, XAPI!"}],
)

print(response.choices[0].message.content)
02

响应结构

成功响应遵循 OpenAI Chat Completions 格式。建议在生产环境记录 request_id，方便定位问题。

json
{
  "id": "chatcmpl_xapi_01",
  "object": "chat.completion",
  "model": "gpt-5.4",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hello!" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 4, "total_tokens": 16 }
}
03

核心接口

所有请求均使用 Bearer Token 鉴权，并通过 HTTPS 发送 JSON。

方法路径用途
POST/v1/chat/completions创建聊天补全
GET/v1/models列出可用模型
POST/v1/responses创建 Responses 任务
GET/v1/dashboard/billing查询账户余额与用量
04

错误处理

XAPI 使用标准 HTTP 状态码，并在响应体中返回可读的错误信息。对于 429 与 5xx 错误，请使用指数退避重试。

状态码说明建议处理
400请求参数无效检查字段、类型与模型名称
401鉴权失败检查 API 密钥与 Authorization 头
429请求过于频繁降低并发并指数退避重试
500服务暂时异常携带 request_id 联系支持
下一步

继续探索

准备好后，查看完整 API 参考，或前往模型广场选择适合任务的模型。