快速开始

本页说明调用 LLMAPI 网关所需的最小信息。所有示例默认使用：

https://api.llmapi.site

基础信息

项目	值
API Base URL	https://api.llmapi.site
推荐认证	Authorization: Bearer YOUR_API_KEY
请求格式	application/json，OpenAI 图片编辑可使用 multipart/form-data
流式响应	按具体接口支持 SSE 或 WebSocket

认证示例

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

也兼容 x-api-key 和 x-goog-api-key 请求头。新接入请使用 Bearer Token。

先创建合适的 API Key

控制台中有两类 API Key：

类型	适合场景
普通 API Key	文本接口、模型列表、用量查询、同步 OpenAI 图片接口。
任务 API Key	通过 /v1/tasks 提交图片、视频等长耗时媒体任务，并查询任务、取消排队任务、监听 SSE、下载结果资产；也可用于 OpenAI Images 兼容同步接口。

如果要调用任务 API，请创建任务 API Key。Key 可以为不同模型分别选择 任务档位；未显式选择的模型使用该模型默认档位。普通 API Key 不能提交任务 API，任务 API Key 也不能调用普通模型接口；同步图片例外是 POST /v1/images/generations 和 POST /v1/images/edits。

模型档位属于 API Key 配置，请求中不需要增加档位参数，也不需要为不同档位修改模型名。使用任务 API Key 调用 GET /v1/tasks/models，可以读取每个模型最终生效的价格和约束。如果某个选择失效，该模型回到自己的默认档位，其他模型不受影响。

详细步骤见 创建 API Key。

如何选择接口

场景	推荐接口	说明
Claude Code、Anthropic Messages 协议	POST /v1/messages	按 API Key 所属分组进入对应平台链路。
OpenAI Responses 协议	POST /v1/responses	支持 Responses API 兼容请求。
OpenAI Chat Completions 协议	POST /v1/chat/completions	适合通用 OpenAI 兼容客户端。
查询可用模型	GET /v1/models	返回当前 Key 所属分组可用模型。
查询余额、额度和用量	GET /v1/usage	返回当前 Key 的额度模式和统计数据。
OpenAI 同步生图	POST /v1/images/generations	普通 API Key 需绑定 OpenAI 分组；任务 API Key 使用任务 API 的模型和价格配置，并同步等待结果。
OpenAI 同步编辑图片	POST /v1/images/edits	支持 multipart 上传和 JSON 图片 URL；任务 API Key 使用任务 API 的模型和价格配置。
Gemini 原生图片与多模态调用	POST /v1beta/models/{model}:generateContent	需要普通 API Key 绑定 Gemini 分组。
长耗时媒体任务	POST /v1/tasks	需要任务 API Key，当前支持图片和已配置渠道的视频模型。

最小调用示例

Messages

curl https://api.llmapi.site/v1/messages \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 512,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Responses

curl https://api.llmapi.site/v1/responses \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-5.1",
    "input": "Write a short product description."
  }'

Chat Completions

curl https://api.llmapi.site/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-5.1",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

媒体任务

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"
    }
  }'

接入注意事项

• API Key 的绑定类型决定可访问的接口。
• 同步 OpenAI 图片接口通常需要普通 API Key 绑定 OpenAI 分组；任务 API Key 可以使用 POST /v1/images/generations 和 POST /v1/images/edits，请求体保持 OpenAI Images 兼容格式。
• Gemini 生图使用 Gemini Native，需要普通 API Key 绑定 Gemini 分组。
• 图片、视频等长耗时媒体任务应使用 任务 API 和任务 API Key。
• POST /v1/messages/count_tokens 不支持 OpenAI 平台分组。