OpenAI 兼容 API 手册

GPT-Image-2 图像生成

使用 gpt-image-2 创建文生图或参考图生成任务。接口采用 Bearer Token 鉴权，返回异步任务对象；前端只展示最终单价和本次请求的积分预估。

POST /v1/images/generations

Images

curl https://api09.com/v1/images/generations   -H "Authorization: Bearer sk-api09_xxx"   -H "Content-Type: application/json"   -d '{"model":"gpt-image-2","prompt":"未来城市夜景海报，霓虹灯，电影感构图","n":1,"size":"1:1","resolution":"1K","response_format":"url"}'

请求字段

字段	类型	说明
model	string	固定为 gpt-image-2。
prompt	string	必填，最长 32,000 字符。
size	string	默认 1:1；支持 3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21。
resolution	string	1K / 2K / 4K；当前预估分别约 4 / 10 / 18 积分。
n	integer	默认 1，生成数量会影响最终费用。
response_format	string	推荐 url。
reference_images / image_urls	string[]	可选；Nano Banana 支持公网 URL 或 data:image/...;base64。其他模型建议先调用上传接口换取 URL。

响应与计费

字段	类型	说明
id	string	异步任务 ID。
object	string	generation.task。
model	string	gpt-image-2。
status	string	queued / in_progress / completed / failed。
progress	integer	0-100。
creditsEstimate	number	api09 在提交前计算的本次任务预估积分。
result.data[].url	string	任务完成后的图片 URL。

积分统一换算：1 USD = 200 积分。

生产检查

参考图必须可被上游访问

任务提交前确认预估积分

结果 URL 应及时下载保存

失败响应不会扣除成功任务费用

上传图片查询图片任务