图片生成
SuperToken 图片 API 支持同步生成、同步编辑和异步任务。你可以使用本地文件、公开 URL 或 Base64 作为编辑输入，并通过轮询或 Webhook 获取异步结果。
01选择模型查询当前 Token 的可用模型
02选择模式同步响应或异步任务
03提交请求文生图或多图编辑
04获取结果直接返回、轮询或 Webhook
选择文档
API GUIDEGPT-Image-2按模型、同步端点、异步任务、Webhook 和代码 Demo 分级阅读。
/v1/images/* · /v1/image/tasksRUNNABLE DEMOS代码示例可直接运行的 Python 与 Node.js 完整示例。Python · Node.jsGEMINI IMAGESGemini 统一图片 API同步、异步、编辑、资源中心、Webhook 与统一 usage。/v1/images/* · /v1/image/tasksGEMINI NATIVEGemini 原生与 Chat保留 generateContent 和 OpenAI Chat Base64 接入。generateContent · chat/completionsLEGACYGPT-Image-2 旧版保留旧路径和历史接入方式，已有项目可继续查阅。/image-wrapper/v1/images/*接口速览
| 场景 | 接口 | 响应方式 | 鉴权 |
|---|---|---|---|
| 同步文生图 | POST /v1/images/generations | 请求完成后返回 data[] | 模型 API Token，sk-... |
| 同步图片编辑 | POST /v1/images/edits | 请求完成后返回 data[] | 模型 API Token，sk-... |
| 创建异步任务 | POST /v1/image/tasks | 202 Accepted 和任务对象 | 模型 API Token，sk-... |
| 查询异步任务 | GET /v1/image/tasks/{task_id} | 返回最新任务状态和结果 | 资源 API Key，ak_... |
| 异步完成通知 | 账号级 Webhook | 主动发送成功或失败事件 | 接收端校验 Webhook Key，wk-... |
模型与渠道
| 渠道 | 模型名称 | 文档 |
|---|---|---|
| Azure | gpt-image-2 | GPT-Image-2 |
| Adobe | adobe-gpt-image-2-count | GPT-Image-2 |
| GPT 逆向 | gpt-image-2-count | GPT-Image-2 |
| Gemini | gemini-3.1-flash-image | Gemini Images |
| Gemini | gemini-3-pro-image-count | Gemini Images |
模型以实际列表为准
模型名称、渠道和参数范围可能调整。调用前请以控制台模型广场和 GET /v1/models 返回结果为准。
选择同步还是异步
| 需求 | 推荐方式 |
|---|---|
| 单次调用，希望立即拿到图片 | 同步 Images API |
| 本地文件或少量 URL 图片编辑 | 同步 Edits API |
| 后台任务、批量处理或生成耗时较长 | 异步任务 API |
| 不希望持续轮询任务状态 | 异步任务 + Webhook |
| 需要可靠补偿 | Webhook 通知 + 任务查询兜底 |
快速开始
bash
export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export SUPERTOKEN_KEY="YOUR_MODEL_API_TOKEN"
export IMAGE_MODEL="gpt-image-2"
curl -sS "$SUPERTOKEN_BASE_URL/v1/images/generations" \
-H "Authorization: Bearer $SUPERTOKEN_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$IMAGE_MODEL"'",
"prompt": "极简产品摄影，一只透明玻璃杯放在黑色石材桌面上",
"n": 1,
"size": "1024x1024",
"quality": "low",
"output_format": "png"
}' | jq .