创建 API Key

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

类型	绑定对象	主要用途
普通 API Key	普通分组	文本接口、模型列表、用量查询、同步平台图片接口等普通网关接口。
任务 API Key	按模型任务档位	`/v1/tasks` 图片、视频等长耗时媒体任务，以及任务查询、取消、SSE 更新、结果资产下载和 OpenAI Images 兼容同步接口。

两类 Key 绑定关系互斥。普通 API Key 不能提交任务 API；任务 API Key 只能访问 /v1/tasks*、POST /v1/images/generations 和 POST /v1/images/edits。

创建普通 API Key

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

操作步骤：

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

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

分组平台	常见接口
OpenAI	`/v1/responses`、`/v1/chat/completions`、`/v1/models`、`/v1/images/generations`、`/v1/images/edits`
Anthropic	`/v1/messages`、`/v1/messages/count_tokens`
Gemini	`/v1beta/models`、`/v1beta/models/{model}:generateContent`、`/v1beta/models/{model}:streamGenerateContent`

请求时使用：

bash

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

创建任务 API Key

任务 API Key 用于图片、视频等长耗时媒体任务。Key 可以为每个模型单独选择 任务档位；没有显式配置的模型使用该模型默认档位。

操作步骤：

登录控制台，进入 API Key 页面。
点击 创建 API Key。
填写名称，例如 production-media、media-jobs。
选择 任务 Key 类型；按需在“模型档位”中为各模型选择档位。保留“跟随默认”即可使用该模型当前默认档位。
按需配置额度、限速和过期时间。
提交后复制生成的 Key，并妥善保存。

同一个 Key 也可以让不同模型使用不同档位，例如 gpt-image-2 使用经济档位、seedance 使用稳定档位。请求协议保持不变：不需要增加档位参数，也不需要修改模型名。提交任务前，可以使用这个 Key 调用 GET /v1/tasks/models，读取各模型最终生效的价格和参数约束。

如果某个显式选择的档位之后被禁用、删除或不再支持该模型，该模型会自动回到自己的默认档位，其他模型配置不受影响。管理员新增模型时，旧 Key 也会自动使用新模型的默认档位。

任务 API Key 只能用于以下公开接口：

接口	说明
`POST /v1/tasks`	提交任务。
`GET /v1/tasks/models`	查询当前 Key 可执行的模型、价格和参数约束。
`GET /v1/tasks/{id}`	查询任务状态与结果。
`GET /v1/tasks/events`	监听当前 Key 的任务更新。
`GET /v1/tasks/{id}/assets/{index}`	下载结果资产。
`POST /v1/tasks/{id}/cancel`	取消仍在排队的任务。
`POST /v1/images/generations`	OpenAI Images 兼容生图请求，同步等待最多 120 秒。
`POST /v1/images/edits`	OpenAI Images 兼容编辑请求，同步等待最多 120 秒。

示例：

bash

curl https://api.llmapi.site/v1/tasks \
  -H 'Authorization: Bearer YOUR_TASK_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "modality": "image",
    "params": {
      "model": "gpt-image-2",
      "prompt": "a clean studio product photo of a matte black water bottle",
      "n": 1,
      "image_size": "1K",
      "aspect_ratio": "1:1"
    }
  }'

如何选择

需求	应选择
Claude Code、Responses、Chat Completions、Messages	普通 API Key
查询模型列表和用量	普通 API Key
同步 OpenAI 图片生成或编辑	普通 API Key，并选择支持图片的 OpenAI 分组
已有 OpenAI Images 生成或编辑客户端	任务 API Key，可调用 `POST /v1/images/generations` 或 `POST /v1/images/edits`
Gemini 图片生成或多模态生成	普通 API Key，并选择 Gemini 分组
长耗时生产图片或视频任务	任务 API Key
使用 Gemini 或 OpenAI 图片模型执行图片任务	任务 API Key；可为目标模型选择档位，或跟随模型默认档位

常见问题

现象	原因与处理
`/v1/tasks` 返回 `TASK_SCOPE_REQUIRED`	使用了普通 API Key。请创建并使用任务 API Key。
普通模型接口返回 `task_key_only`	使用了任务 API Key。文本和对话接口请使用普通 API Key；任务 Key 只额外支持 `POST /v1/images/generations` 和 `POST /v1/images/edits`。
任务模型不可用	该模型没有启用的默认档位/可用渠道，或模型名不正确。请使用同一个 Key 查询 `GET /v1/tasks/models`。
`params.model must match model`	让 `params.model` 与顶层 `model` 一致，或不传 `params.model`。

创建 API Key ​

创建普通 API Key ​

创建任务 API Key ​

如何选择 ​

常见问题 ​

创建 API Key

创建普通 API Key

创建任务 API Key

如何选择

常见问题