开始使用
密钥与调用权限
分组、模型权限与密钥设置
账户、密钥与分组
账户用于登录控制台，API Key 用于调用接口。Key 的分组、模型权限、有效期、IP 限制和可用额度都会影响调用。
分组在控制台为 Key 配置，不属于模型 ID，也不能通过请求体中的 group、渠道 ID 或上游账户字段切换。修改分组后，请重新查询模型目录并发送一次目标请求。
权限确认
- 在控制台确认 Key 已启用、未过期且额度可用。
- 用这个 Key 调用
GET /v1/models，核对完整data[].id。 - 使用该型号对应协议发送最小请求，并检查返回的内容和结束状态。
- 按业务需要分别检查工具、文件、图像编辑或实时音频。文本请求只验证文本调用。
文档中的模型目录列出型号及其协议。实际可用范围由 Key 权限和当前服务状态决定；请以 Key 设置页的分组为准，而非账户可见的全部分组。
权限错误
| 情况 | 处理 |
|---|---|
| 无效密钥、密钥禁用或过期 | 核对 Key，不使用账户密码或旧环境变量 |
| 模型不在 Key 权限内 | 核对精确 ID、分组及模型白名单 |
| 当前分组无可用渠道 | 联系平台确认该型号的可用资源，保留原模型 ID |
| 预扣额度不足 | 分别检查账户额度和 Key 额度；查询模型目录不消除这类限制 |
| 浏览器能登录但 SDK 失败 | 浏览器 Cookie 与 API Key 是两种认证；检查 SDK 实际发送的头 |
联系平台排查时，请提供发生时间、完整模型 ID、请求路径、HTTP 状态和脱敏后的 request ID。完整 Key、Cookie、私有文件和完整提示词无需发送。