跳到正文
Cheapest Imagen
API 参考

创建图片

根据文字提示词生成一张或多张图片,可以选择模型、尺寸、质量和张数。请求开始时预扣积分,没有交付的图片会退回积分。

POST
/images/generations

根据文字提示词生成一张或多张图片,可以选择模型、尺寸、质量和张数。请求开始时预扣积分,没有交付的图片会退回积分。

Authorization

apiKey
headerAuthorizationBearer <token>

你的 API 密钥,放在请求头里:Authorization: Bearer <密钥>。

Header Parameters

Idempotency-Key?string

你自己定的一个值,最长 255 个字符。重复发送同一个值不会再次生成和扣费,而是返回 409。

Lengthlength <= 255

Request Body

application/json
  1. body
model*string

使用的模型。

Value in"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"
prompt*string

图片内容的描述,最长 32,000 个字符。

Lengthlength <= 32000
n?integer

生成几张。一次请求扣 n 乘以模型积分。1K 最多 10 张,2K 最多 4 张,4K 最多 2 张。

Range1 <= value <= 10
Default1
size?string

auto 由模型自己决定(只有一种分辨率的模型就用那种)。其余是 1K、2K、4K 尺寸;每个模型能用哪些分辨率见 /zh/models 上它的卡片,同一模型各分辨率同价。各尺寸对应的比例见“比例和尺寸”。gpt-image-2-adobe 和 gpt-image-2.5-flare 还能自己填宽高:都是 16 的倍数,单边不超过 3840 像素,长宽比不超过 3:1,总像素 655,360 到 8,294,400。

Default"auto"
Value in"auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"
quality?string

渲染质量。gpt-image-2-adobe 以及 flare、sunburst 版本按档位出图;其他 GPT 模型自己决定质量,Nano Banana 忽略这个参数。xhigh 和 max 只有 gpt-image-2.5-sunburst 支持。所有档位价格相同。

Default"auto"
Value in"auto""low""medium""high""xhigh""max"
background?string

目前没有模型能直接生成透明背景,传 transparent 会返回 400。auto 和 opaque 所有模型都能用。

Default"auto"
Value in"auto""opaque"
output_format?string

返回图片的文件格式。gif 用于 gpt-image-2.6 及其 flare、sunburst 版本,svg 只用于 gpt-image-2.6。png、jpeg、webp 所有模型都能用。

Default"png"
Value in"png""jpeg""webp""gif""svg"
output_compression?integer

jpeg、webp 的质量,0 到 100,默认 100。

Range0 <= value <= 100
moderation?string

对提示词和结果的审核严格程度。low 更宽松。

Default"auto"
Value in"auto""low"
response_format?string

b64_json 在返回里直接带图片数据;url 返回图片链接,保存 72 小时。

Default"b64_json"
Value in"b64_json""url"
async?boolean

设为 true 时请求在后台运行:立刻返回 202 和一个任务,之后用 GET /images/tasks/{id} 取结果。图片以链接返回,所以 response_format 只能是 url 或不填。请求头 Prefer: respond-async 效果相同。

Defaultfalse
webhook_url?string

配合 async 使用:一个 https:// 地址,任务结束时我们向它 POST 一次任务内容(和 GET /images/tasks/{id} 返回的 JSON 相同),最多尝试 3 次。传 webhook_secret 可以让回调带签名;不传的话,收到后请用你的密钥再查一次任务来确认。

Formaturi
webhook_secret?string

配合 webhook_url 使用:你自己定的一个密钥,16 到 128 个字符。回调请求会带上 x-webhook-signature: t=<秒级时间戳>,v1=<十六进制>,其中十六进制串是用这个密钥对 <t>.<请求体> 做 HMAC-SHA256 的结果。

Length16 <= length <= 128

Response Body

生成的图片。

application/json
  1. response
created*integer

生成时间,Unix 时间戳(秒)。

data*array<>
Example Request
curl -X POST 'https://api.cheapestimagen.com/v1/images/generations' \  -H 'Content-Type: application/json' \  -d '{  "model": "gpt-image-2",  "prompt": "a red fox in the snow",  "size": "1536x1024"}'
Example Response
{  "created": 0,  "data": [    {      "b64_json": "string",      "url": "http://example.com"    }  ]}