本文へスキップ
Cheapest Imagen
API リファレンス

画像を作成

テキストのプロンプトから 1 枚以上の画像を作成します。クレジットはリクエスト開始時に確保され、提供されなかった画像の分はすべて返却されます。

POST
/images/generations

テキストのプロンプトから 1 枚以上の画像を作成します。クレジットはリクエスト開始時に確保され、提供されなかった画像の分はすべて返却されます。

Authorization

apiKey
headerAuthorizationBearer <token>

API キー。Authorization: Bearer <key> として送信します。

Header Parameters

Idempotency-Key?string

任意の値(255 文字まで)。同じ値を再送しても、2 つ目のリクエストは作成も課金もされず、代わりに 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

生成する画像の枚数。1 回のリクエストで、モデルのクレジットの n 倍が使われます。最大で、1K は 10 枚、2K は 4 枚、4K は 2 枚です。

Range1 <= value <= 10
Default1
size?string

auto はモデルが選びます(解像度が 1 つのモデルでは、その解像度)。そのほかの値は 1K、2K、4K のサイズで、各モデルは /ja/models のカードに記載された解像度を、同一料金で受け付けます。各比率のサイズは、サイズのガイドを参照してください。gpt-image-2-adobe と gpt-image-2.5-flare は、幅と高さの自由な指定にも対応します。16 の倍数で、1 辺は 3840 px まで、縦横比は 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 と併用:完了したタスク(GET /images/tasks/{id} と同じ JSON)を 1 回 POST する https:// のアドレス。最大 3 回試行します。呼び出しに署名を付けるには webhook_secret を送ります。指定しない場合は、受信した内容を、ご自身のキーでタスクを取得して確認してください。

Formaturi
webhook_secret?string

webhook_url と併用:ご自身の秘密の値(16〜128 文字)。指定すると、アドレスへの呼び出しに x-webhook-signature: t=<unix seconds>,v1=<hex> が付きます。hex は、この秘密の値で計算した <t>.<body> の 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"    }  ]}