Xikapi 接入文档

如何使用这份文档 ​

这是一份 Xikapi API 中转站的自助接入文档。它的目标不是让你记住所有接口，而是帮你按正确顺序完成第一条请求，并在出错时知道该检查什么。

从哪里开始 ​

你的目标先看这里
第一次调用 API快速开始
不理解 Key、Base URL 或模型 ID接入基础说明
想在聊天、代码或工作流工具中使用按场景配置
已经报错报错指南
想了解 OpenAI、Claude、Gemini 等协议API 参考

先记住四件事 ​

  1. API Key 是你的访问凭据，从 Xikapi 控制台创建或复制；不要使用原厂 Key 访问 Xikapi 地址。
  2. Base URL 是客户端连接的基础地址。OpenAI 兼容客户端通常填写 https://xikapi.com/v1，不要在这个字段中追加 /chat/completions。
  3. 模型 ID 必须逐字使用控制台当前显示、且你的 Key 有权限调用的名称。文档中的 YOUR_MODEL_ID 只是提醒你替换，不是可直接调用的模型名。
  4. 接口协议 必须和请求格式一致：Chat Completions 用 messages，Responses 用 input，Anthropic 用 messages + max_tokens，Gemini 用 contents。

自助排错与支持边界 ​

绝大多数问题可以用最小请求定位。请先按 报错指南 检查 Key、地址、模型权限和请求字段；这样能避免在工具设置、代码和模型之间反复猜测。

需要协助时，请准备请求时间和时区、模型 ID、请求路径、HTTP 状态码、错误文本，以及是否使用流式输出、图片或工具调用。不要发送完整 API Key；展示时只保留前后几位。