はじめに
番号付きの元画像とともに、変更したい部分と残す細部を説明する指示を送ります。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| 公開元・モデル名 | Google の Gemini 3.1 Flash Lite Image です。 |
| 利用できる処理 | 文章からの画像生成と画像を基にした編集です。 |
| 出力サイズの段階 | 1K、概算で 100 万画素です。 |
| prompt の容量 | 最大 20,000 文字です。 |
| 固定のアスペクト比 | 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、1:4、4:1、1:8、8:1 |
| 生成時の既定比率 | 1:1 |
| 編集の比率選択 | 14 種類の固定比率に加えて auto を使えます。 |
| 編集入力の範囲 | 1–10 枚で、Image 1、Image 2 以降と呼び分けます。 |
| 画像の料金 | 1 枚ごとの固定価格で、失敗したリクエストは無料です。 |
| コンテンツのフィルター | 公開元が独自のフィルターを適用し、検出された依頼は拒否され課金されません。 |
| 保存される期間 | 14 日間の後に生成ファイルを削除します。 |
主な機能とハイライト
ポーズが変わっても同じカップル
1:4 の生成では、笑い、キス、楽しげにネクタイを引く姿、額を合わせる姿を白黒の 4 コマにしました。カップルは一貫していました。瞬間を意図する順序で記し、設定でも細い比率を選びます。出力は内部に 4 コマを含む 1 枚の画像です。この並びの実例で、あらゆる人物や配置を保証しません。
車両の中の読書コーナー
列車の例は、居心地の良い室内と外の雨の対比から始め、テストで車内の読書コーナーができました。具体的な家具と光の指示を使い、窓や席を収める比率を選びます。1K で構図を検討してから、より大きな版が必要かを決められます。
緑の植物を囲む冬の光
晴れた温室がテストで冬の朝に変わりました。ガラスに霜、光に冷たさが加わり、室内の植物は緑でした。この対比は確認しやすく、ガラスと光を比べてから植物を別に調べられます。温室を Image 1 と呼び、保持を暗黙にせず季節変更と残す部分を両方示します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 変更内容を 20,000 文字以内で説明し、入力を Image 1、Image 2 などで参照します。文字数によって固定単価は変わりません。 1 文字以上 · 20000 文字以内 |
image_urls | はい | 編集の手がかりとなる元画像の URL を 1〜10 件送ります。この処理の料金は元画像数ではなく、生成された画像ごとにかかります。 1 件以上 · 10 件以内 |
aspect_ratio | いいえ | 元画像に合わせる auto、または 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、1:4、4:1、1:8、8:1 を選べます。形の選択で Lite の料金は変わりません。 |
料金
$0.027 / 枚
Lite の画像編集は、生成画像 1 枚あたりの固定料金です。比率や元画像の枚数には左右されず、失敗した編集は請求されません。
ユースケース
写真ストリップで物語を作る
細長い 1:4 にカップルの 4 つの瞬間を配置します。白黒の写真ブースの結果では、ポーズが変わっても同じ 2 人と分かる状態を保ちました。
室内の雰囲気を研究
部屋の案を発展させる前に、雨の外景と暖かな光の対比を試せます。列車のテストでは車内の読書コーナーができました。
場所の季節を変える
室内で残すものを示し、冬の雰囲気を求めます。温室の編集はガラスの霜と冷たい光を加え、植物の緑は維持しました。
特殊な配置のための画面
細長い画像やパノラマが必要なら 1:8、8:1 などを使います。構図は変わりますが、大きな解像度段階が加わるわけではありません。
番号付き参照を使う説明
既存素材の編集には 1–10 枚を使えます。各画像の役割を説明し、出力の細部をそれぞれと比較します。
プロンプトガイドと実践のヒント
出発点を選びます
言葉で作る場面は text-to-image、修正したい写真は image-to-image を開きます。人物は使用権のある成人の写真にし、なりすましをしないでください。
場面の方向を明確に
場所、光、見える動作を指定します。編集では Image 1、Image 2 以降に各入力を対応させ、変更したい部分と残す細部を分けます。
画面の縦横比を指定
生成では縦の写真ストリップの 1:4 など固定比率を選びます。編集なら元の比率に従う auto も使え、どれも 1K のままです。
点検してダウンロード
顔、物、構図を説明と比較してから採用します。14 日以内にファイルを保存し、使用した prompt と設定も残します。
文章の指示で写真を修正
Nano Banana 2 Lite image-to-image は既存の視覚素材と修正内容の prompt を使います。1–10 枚を番号で呼び、変える部分と残す部分を説明します。出力は約 100 万画素の 1K のままです。残したい細部のある場所や光の限定的な研究に向いています。
温室の例は、晴れた場所を冬の朝にし、ガラスに霜、光に冷たさを加え、室内植物の緑を残しました。観察した編集の根拠で、指定以外の全領域が同一という約束ではありません。
修正に使うパラメータ
| パラメータ | 入力 | 使い方 |
|---|---|---|
| prompt | 最大 20,000 文字 | 番号付き元画像、変更、保持を記述します |
image_urls | 元画像 URL を 1–10 個 | Image 1、Image 2 以降を入力順に合わせます |
aspect_ratio | auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 | 元の比率なら auto、または固定形を選びます |
編集は生成の 14 比率に auto を加えます。元の形に従うことが重要なら意図して選びます。複数入力の比率がすべて同じと考えず、配置先の指定があれば固定比率にします。どの比率も出力段階を増やしません。
参照の役割を読み取れる説明に
入力と目的を結びます
Image 1 の温室を使う、として冬の雰囲気を続ければ、画像番号で見る場所を伝えられます。追加が必要なら Image 2 以降の貢献を書き、送信前に image_urls の順と照合します。
最大 10 枚という容量は複雑な参照群の一貫性の約束ではありません。Google は複数参照や複数ターンの連続編集に最適化していないとしています。温室は限定的な季節変更で、長い修正連鎖の信頼性は確認していません。
変更と保持を分けます
ガラスに霜を加えて日光を冷たくし、室内の植物は緑に保つ、と別々に書きます。構造物や物も重要なものを指定し、出力後に元と比較します。
サンプルが支えるのは霜、冷たい光、緑の植物です。通路や植栽配置の保持も依頼できますが、要求を実測結果と見なさず点検します。一般的な高品質の繰り返しより、見える要件に文章を使ってください。
許可のある人物写真を扱います
使用権のある成人の写真を使い、なりすましをしないでください。新しい肖像の説明は 30 代以上として、服装、表情、光、周囲を記述します。同一性の要件を明確にし、使用前に返された顔を許可のある元画像と比べます。
光の研究なら、Image 1 の許可された 40 代女性を使い、青い背景に暖かなスタジオ光を加え、紺のジャケットと座るポーズを保つ、と書けます。指示パターンの提案で、検証済み肖像の結果はありません。
元画像と編集を照合
温室は次の確認の例になります。
- ガラスと日光を比べ、季節の雰囲気が加わったか見ます。
- 室内の植物に、残したい緑があるか調べます。
- 構図と周囲を確認して適否を判断します。
- 元画像、指示、比率、採用出力をまとめて保存します。
次の修正では残る問題を直接示します。季節、家具、カメラ、スタイルを同時に変える依頼より評価しやすくなります。長い編集履歴や編集の所要時間は測定していません。
課金と運用制限
出力画像ごとの固定価格で、比率は課金額を変えず、失敗は無料です。モデルページ の最新価格を使い、ガイドに転記した額に頼らず見積もります。
公開元のフィルターで検出した依頼は拒否され、課金されません。新規生成と同じ受理条件を修正にも適用します。ファイルは 14 日後に削除するため、採用編集と元画像を自分の記録に保管してください。
別のエンドポイントが向くとき
元画像なしの新しい構図には Lite の文章生成を使います。写真ブースは 4 コマの生成例で、この処理は参照素材から始めます。納品が 2K や 4K なら Nano Banana 2.1、低価格の 1K なら Lite です。元素材、出力サイズ、確認したい細部で選んでください。
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-2-lite/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"
}
}'
# 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 リファレンスを参照してください。







