开发文档

接入 OneKeyAPI

正式 API Base URL 固定为 https://api.onekeyapi.ai。当前推荐先使用 Codex / GPT 兼容链路。

Claude Code 与 Gemini 当前仍是规划/预留能力，不要对外承诺正式可用。

基础信息

项目	地址
官网	`https://onekeyapi.ai`
控制台	`https://panel.onekeyapi.ai`
API Base URL	`https://api.onekeyapi.ai`

可用接口

GET /v1/models：查看当前 Token 可用模型。
POST /v1/chat/completions：OpenAI-compatible 对话补全接口。

调用示例

curl https://api.onekeyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "codex",
    "messages": [{"role":"user","content":"只回复 ok"}],
    "max_tokens": 20
  }'

模型口径

模型/通道	当前状态	建议口径
Codex / GPT	已验证	可作为内测主推能力。
Claude Code	待真上游	规划中，接入稳定合法上游后开放。
Gemini	预留	规划中，后续用于长上下文和多模态。

常见客户端配置

Base URL：https://api.onekeyapi.ai
API Key：在控制台创建或由管理员发放。
Model：当前优先使用 codex / gpt-5.5。