GPT-Image-2 图片 API

GPT-Image-2 支持同步文生图、同步图片编辑和异步图片任务。同步接口适合直接等待结果，异步接口适合长耗时任务、批量提交，以及通过轮询或 Webhook 获取结果。

同步生成与编辑/v1/images/*

异步任务与回调/v1/image/tasks

编辑输入文件、URL、Base64最多 10 张参考图

支持的模型

渠道	模型名称	主要能力
Azure	gpt-image-2	图片生成与编辑，支持符合官方约束的灵活自定义分辨率
Adobe	adobe-gpt-image-2-count	图片生成与编辑
GPT 逆向	gpt-image-2-count	图片生成与编辑

模型以实际列表为准

模型名称、可用渠道和参数范围可能调整。调用前请以控制台模型广场和 GET /v1/models 返回结果为准，不要假定所有账号都同时拥有上表中的模型。

gpt-image-2 的 size 不再局限于少数预设画幅。完整边长、比例和总像素约束见参数与错误：自定义分辨率。带 -count 的模型使用各自渠道的尺寸范围，不要直接套用官方通道规则。

查询当前 Token 可用的 GPT-Image-2 模型：

curl -sS "$SUPERTOKEN_BASE_URL/v1/models" \
  -H "Authorization: Bearer $SUPERTOKEN_KEY" |
jq '.data[] | select(.id | contains("gpt-image-2"))'

按场景阅读

SYNC API同步生成与编辑文生图、本地多图、公开 URL、Base64 和 Mask 编辑。/v1/images/generations · /v1/images/editsASYNC API异步任务创建、查询、列表、批量查询和图片预上传。/v1/image/tasks · /v1/image/uploadsEVENTSWebhook账号级完成通知、事件结构、校验、去重和重试。image.task.succeeded · image.task.failedRESOURCES资源管理中心查看任务结果、生成资源 API Key，并查询或导出生成资源。资源列表 · ak_... · /v1/assetsRUNNABLE DEMOSPython 与 Node.js同步、异步、轮询和 Webhook 接收的完整程序。Python 3.10+ · Node.js 20+REFERENCE参数与错误同步与异步字段映射、上传限制、状态和常见错误。fields · limits · errors

端点速览

场景	方法与路径	使用的密钥	详细文档
同步文生图	POST /v1/images/generations	模型 API Token，sk-...	同步调用
同步图片编辑	POST /v1/images/edits	模型 API Token，sk-...	同步调用
创建异步任务	POST /v1/image/tasks	模型 API Token，sk-...	异步任务
查询异步任务	GET /v1/image/tasks/{task_id}	资源 API Key，ak_...	异步任务
列出异步任务	GET /v1/image/tasks	资源 API Key，ak_...	异步任务
批量查询任务	POST /v1/image/tasks/query	资源 API Key，ak_...	异步任务
预上传图片	POST /v1/image/uploads	资源 API Key，ak_...	异步任务
查询生成资源	GET /v1/assets	资源 API Key，ak_...	资源管理中心
异步完成通知	账号级 Webhook	接收端校验 wk-...	Webhook

开始之前

后续文档统一使用这些环境变量：

export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export SUPERTOKEN_KEY="YOUR_MODEL_API_TOKEN"
export RESOURCE_API_KEY="YOUR_RESOURCE_API_KEY"
export IMAGE_MODEL="gpt-image-2"

IMAGE_MODEL 可替换为当前账号实际可用的模型，例如 adobe-gpt-image-2-count 或 gpt-image-2-count。

不要混用密钥

创建同步请求和异步任务使用普通模型 API Token；查询任务和预上传使用资源 API Key；Webhook Key 只用于接收端验证通知来源，不能调用 API。

最小同步示例

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 .

完整请求请继续阅读同步生成与编辑，或直接运行 Python 与 Node.js Demo。字段范围、上传限制和错误处理见参数与错误。

下一步

• 同步生成与编辑
• 异步任务
• 资源管理中心
• Webhook 完成通知
• Python 与 Node.js 代码示例