APIQi API 使用文档

APIQi 开发者文档,用于应用、Codex 和 Claude Code 接入。

快速开始

API Base URL
https://apiqi.xyz/v1
若客户端自动追加 /v1,则填写 https://apiqi.xyz

创建密钥

登录 APIQi 控制台,在“令牌”中创建 API 密钥并选择分组。密钥只应保存在安全位置。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

OpenAI 兼容协议

curl "https://apiqi.xyz/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL","input":"你好"}'
curl "https://apiqi.xyz/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"你好"}]}'

Anthropic 兼容协议

curl "https://apiqi.xyz/v1/messages" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"YOUR_MODEL","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

CC Switch 导入 API 密钥

推荐使用 CC Switch 管理不同供应商和 API 密钥。先在 APIQi 控制台创建密钥,然后按以下任一方式导入。

方式一:手动复制

  1. 打开 APIQi 控制台的“API 密钥”页面。
  2. 复制当前密钥。
  3. 在 CC Switch 中新建供应商配置。
  4. 填写 Base URL:https://apiqi.xyz/v1,并粘贴 API Key。

方式二:从 APIQi 项目导入

如果 CC Switch 支持从项目导入,选择 APIQi 密钥所在项目,确认 Base URL 和模型设置后保存。

方式三:使用“导入到 CC Switch”

在 APIQi 密钥列表中点击“导入到 CC Switch”(或类似名称的按钮),按照 CC Switch 提示确认。导入后请检查 Base URL 是否为 APIQi 地址,避免仍然指向其他供应商。

APIQi 配置值
Base URL:https://apiqi.xyz/v1
API Key:填写你自己的密钥
模型:填写 APIQi 控制台中实际可用的模型

查看 CC Switch 图文使用指南 ↗

Codex 与 Codex++ 下载

如果本机无法直接下载安装 Codex 客户端,可以访问以下下载站:

https://codexdown.cc/

下载后,再按照本页的 Codex 配置说明,将 APIQi 的 Base URL 和 API Key 配置到客户端或通过 CC Switch 导入。

Codex CLI / Desktop

Windows 配置文件:%USERPROFILE%\.codex\config.toml

model = "YOUR_MODEL"
model_provider = "apiqi"

[model_providers.apiqi]
name = "APIQi"
base_url = "https://apiqi.xyz/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

常见错误

状态说明
401密钥缺失、无效或已过期
403分组没有目标模型权限
429请求过多或额度不足
5xx上游或网关暂时异常

流式请求加入 "stream": true。不要在网页、公开仓库或截图中保存真实密钥。