认证

所有网关接口都需要 API Key。推荐使用 Authorization 请求头。

Bearer Token

项目	值
Header	Authorization
格式	Bearer YOUR_API_KEY
适用范围	所有公开网关接口

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 时，需要选择正确的绑定类型：

类型	绑定对象	支持接口
普通 API Key	普通分组	文本接口、模型列表、用量查询、同步平台图片接口。
任务 API Key	按模型任务档位	/v1/tasks、/v1/tasks/events、/v1/tasks/{id}、结果资产下载、排队任务取消，以及 OpenAI Images 兼容同步接口。

两类绑定互斥。创建步骤见 创建 API Key。

任务 API Key 可以为每个模型分别选择档位，例如为图片模型选择经济档位、为视频模型选择稳定档位。没有显式选择的模型使用该模型自己的默认档位；请求中不需要传档位参数，也不需要修改公开模型名。

如果某个显式选择的档位之后被禁用、删除或不再支持该模型，只有该模型会回到自己的默认档位，Key 上其他模型的选择不受影响。

认证失败

接口说明：

项目	值
HTTP 状态	401
Error type	authentication_error
触发条件	缺少、无效或无法识别的 API Key

响应示例：

{
  "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	任务 API 需要任务 API Key。
普通 API Key / Anthropic 分组	/v1/messages、/v1/messages/count_tokens	OpenAI 专用图片接口不可用。
普通 API Key / Gemini 分组	/v1beta/models、/v1beta/models/{model}:generateContent	OpenAI 专用图片接口不可用。
任务 API Key	/v1/tasks、/v1/tasks/events、/v1/images/generations、/v1/images/edits	只用于任务 API 和 OpenAI Images 兼容同步接口，不用于文本或对话接口。

当平台或 Key 类型不匹配时，接口可能返回 400、403 或 404。常见错误见错误页。