认证
调用本文档中的网关接口时需要 API Key。推荐使用 Authorization 请求头。
Bearer Token
| 项目 | 值 |
|---|---|
| Header | Authorization |
| 格式 | Bearer YOUR_API_KEY |
| 适用范围 | 所有公开网关接口 |
bash
curl https://api.llmapi.site/v1/usage \
-H 'Authorization: Bearer YOUR_API_KEY'兼容请求头
服务端也接受以下请求头，以兼容不同客户端：
| Header | 示例 |
|---|---|
Authorization | Bearer YOUR_API_KEY |
x-api-key | YOUR_API_KEY |
x-goog-api-key | YOUR_API_KEY |
每个请求只使用一种认证方式。新接入请使用 Authorization: Bearer。
API Key 类型
在网页 API Key 页面创建 Key，并绑定到需要调用的平台分组。
| 类型 | 绑定对象 | 支持接口 |
|---|---|---|
| 普通 API Key | 普通分组 | 文本接口、模型列表、用量查询、同步平台图片接口。 |
创建步骤见 创建 API Key。
认证失败
接口说明：
| 项目 | 值 |
|---|---|
| HTTP 状态 | 401 |
| Error type | authentication_error |
| 触发条件 | 缺少、无效或无法识别的 API Key |
响应示例：
json
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "Invalid API key"
}
}分组与平台限制
认证通过不代表所有接口都可用。
| Key 类型 | 示例接口 | 限制 |
|---|---|---|
| 普通 API Key / OpenAI 分组 | /v1/responses、/v1/chat/completions、/v1/images/generations、/v1/images/edits | OpenAI 专用接口需要绑定 OpenAI 分组。 |
| 普通 API Key / Anthropic 分组 | /v1/messages、/v1/messages/count_tokens | OpenAI 专用图片接口不可用。 |
| 普通 API Key / Gemini 分组 | /v1beta/models、/v1beta/models/{model}:generateContent | OpenAI 专用图片接口不可用。 |
当平台或 Key 类型不匹配时，接口可能返回 400、403 或 404。常见原因和处理方式见 错误。