DEVELOPER GUIDE

从一个 Key，
开始调用模型。

创建密钥、获取可见模型、复制调用示例。在这里完成接入所需的准备。

01 / 准备账号

1. 注册并验证邮箱

创建账号，收到验证码后完成注册。已有账号可直接登录。

2. 确认使用额度

在控制台确认余额或订阅有效。创建 Key 不代表已获得免费调用额度。

3. 创建本站 API Key

进入 API Key 管理，选择可用分组并创建密钥。客户端使用此密钥，不使用上游 OAuth Token。

OPENAI 兼容 BASE URLhttps://api.genegps.com/v1

鉴权请求头：Authorization: Bearer YOUR_SUB2API_KEY。具体接口是否可用取决于分组、模型和上游账号，不能仅凭模型名称判断。

如果客户端自动添加 /v1，只填写 https://api.genegps.com；如果要求完整请求地址，则填写完整端点。避免重复的 /v1/v1。

模型列表按 API Key 的分组返回。这里不预设模型名称，也不将列表结果当作调用成功的保证。

密钥仅用于浏览器向本站发送模型查询，不写入地址、Cookie 或本地存储。不会自动发起模型生成请求。

尚未查询。也可使用下方终端命令。

通过终端查询

先查询模型并点击模型名，或填入管理员提供的准确模型 ID。生成请求会消耗额度；先用简短输入测试。

模型 ID

示例使用环境变量读取 Key，不会把上方输入的真实密钥写入代码。cURL 示例适用于 Bash；Python 示例只需标准库。

桌面客户端怎么填？

选择客户端提供的 OpenAI 兼容服务，填写上面的 Base URL、本站 Key 和模型 ID。OpenAI 授权账号建议先测试 Responses；只有确认模型支持对应接口后，再使用 Chat Completions。不同客户端的接口模式和 URL 拼接规则可能不同。

分组决定 Key 可以使用的上游账号、模型、路由及定价。同一供应商分组可包含多个账号；复合分组可按模型路由到不同供应商，但需要管理员已接入相应账号。

一个 Key 能调用哪些模型，以其权限与实际可用上游为准。模型列表为空时，先检查 Key 是否绑定正确分组。价格、倍率和可用额度以控制台为准，本页不展示未经核实的固定价格。

请将密钥用于自己的后端或受信任客户端，不要放进公开网页、代码仓库或分享截图。泄露后在 Key 管理页撤销并重新创建。

现象	检查方向
401 / Key 无效	使用本站创建的 Key，检查是否撤销、过期或复制不完整。
403 / 权限不足	检查用户状态、Key 分组、模型白名单及客户端限制。
余额不足 / 订阅失效	检查控制台额度和有效期；以返回的错误信息为准。
404 / 模型或接口不存在	核对模型 ID、Base URL、重复 /v1，以及接口支持情况。
429 / 频率或额度限制	降低并发，按 Retry-After（若有）等待，避免立即重复重试。
无可用账号 / 502 / 503	请管理员检查上游授权、调度状态、配额及服务器出站网络。
流式中断 / 超时	先用短输入测试，检查客户端超时与代理链路；保存请求时间和请求 ID。
验证码未收到	检查垃圾邮件、邮箱拼写；若仍未收到，请管理员查看邮件投递记录。

反馈问题时提供时间、模型 ID、接口路径、HTTP 状态和脱敏错误信息；不要附上 Key、密码或验证码。