跳到主要内容

应用集成

大多数 AI 客户端和 Agent 工具只需要以下三项信息即可连接 XInfera：

字段值
Base URLhttps://api.xinfera.cn 或 https://api.xinfera.cn/v1
API 密钥XInfera 控制台中的 sk- 密钥
模型 ID/v1/models 或模型广场中的模型 ID

推荐集成​

开始前​

  1. 在 XInfera 控制台创建 API 密钥。
  2. 打开 模型广场选择模型。
  3. 确认该模型能通过当前 API 密钥在 GET /v1/models 中看到。
  4. 在工具中配置 Base URL、API 密钥和模型 ID。
  5. 先发送一个短测试提示词，再执行大型任务。

常见问题​

  • 401 Unauthorized：API 密钥缺失、复制错误、已禁用，或没有填在工具预期字段中。
  • 403 Forbidden：API 密钥有效，但被模型分组、IP 白名单、有效期或配额拦截。
  • 404 Not Found：Base URL 或 endpoint 格式与工具协议不匹配。
  • Model not available：所选模型未对该 API 密钥分组开放。
  • Gateway not running：对于 OpenClaw 等自托管 Agent，请重启本地 gateway 并运行 doctor 命令。
  • 成本较高：日常任务使用更便宜模型，复杂推理再切换强模型。

Contents