创建 API Key

调用 LLMAPI 前，需要先在控制台创建合适类型的 API Key。当前有两类 Key：

类型	绑定对象	主要用途
普通 API Key	普通分组	文本接口、模型列表、用量查询、同步 OpenAI 图片接口、Gemini native 路径等。
生图 API Key	批量生图分组	异步生图任务 `/v1/images/tasks`、任务查询和任务事件。

两类 Key 的绑定关系互斥。普通 API Key 不能绑定批量生图分组；生图 API Key 不能绑定普通分组。

创建普通 API Key

普通 API Key 适合接入文本模型、普通 OpenAI 兼容接口、Anthropic Messages、Gemini native 兼容路径，以及同步 OpenAI 图片接口。

操作步骤：

登录控制台，进入 API Key 页面。
点击 创建 API Key。
填写名称，例如 production-text、claude-code。
在 绑定类型 中选择 普通分组。
在 资源分组 中选择可用分组。
按需配置自定义 Key、IP 限制、额度、限速和过期时间。
提交后复制生成的 Key，并妥善保存。

普通分组决定这个 Key 可以访问的平台和模型：

分组平台	常见接口
OpenAI	`/v1/responses`、`/v1/chat/completions`、`/v1/models`、`/v1/images/generations`
Anthropic	`/v1/messages`、`/v1/messages/count_tokens`
Gemini	`/v1beta/models...`、Gemini native 兼容路径
Antigravity	`/antigravity/v1/messages`、`/antigravity/v1beta/models...`

请求时使用：

bash

curl https://llmapi.site/v1/models \
  -H 'Authorization: Bearer YOUR_API_KEY'

创建生图 API Key

生图 API Key 专门用于异步生图。它需要绑定管理员开放的 批量生图分组，该分组会定义可用模型、账号选择策略、并发限制和价格策略。

操作步骤：

登录控制台，进入 API Key 页面。
点击 创建 API Key。
填写名称，例如 production-image、batch-image-jobs。
在 绑定类型 中选择 批量生图分组。
在 批量生图分组 下拉框中选择一个可用分组。
按需配置额度、限速和过期时间。
提交后复制生成的 Key，并妥善保存。

生图 API Key 只能用于异步生图相关接口：

接口	说明
`POST /v1/images/tasks`	提交异步生图任务。
`GET /v1/images/tasks/{task_id}`	查询任务结果。
`POST /v1/images/tasks/{task_id}/cancel`	取消仍在排队的任务。
`GET /v1/images/tasks/events`	监听当前 Key 的任务事件。

示例：

bash

curl https://llmapi.site/v1/images/tasks \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-2.5-flash-image",
    "prompt": "a clean studio product photo of a matte black water bottle",
    "image_size": "1K",
    "aspect_ratio": "1:1",
    "n": 1
  }'

如何选择

需求	应选择
Claude Code、Codex CLI、Chat Completions、Responses	普通 API Key
查询模型列表和用量	普通 API Key
同步 OpenAI 图片生成或编辑	普通 API Key，并选择支持图片的 OpenAI 分组
长耗时、批量、生产环境异步生图	生图 API Key
使用 `gemini-2.5-flash-image`、`gemini-3.1-flash-image` 做异步生图	生图 API Key，并选择包含对应模型的批量生图分组

常见问题

现象	原因与处理
`/v1/images/tasks` 返回不支持或权限错误	使用了普通 API Key。请创建并使用绑定批量生图分组的生图 API Key。
生图模型不可用	当前批量生图分组没有启用该模型，或模型名不正确。Gemini 生图请使用官方模型名。
文本接口无法使用	生图 API Key 只用于异步生图。文本接口请使用普通 API Key。
下拉框没有批量生图分组	管理员尚未开放可用的批量生图分组，或当前账号没有使用权限。

创建 API Key ​

创建普通 API Key ​

创建生图 API Key ​

如何选择 ​

常见问题 ​

创建 API Key

创建普通 API Key

创建生图 API Key

如何选择

常见问题