认证

所有网关接口都需要 API Key。推荐通过 Authorization 请求头传入。

Bearer Token

项目	说明
Header	Authorization
格式	Bearer YOUR_API_KEY
适用接口	所有公开网关接口

curl https://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	普通分组 group_id	文本接口、模型列表、用量查询、同步 OpenAI 图片接口、Gemini native 路径。
生图 API Key	批量生图分组 image_batch_group_id	异步生图任务 /v1/images/tasks、任务查询、取消和任务事件。

两类绑定互斥。生图 API Key 不能绑定普通分组，普通 API Key 也不能绑定批量生图分组。创建步骤见 创建 API Key。

认证失败响应

接口说明：

项目	值
HTTP Status	401
错误类型	authentication_error
触发条件	API Key 缺失、无效或无法识别

响应示例：

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

分组与平台限制

认证通过不代表所有接口都可用。普通 API Key 的普通分组决定平台能力；生图 API Key 的批量生图分组决定可用生图模型、账号选择策略、并发和价格。

Key 类型	可用接口示例	限制
普通 API Key / OpenAI 分组	/v1/responses、/v1/chat/completions、/v1/images/generations	异步生图任务需要生图 API Key。
普通 API Key / Anthropic 分组	/v1/messages、/v1/messages/count_tokens	OpenAI 专属图片接口不可用。
普通 API Key / Gemini 分组	/v1beta/models...	Gemini native 路径要求 Gemini 平台分组；异步生图仍需要生图 API Key。
普通 API Key / Antigravity 分组	/antigravity/v1/messages、/antigravity/v1beta/models...	专用前缀会强制使用 Antigravity 账号池。
生图 API Key / 批量生图分组	/v1/images/tasks、/v1/images/tasks/events	只用于异步生图，不用于文本接口或同步图片接口。

平台不匹配时，接口可能返回 400、403 或 404，具体格式见错误说明页。