返回模型指南
OpenAIimage/v1/images/generations

GPT-Image-2 API 指南

面向生产图像生成和参考图编辑的 OpenAI 图像模型,适合商品图、广告视觉、海报和带文字画面。

文生图
参考图生成
清晰文字渲染
异步任务
1K / 2K / 4K 档位

入口

/v1/images/generations

类型

image

汇率

1 USD = 200 积分

curl https://api09.com/v1/v1/images/generations \
  -H "Authorization: Bearer sk-api09_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张黑色钛金属智能手表的产品海报,玻璃反光,顶部留出品牌标题空间,写实摄影棚灯光。",
    "resolution": "1K",
    "size": "1:1",
    "response_format": "url"
  }'

在线体验预览

GPT-Image-2 Mission Panel

登录后真实调用

Route

Cost

Task

gpt-image-2预计 4 积分

参数表

字段类型必填默认值可选值说明
modelstringgpt-image-2gpt-image-2固定模型标识。
promptstring-自然语言描述主提示词,建议写清主体、风格、构图和限制。
resolutionstring1K1K | 2K | 4K分辨率档位会影响价格和支持的比例。
sizestring1:11:1 | 3:2 | 2:3 | 16:9 | 9:16 | 21:9需与 resolution 的可用比例匹配。
reference_imagesstring[][]公网 URL 或 image data URI 数组Nano Banana 支持 data:image/...;base64 内联;也可先上传后传 URL。
response_formatstringurlurl | b64_json生产环境建议使用 URL 并记录任务 ID。

价格口径

1K 图片

按张计费,提交前显示预估积分

$0.0165

4 积分

2K 图片

按张计费,分辨率会影响预估积分

$0.0495

10 积分

4K 图片

按张计费,分辨率会影响预估积分

$0.088

18 积分

常见错误

400 invalid_request_error

缺少 prompt,或 size 与 resolution 组合不合法。

在提交前做参数表校验,图片比例按分辨率档位过滤。

400 invalid_reference_images

传入非法 data URI、本地路径、无法访问或不是图片的 URL。

使用 image data URI,或先调用上传接口换取公网 URL。

401 authentication_error

API Key 缺失、失效或权限不含图片端点。

检查 Authorization: Bearer sk-api09_xxx 和模型权限。

429 rate_limit_exceeded

并发、频率或额度触发限流。

使用 1s/2s/4s 指数退避,并在控制台调低并发。

接入路径

  1. 1. 在控制台创建 API Key,并设置模型权限和每日预算。
  2. 2. 将 SDK base URL 改成 https://api09.com/v1
  3. 3. 使用在线体验确认 prompt、参数、成本和错误处理。
  4. 4. 上线后查看使用日志、任务日志和余额 ledger。