📖 OneKey API 新手指南

OneKey API 是一个 AI 模型 API 中转站。你只需要把原本发给 OpenAI 的 API 请求，改一个 Base URL 和 API Key，就能使用 GPT、Claude、Gemini、DeepSeek 等全球主流模型。

1️⃣ 什么是中转站？

简单来说：你在客户端里填上 OneKey 的 API Key 和 Base URL，你的请求会先发到 OneKey，OneKey 再转发给 OpenAI / Claude / DeepSeek 等上游服务商，然后把 AI 的回复返回给你。

2️⃣ 注册账号 & 充值

1. 打开 https://www.onekey.baby
2. 点击「免费注册」，填写邮箱和密码
3. 注册后自动获得 ¥10 体验金
4. 点击「充值」→ 选择金额 → 微信支付

3️⃣ 创建 API Key

1. 登录后进入「控制台」
2. 点击左侧「令牌」→「新建」
3. 填写名称（如：Cherry Studio），点击确认
4. 复制生成的 API Key（格式：sk-xxxxxxxx）

4️⃣ 客户端配置

🍒 Cherry Studio（推荐）

1. 打开 Cherry Studio → 设置 → 模型
2. 点击「添加提供商」→「OpenAI」
3. API Key：粘贴你的 OneKey API Key
4. Base URL：https://www.onekey.baby/v1
5. 点击「检查」确认连通
6. 勾选需要的模型，点击确认

🎯 Cursor

1. 打开 Cursor → 设置 → 通用
2. OpenAI API Key：粘贴你的 OneKey API Key
3. OpenAI Base URL：https://www.onekey.baby/v1
4. 在「模型」标签页选择需要的模型

🤖 Claude Code

claude config set apiKey sk-your-onekey-api-key
claude config set apiBaseUrl https://www.onekey.baby/v1

⚙️ 其他通用配置

所有支持自定义 API Base URL 的客户端，配置格式如下：

API Key:    sk-your-onekey-api-key
Base URL:   https://www.onekey.baby/v1

5️⃣ 计费说明

实际扣费公式：

输入 Token 数 ÷ 1000 × 输入单价 + 输出 Token 数 ÷ 1000 × 输出单价

例如：用 Claude Sonnet 4.6 聊天，你发 1000 Token、AI 回 2000 Token：

1000÷1000×0.0324 + 2000÷1000×0.162 = ¥0.356

6️⃣ FAQ

API Key 泄露了怎么办？

进入控制台「令牌」页面，点击对应 Key 的「删除」或「重新生成」。

余额不足会通知吗？

余额低于阈值时系统会自动发送邮件提醒。

支持哪些模型？

GPT-5.5 / GPT-5.4 / Claude Opus 4.7 / Claude Sonnet 4.6 / Gemini 3.5 Flash / Grok 4.20 / DeepSeek V4 Flash / GLM-5.1 / Kimi K2.6 等 18+ 款旗舰模型。