リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | Describe the image you want. |
resolution | いいえ | 出力サイズ。大きいほど鮮明で、料金も上がります。 0.5k · 1k · 2k · 4k · デフォルト: 1k |
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 · デフォルト: 16:9 |
enable_web_search | いいえ | 日付・場所・最新情報を先にウェブで調べます。 デフォルト: false |
enable_image_search | いいえ | 場所や商品の実物の画像を先に調べます。 デフォルト: false |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /枚 | ≈ USD |
|---|---|---|
| resolution 0.5K | 5.4 | $0.054 |
| resolution 1K | 8.04 | $0.08 |
| resolution 2K | 12.12 | $0.12 |
| resolution 4K | 18.12 | $0.18 |
タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 6クレジット/枚($0.06)です。
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Nano Banana 2 API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を google/nano-banana-2/text-to-image、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "16:9",
"resolution": "1k"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Nano Banana 2 API についての質問
Nano Banana 2 API の料金はいくらですか?
Nano Banana 2の最安は画像を作成で、6クレジット($0.06)/枚からです。オプション別の料金:0.5K 5.4クレジット/枚、1K 8.04クレジット/枚、2K 12.12クレジット/枚、4K 18.12クレジット/枚。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのNano Banana 2のモデル名は?
POST /jobs/createTask の model フィールドに 画像を作成は google/nano-banana-2/text-to-image;画像を編集は google/nano-banana-2/edit を指定します。
画像の大きさはどれくらいですか?
正方形で 0.5k は 512 ピクセル、1k は 1024、2k は 2048、4k は 4096 ピクセルです。ほかの比率もほぼ同じ画素数を保ち、私たちの 2k の 4:1 バナーは幅 4128 ピクセルで返ってきました。
Nano Banana 2 API の制限は?
解像度:0.5K · 1K · 2K · 4K;アスペクト比:1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 +8;プロンプトの長さ(文字):5,000。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにNano Banana 2を試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでNano Banana 2を実行でき、実行ごとに対応するコードが表示されます。

