クイックスタート
Cheapest Imagen API で最初の AI 画像を 3 ステップで生成します。キーを作成し、リクエストを 1 回送って、レスポンスから画像を読み取ります。
この API のリクエストとレスポンスは、OpenAI Images API と同じです。すでに OpenAI を呼び出している場合は、ベース URL とキーを変えるだけで、残りのコードはそのまま使えます。
1. API キーを取得する
ログインして、API キーのページでキーを作成します。新規アカウントには無料の 5 枚が付き、API からも使えます。対象は GPT Image 2、2.5、2.6 の 1K で、1 リクエストにつき 1 枚です。それ以外のモデルを使うには、先にチャージしてください。キーは sk-cheap- で始まり、表示されるのは 1 回だけなので、作成したときにコピーしてください。
2. リクエストを送る
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 red fox in the snow",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="a red fox in the snow",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: 'a red fox in the snow',
size: '1536x1024',
});3. 画像を読み取る
レスポンスには、画像 1 枚につき 1 つのエントリが入っています。デフォルトでは、各エントリに Base64 形式の画像が b64_json として含まれます。
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}"response_format": "url" を送ると、代わりにリンクが返ります。リンク先の画像は 72 時間保存されます。
同期と非同期
上のリクエストは同期です。画像が完成した時点でレスポンスが返ります。リクエストに時間がかかる場合や、多数をまとめて送る場合は、非同期を使います。"async": true を付けるとタスク ID がすぐに返るので、タスクをポーリングするか、webhook_url を付けて完了時に通知を受け取ります。どちらの方法でも料金は同じです。ポーリング、複数タスクの一括取得、Webhook については、同期リクエストと非同期リクエストをご覧ください。
料金
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 チャンネル(-1k、-2k、-4k)は 60〜180 クレジットです。サイズや品質によって料金は変わりません(1 クレジットは $0.001〜約 $0.0018、詳しくは 料金ページ)。失敗したリクエストに料金はかかりません。クレジットはリクエスト開始時に確保され、提供されなかった画像の分はすべて返却されます。唯一の例外は Nano Banana の stable チャンネル(-1k、-2k、-4k)で、コンテンツを理由に拒否された画像も課金されます。