テキストから画像を生成
Cheapest Imagen API でテキストのプロンプトから画像を生成します。モデル、サイズ、品質、枚数、出力ファイル形式を指定できます。
プロンプトを 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": "a lighthouse at dusk, oil painting",
"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。gif は gpt-image-2.6 とその flare、sunburst 版。svg は gpt-image-2.6 |
output_compression | jpeg と webp の品質 | 0〜100、デフォルトは 100 |
moderation | コンテンツチェックの厳しさ | auto、low |
response_format | 画像データまたはリンク | b64_json(デフォルト)、url |
現在、背景を透過できるモデルはありません。OpenAI が GPT Image モデルの透過プレビューを取り下げたため、いずれも単色の背景が返ります。background: transparent を指定したリクエストは、コード unsupported_parameter の 400 を返します。切り抜きが必要な場合は、プロンプトで無地の単色背景を指定し、あとから背景を除去してください。
出力形式
PNG、JPEG、WebP は、OpenAI の API と同様に、すべてのモデルで使えます。多くのモデルは PNG を生成し、指定された JPEG または WebP への変換は Cloudflare のネットワーク内で行います(約 0.1〜0.4 秒。2 MB の PNG は約 250 KB の JPEG または WebP になります)。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 で確認できます。
1 回のリクエストで使うクレジット
1 回のリクエストでは、モデルのクレジットの n 倍が使われます。GPT Image 2、2.5、2.6 は 1 枚 8、Nano Banana 2 と 2.1 は 12、Nano Banana Pro、gpt-image-2-adobe、flare 版は 20、sunburst 版は 25、Nano Banana の stable チャンネルは 60〜180 です。依頼した枚数より少ない枚数が返った場合は、受け取った画像の分だけお支払いいただきます。
同じリクエストを 2 回送る場合
任意の値を指定した Idempotency-Key ヘッダーを付けます。最初のリクエストの実行中、または成功後に同じキーが届いた場合、API は 409 を返し、再生成も再課金も行いません。リクエストが失敗したあとは、同じキーを再利用できます。