认证鉴权

网关请求鉴权方式与 API 密钥安全保管最佳实践。

创建 API 密钥

在控制台打开【API 密钥】页面，创建具有足够额度且拥有目标模型权限的密钥。将后续示例中的 YOUR_API_KEY 替换为你实际的密钥。

认证请求头

请使用网关 API 密钥，而非上游模型供应商的原始密钥。在 HTTP 请求的 Authorization 标头中以 Bearer 格式携带。请妥善在服务端保管密钥，切勿打包进前端代码、公开仓库或截图分享中。

Authorization: Bearer YOUR_API_KEY

常见问题排查

如遇鉴权错误，请检查密钥是否正确及是否过期；如遇额度不足，请核对账户余额与密钥额度上限；若模型不可用，请核对模型 ID 拼写与分组权限；若遇到频率限制，请携带退避重试机制再次请求。