はじめに
Nano Banana Pro 画像編集は、Google の Gemini 3 Pro Image を手元の画像に適用します。1〜14 枚の元画像を受け付け、描く前に編集を計画し、元画像の比率か 10 種類の比率のいずれかで 1k、2k、4k を返します。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章のブリーフ | Nano Banana Pro テキストから画像 |
| 変更したい画像 | Nano Banana Pro 画像編集 |
主な機能とハイライト
変更点が 1 つの正確な編集
新しい光、新しい背景、文字の追加を、人物と画像のほかの部分はそのままに行えます。私たちのキャンドルと表紙の例のとおりです。モデルは描く前に編集を計画するので、関係のない部分が安定して保たれます。
写真への文字入れ
誌名、号数、キャプションを、引用した綴りのまま、指定した位置に画像へ重ねます。
最大 14 枚の参考画像
多くの元画像から人物、商品、場所を組み合わせ、それぞれの役割をプロンプトに書いて、1 回の編集リクエストにまとめます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字です。被写体、場所、光、レンズを文章で書いてください。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 元画像は 1〜14 枚です。それぞれが何を担うか（人物、場所、商品）をプロンプトに書いてください。 1 件以上 · 14 件以内 |
aspect_ratio | いいえ | auto（既定）は元画像の比率を保ちます。21:9 から 9:16 までの 10 種類から選ぶこともできます。 |
resolution | いいえ | 1k（既定）、2k、4k のいずれかです。1k と 2k は同じ料金で、4k は高くなり長辺 4096 ピクセルで生成します。 |
official_fallback | いいえ | 既定でオンです。各編集はまず経済ルートで実行されます。 デフォルト値: |
料金
サイズ段階ごとの 1 枚単位の課金です。編集はまずエコノミールートにエコノミー価格で送られ、元画像ごとの料金はかかりません。Official fallback（既定はオン）が有効なら、エコノミールートが拒否した編集や完了できなかった編集、元画像が 8 枚を超える編集は公式ルート（公式価格）で実行され、元画像 1 枚ごとの少額の固定料金も加わります。オフにすればエコノミー価格だけで済みます。見積もりには開始価格とその編集の上限額が表示されます。拒否されたリクエストは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.0668 / 枚 (Official fallback 使用時：最大 $0.1072) |
| $0.0668 / 枚 (Official fallback 使用時：最大 $0.1072) |
| $0.118 / 枚 (Official fallback 使用時：最大 $0.192) |
ユースケース
写真を表紙やポスターに
承認済みの写真に、レタッチせずに誌名、日付、コピーの 1 行を加えます。
ムードと光のバリエーション
方向性を選んでいるクライアントに、同じ場面をキャンドル、夜明け、ネオンの光で見せます。
各国語版のキャンペーン画像
完成したポスターの文字を市場ごとに翻訳した 1 行へ差し替え、写真とその光はそのまま残します。
プロンプトガイドと実践のヒント
1 回に 1 つずつ変える
変更点が 1 つの指示ならほかのすべてが安定します。1 つのプロンプトにまとめるより、編集をつなげてください。
人物を守る
変更点のあとに、まったく同じにしておく人物、服、ポーズを名指ししてください。
編集の時間を見込む
このモデルでは編集はテキストから画像より時間がかかります。私たちのテストでは公式ルートの 2k で最大約 3 分かかり、エコノミールートの 1k の編集は 1 分以内に終わりました。
文字は位置と一緒に引用する
追加する文字は各行を引用し、置く場所（上部に大きく、左下、ロゴの横）を書いてください。
既定は 2k で
このモデルでは 1k と 2k が同じ料金なので、軽いファイルが必要でない限り 2k で編集してください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-pro/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
