快速开始
本页说明调用 LLMAPI 网关所需的最小信息。所有示例默认使用:
text
https://llmapi.site基础信息
| 项目 | 值 |
|---|---|
| API Base URL | https://llmapi.site |
| 推荐认证 | Authorization: Bearer YOUR_API_KEY |
| 请求格式 | application/json,图片编辑可使用 multipart/form-data |
| 流式响应 | 按具体接口支持 SSE 或 WebSocket |
认证示例
bash
curl https://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 | 文本接口、模型列表、用量查询、Gemini native 路径、同步 OpenAI 图片接口。 |
| 生图 API Key | 异步生图任务 /v1/images/tasks 及任务查询、取消、事件监听。 |
如果要调用异步生图,请创建绑定 批量生图分组 的生图 API Key。普通 API Key 不能提交异步生图任务。
详细步骤见 创建 API Key。
如何选择接口
| 场景 | 推荐接口 | 说明 |
|---|---|---|
| Claude Code、Anthropic Messages 协议 | POST /v1/messages | 按 API Key 所属分组进入对应平台链路。 |
| Codex CLI、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 分组,适合短耗时请求。 |
| 异步生图 | POST /v1/images/tasks | 需要生图 API Key 绑定批量生图分组,适合生产环境长耗时任务。 |
| Gemini native 客户端 | /v1beta/models... | 需要 Gemini 平台分组。 |
最小调用示例
Messages
bash
curl https://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
bash
curl https://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
bash
curl https://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" }
]
}'异步生图
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
}'接入注意事项
- API Key 所属分组决定可用平台和端点能力。
- 同步 OpenAI 图片接口只支持 OpenAI 平台分组;异步生图必须使用绑定批量生图分组的生图 API Key。
- Gemini 异步生图请使用官方模型名,例如
gemini-2.5-flash-image、gemini-3.1-flash-image。 - Gemini native 路径要求 Gemini 平台分组。
POST /v1/messages/count_tokens不支持 OpenAI 平台分组。- 长耗时生图建议使用异步任务接口,而不是在同步请求中等待。