开始使用
选择分组
让密钥与客户端和模型权限匹配。
准备：让权限与用途匹配
准备好目标客户端、接口能力和通过 /v1/models 取得的模型 ID。分组决定一把 Key 可使用的平台、模型、接口能力和计费范围。它不是客户端里的文件夹，也不是把多个 Key 放在一起的标签。
操作步骤
- 先确认目标客户端使用哪种协议。Codex 和新服务端集成通常使用 Responses；部分旧工具使用 Chat Completions；Claude 生态工具可能使用 Anthropic Messages。
- 在创建或编辑 Key 时阅读每个可选分组的说明。
- 选择明确支持目标平台和能力的分组。需要图像生成时，还要确认分组允许 Images API。
- 保存后立即使用该 Key 请求
GET /v1/models，不要从旧截图猜模型。
powershell
$env:SUOXIE_API_KEY = '<API_KEY>'
curl.exe --fail-with-body https://suoxie.codes/v1/models `
-H "Authorization: Bearer $env:SUOXIE_API_KEY"bash
export SUOXIE_API_KEY='<API_KEY>'
curl --fail-with-body https://suoxie.codes/v1/models \
-H "Authorization: Bearer $SUOXIE_API_KEY"成功标志
- 请求返回 HTTP 200。
data中能找到准备使用的模型 ID。- 最小文本请求正常返回；需要图片时，再单独验证图像端点。
若没有出现目标模型，先检查选择的是不是当前 Key 的分组、余额或订阅是否有效，以及客户端是否仍缓存旧模型。
失败时先检查
| 现象 | 可能原因 |
|---|---|
| 模型列表没有目标模型 | 当前分组未提供该模型，或模型暂不可用 |
| 返回 403 | Key、账户、IP 或分组权限不允许当前操作 |
| Images API 被拒绝 | 分组未开放图像生成，或平台不支持该端点 |
| 客户端一直报模型不存在 | 使用了展示名称而不是 /v1/models 中的精确 ID |
不要通过反复修改模型拼写绕过分组限制。回到 Key 页面核对分组，或选择该分组实时返回的模型。
安全边界：更换分组的影响
更换后，可用模型、路由方式和计费可能立即变化。先在非生产 Key 上验证，再修改生产 Key。更稳妥的做法是为新分组创建另一把 Key，完成迁移后撤销旧 Key。
安全边界：切换分组不会让旧客户端自动更新模型；不要为了绕过订阅或权限提示反复切换，也不要让多个生产环境共用同一把 Key。
下一步
使用模型选择确认精确模型 ID，然后进入对应的客户端配置或 Responses API。