文生图
用 Cheapest Imagen API 做文生图:把提示词发到 /v1/images/generations,并选择模型、尺寸、质量、张数和输出文件格式。
把提示词发到 POST /v1/images/generations。只有 model 和 prompt 是必填的。
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "黄昏的灯塔,油画风格",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'可选参数
| 字段 | 作用 | 取值 |
|---|---|---|
n | 生成几张 | 1 到 10,默认 1 |
size | 宽和高 | auto 或 1K、2K、4K 尺寸,见比例和尺寸 |
quality | 渲染质量,各档同价 | auto、low、medium、high;gpt-image-2.5-sunburst 另有 xhigh、max |
background | 透明或不透明背景 | auto、opaque、transparent |
output_format | 文件格式 | 所有模型都可用 png(默认)、jpeg、webp;gpt-image-2.6 及其 flare、sunburst 版本可用 gif;gpt-image-2.6 可用 svg |
output_compression | jpeg、webp 的质量 | 0 到 100,默认 100 |
moderation | 内容审核的严格程度 | auto、low |
response_format | 返回图片数据还是链接 | b64_json(默认)、url |
目前没有模型能直接生成透明背景:OpenAI 已撤下 GPT Image 模型的透明背景预览,现在只会返回带底色的图。请求里带 background: transparent 会返回 400,代码为 unsupported_parameter。需要抠图的话,可以在提示词里要求纯色背景,拿到图后再去掉背景。
输出格式
和 OpenAI 官方 API 一样,所有模型都能输出 PNG、JPEG、WebP。大部分模型出的是 PNG,我们在 Cloudflare 网络内把它转成你要的 JPEG 或 WebP(约 0.1 到 0.4 秒;2 MB 的 PNG 转完约 250 KB)。gpt-image-2.6-flare 和 gpt-image-2.6-sunburst 自己就能出 JPEG 和 WebP。
| 模型 | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2、gpt-image-2.5、gpt-image-2-adobe | 支持 | 支持 | 支持 | – | – |
gpt-image-2.6 | 支持 | 支持 | 支持 | 支持 | 支持 |
gpt-image-2.5-flare、gpt-image-2.5-sunburst | 支持 | 支持 | 支持 | – | – |
gpt-image-2.6-flare、gpt-image-2.6-sunburst | 支持 | 支持 | 支持 | 支持 | – |
| Nano Banana(所有版本) | 支持 | 支持 | 支持 | – | – |
“–”会返回 400。output_compression 在所有模型上都用来设 JPEG、WebP 的质量(默认 100)。GIF 可能要 3 到 5 分钟。文件的真实类型看链接的扩展名和 Content-Type。
一次请求扣多少点
一次请求扣 n 乘以模型积分:GPT Image 2、2.5、2.6 每张 8 积分,Nano Banana 2 和 2.1 每张 12 积分,Nano Banana Pro、gpt-image-2-adobe 以及 flare 版本每张 20 积分,sunburst 版本每张 25 积分,Nano Banana 稳定通道每张 60 到 180 积分。如果实际返回的张数比你要的少,只按收到的张数扣。
同一个请求发了两次
加一个请求头 Idempotency-Key,值由你自己定。第一个请求还在进行或已经成功时,再用同一个值请求会返回 409,不会再次生成和扣费。请求失败后,这个值可以重新使用。