认证鉴权
所有模型调用接口都通过 API Key 认证。
推荐请求头
http
Authorization: Bearer $MODELGO_API_KEY
Content-Type: application/jsonAnthropic 风格客户端也可使用：
http
x-api-key: $MODELGO_API_KEY
Content-Type: application/jsonGemini 风格客户端也可使用：
http
x-goog-api-key: $MODELGO_API_KEY
Content-Type: application/json当多个头同时出现时，优先级为 Authorization > x-api-key > x-goog-api-key。
获取与管理
- 控制台：
https://console.modelgo.com - API Key 仅在创建时完整展示一次
- 吊销或停用后会在鉴权缓存失效后生效
认证失败
常见错误：
| HTTP | error_class | 说明 |
|---|---|---|
401 | auth | 缺少、无效、停用或过期的 API Key |
403 | policy | Key 有效，但不允许调用该模型或未绑定策略 |
更多错误结构见错误码与限流。