快速开始
- 准备账号和余额注册账号，然后充值或使用兑换码。
- 创建密钥打开 API 密钥，新建一把密钥并选择分组。分组决定这把密钥能调用哪些模型。
- 发起第一次请求把下面示例里的
sk-...换成你的密钥，运行一次。
示例使用 OpenAI 格式，需要 OpenAI 分组的密钥。模型名以模型广场为准。
接口地址与密钥
不同 SDK 拼接路径的方式不一样，Base URL 按下表填写。
| 使用场景 | Base URL | |
|---|---|---|
| OpenAI SDK 和兼容客户端 | /v1 | |
| Anthropic SDK、Claude Code | | |
| Gemini SDK、Gemini CLI | |
认证方式
下面三种请求头都可以，官方 SDK 会自动带上对应的一种。
| 接口格式 | 请求头 |
|---|---|
| OpenAI | Authorization: Bearer sk-... |
| Claude | x-api-key: sk-... |
| Gemini | x-goog-api-key: sk-... |
分组
每把密钥绑定一个分组，分组决定三件事：
- 模型
- 密钥只能调用所属分组里的模型。要用另一家的模型，就再建一把密钥。
- 接口格式
- 密钥只能调用分组支持的接口，对应关系见下一节。
- 倍率
- 倍率影响实际扣费，计算方式见计费与余额。
密钥只放在服务端。不要写进前端代码或公开仓库。怀疑泄露时，到 API 密钥页面删除它，再新建一把。
支持的接口
能调用哪个接口，取决于密钥所属的分组。具体模型以模型广场为准。
| 分组 | 接口 |
|---|---|
| Claude | POST /v1/messages |
| OpenAI | POST /v1/chat/completionsPOST /v1/responses |
| Gemini | POST /v1beta/models/{model}:generateContent |
| Grok | POST /v1/responses |
| 国产模型 | POST /v1/chat/completions |
| 所有分组 | GET /v1/models |
客户端配置
把 sk-... 换成对应分组的密钥。登录控制台后，在 API 密钥页面还可以生成 Windows CMD 和 PowerShell 版本的配置。
使用 Claude 分组的密钥，在终端里运行。
使用 OpenAI 分组的密钥，写入 ~/.codex/config.toml。
写入 ~/.codex/auth.json，填 OpenAI 分组的密钥。
使用 Gemini 分组的密钥，在终端里运行。
其他客户端
支持自定义 OpenAI 接口的客户端，填 Base URL 和密钥即可，国产模型也这样接入。Grok 分组只走 /v1/responses，Codex 和 Grok Build 的配置请到 API 密钥页面生成。
计费与余额
模型按 token 计费，输入、输出、缓存读取和缓存写入分别计价，按实际用量从余额中扣除。
费用 = 官方单价 × 用量 × 分组倍率
首页价格和模型广场的实付价格都已经乘过分组倍率，不用再自己换算。
每次调用的模型、token 用量和扣费金额都记在使用记录里。余额用完后，新请求会返回错误，充值或使用兑换码后恢复。
常见错误
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 401 | 缺少密钥，或密钥无效、已停用 | 检查请求头和密钥状态 |
| 403 | 余额不足，或分组不支持该模型 | 查看余额，确认密钥所属分组 |
| 429 | 请求过于频繁 | 降低频率，稍后重试 |
| 503 | 当前分组暂时没有可用线路 | 稍后重试，持续出现请联系管理员 |
联系管理员前，先在使用记录里找到那次请求，并附上时间和模型名。