本文へスキップ
Cheapest Imagen
ガイド

テキストから画像を生成

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_compressionjpeg と 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 を直接生成します。

モデル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 で確認できます。

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 を返し、再生成も再課金も行いません。リクエストが失敗したあとは、同じキーを再利用できます。

このページの内容