跳到正文
Cheapest Imagen
指南

文生图

用 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_compressionjpeg、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。

模型PNGJPEGWebPGIFSVG
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,不会再次生成和扣费。请求失败后,这个值可以重新使用。

本页内容