接入基础说明
Xikapi 是一个 API 中转站：你的客户端或代码把请求发给 Xikapi，Xikapi 再按所选模型和兼容协议转发。对大多数 OpenAI 兼容工具而言，只需要把原来的服务地址和 Key 换成 Xikapi 的值。
四个最容易混淆的词
| 名词 | 它是什么 | 你通常在哪里填写 | 常见误区 |
|---|---|---|---|
| API Key | 证明调用身份的私密凭据 | 工具的 API Key、Token 或环境变量字段 | 把原厂 Key 填到 Xikapi 地址，或把 Key 发到截图和群聊里 |
| Base URL | SDK 或工具请求的基础地址 | Base URL、API Host、API Base 等字段 | 把完整接口路径填进基础地址，造成重复路径和 404 |
| 模型 ID | 后台实际启用的模型名称 | Model、Model ID、模型列表字段 | 凭印象填写模型名，或加了工具不需要的 provider 前缀 |
| 接口协议 | 请求字段和路径的规则 | SDK 类型、Provider 类型或请求代码 | 把 Gemini 的 contents 发给 OpenAI Chat Completions |
地址怎么理解
下面的地址用于不同情况，不能互相替换：
| 你在做什么 | 应使用的地址 |
|---|---|
| 在 OpenAI 兼容客户端或 SDK 中填写 Base URL | https://xikapi.com/v1 |
| 直接调用 Chat Completions | https://xikapi.com/v1/chat/completions |
| 直接调用 Responses API | https://xikapi.com/v1/responses |
| 直接调用 Anthropic Messages | https://xikapi.com/v1/messages |
| 直接调用 Gemini Generate Content | https://xikapi.com/v1beta/models/{model}:generateContent |
客户端的 Base URL 和直接发 HTTP 请求的完整地址不是同一个字段。工具会自行补上 /chat/completions 或 /responses；只有你亲自写 curl 或 HTTP 代码时，才写完整地址。
推荐的首次接入顺序
- 在 Xikapi 控制台创建或复制 API Key，并复制一个当前可用的模型 ID。
- 按 快速开始 发送最小请求，确认 Key、地址和模型都能连通。
- 根据用途到 按场景配置 选择聊天客户端、代码助手、工作流或团队网关。
- 需要某一种协议的高级能力时，再进入 API 参考 和对应供应商页面。
首次测试只发送一句纯文本。图片、工具调用、联网搜索、结构化输出等能力应该在基础请求成功后逐项打开，这样出现问题时才能判断是配置错误还是模型能力限制。