Docs

工具接入文档

面向 OpenCode、Cursor、Codex、Claude Code 的接入信息。统一使用 OpenKey API Key 和公开 Base URL。

查看 API Key

统一接入信息

所有工具都使用 OpenKey API Key。OpenCode / Cursor 走 OpenAI-compatible；Codex 和 Claude Code 走适配端点。

Base URL

/v1

https://openkey.pro/v1

Header

Bearer

Authorization: Bearer sk-openkey-...

推荐模型

openkey-pro

Codex / Claude Code 用 pro-max。

/v1/models

用于外部 OpenAI-compatible 工具读取模型列表。3 号会继续补齐鉴权细节，用户端控制台模型展示仍读取 /api/models。

List modelsexample
curl https://openkey.pro/v1/models \
  -H "Authorization: Bearer sk-openkey-..."

/v1/chat/completions

用于 OpenCode、Cursor 等 OpenAI-compatible 工具测试对话。账户需要有余额，否则会返回 insufficient_balance。

Chat completionexample
curl https://openkey.pro/v1/chat/completions \
  -H "Authorization: Bearer sk-openkey-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openkey-pro",
    "messages": [
      {
        "role": "user",
        "content": "Say hello from OpenKey."
      }
    ]
  }'

OpenCode 配置

OpenAI-compatible 主链路，适合直接接入 OpenCode。

P0
/v1/chat/completionsopenkey-pro
OpenCodeexample
export OPENAI_API_KEY=sk-openkey-xxx
export OPENAI_BASE_URL=https://openkey.pro/v1
opencode

Cursor 配置

在 Cursor 的 OpenAI-compatible 配置里填 Base URL 和模型名。

P0
/v1/chat/completionsopenkey-pro
Cursorexample
OpenAI API Key: sk-openkey-xxx
OpenAI Base URL: https://openkey.pro/v1
Model: openkey-pro

Codex 配置

优先走 Responses-compatible。具体 CLI 配置以当前 Codex 版本为准。

P1
/v1/responsesopenkey-pro-max
Codexexample
Base URL: https://openkey.pro/v1
API Key: sk-openkey-xxx
Model: openkey-pro-max
Endpoint: /v1/responses

Claude Code 配置

Anthropic Messages adapter，常用消息调用以实际端点支持为准。

P1
/v1/messagesopenkey-pro-max
Claude Codeexample
export ANTHROPIC_API_KEY=sk-openkey-xxx
export ANTHROPIC_BASE_URL=https://openkey.pro/v1
claude

端点矩阵

用户文档只展示当前明确开放的兼容协议和推荐模型。

工具兼容协议端点推荐模型阶段
OpenCodeOpenAI-compatible/v1/chat/completionsopenkey-proP0
CursorOpenAI-compatible/v1/chat/completionsopenkey-proP0
CodexCodex Responses-compatible/v1/responsesopenkey-pro-maxP1
Claude CodeAnthropic Messages adapter/v1/messagesopenkey-pro-maxP1

模型列表

对用户只展示 OpenKey 稳定模型名。这里读取 /api/models；/v1/models 只给外部工具用。

openkey-mini低成本批量任务
低成本批量任务，适合摘要、翻译和简单问答。价格待后台确认后展示。
当前可用Enabled
Chat
openkey-air普通聊天
轻量通用模型，适合日常聊天、轻写作和简单代码解释。价格待后台确认后展示。
当前可用Enabled
Chat
openkey-one日常开发
默认主力模型，覆盖通用开发、写作和代码问答。价格待后台确认后展示。
当前可用Enabled
Chat
openkey-proOpenCode / Cursor
编程增强模型，推荐给 OpenCode 和 Cursor。价格待后台确认后展示。
当前可用Enabled
Chat
openkey-pro-maxCodex / Claude Code
高阶 coding / agent 模型，推荐给 Codex 和 Claude Code。价格待后台确认后展示。
当前可用Enabled
ChatResponsesMessages
openkey-ultra复杂推理
最高能力模型，适合复杂推理、架构设计和长上下文 debug。价格待后台确认后展示。
Pro+Enabled
ChatResponsesMessages