title: "Nano Banana Pro 不支持 seed 参数?深度解析与替代方案"
description: "Nano Banana Pro (gemini-3-pro-image-preview) 报错 Invalid value at 'generation_config.seed'?本文深度解析其不支持 seed 的原因,并提供图像一致性的官方替代方案。"
「Nano Banana Pro に seed を渡したら Invalid value at 'generation_config.seed' (TYPE_INT32) というエラーが出た。結局、seed には対応していないの?」——これは 2026 年の Gemini 画像生成 API コミュニティで最も頻繁に寄せられる質問の一つです。
結論から言います:Nano Banana Pro(gemini-3-pro-image-preview)は seed パラメータをサポートしていません。 これは SDK のバグでも、パラメータ名の打ち間違いでもなく、Google 公式がこのモデルに対して seed に基づく再現性メカニズムを公開していないためです。発生する TYPE_INT32 エラーは、本質的には「そのモデルが受け付けないフィールドが指定された」際に Google のバックエンドが返すパラメータ検証エラーです。
本記事では、公式ドキュメントとコミュニティのフィードバックに基づき、以下の 3 点を明確に解説します:なぜ Nano Banana Pro には seed がないのか、このエラーは何を意味しているのか、そして seed がない環境でどのように画像の一貫性を保つか。記事内の結論はすべて英語の一次情報に基づいており、誤解を招かないよう構成しています。

Nano Banana Pro は seed パラメータをサポートしているか:公式結論
まずはユーザーが最も気になる事実の側面からお話しします。
公式の立場
- Nano Banana Pro =
gemini-3-pro-image-preview、Google DeepMind が提供する Gemini 3 Pro Image モデルです。 - 2026 年 4 月現在、公式 API ドキュメントで画像生成に対してリストされているサポートパラメータは以下の通りです:
- aspect_ratio:9 種類の比率(1:1、16:9、21:9 など)
- resolution:1K / 2K / 4K
- response_modalities:テキスト / 画像 / 混合
- reference images:参照画像の入力
- seed / random_seed、またはこれに相当するフィールドはリストに含まれていません。
なぜ「一時的に未実装」ではないのか
Flux や Stable Diffusion といった diffusion(拡散) モデルとは異なり、Nano Banana Pro は Google の Autoregressive Gemini アーキテクチャに基づいています。この種のモデルのランダム性の源泉は、拡散モデルとは全く異なります:
- 拡散モデル:固定 seed → 固定初期ノイズ → 同一サンプリングステップ → 精密な再現が可能。
- 自己回帰モデル:トークンごとにサンプリングを行い、ランダム性は top-k / top-p / temperature などのサンプリング決定に依存します。画像全体を固定できる単一の「シード」は存在しません。
したがって、Nano Banana Pro に seed がないのは実装漏れではなく、アーキテクチャのレベルでこのような再現性の概念をサポートしていないためです。

🎯 認識の修正:「サードパーティのインターフェースが Nano Banana Pro の seed パラメータをサポートしている」という表示を見かけた際は注意が必要です。それは通常、中継層でプレースホルダーフィールドを設けているだけで、Google の実際のモデルに対して再現性の効果はありません。APIYI (apiyi.com) を通じて Nano Banana Pro を呼び出す際は、seed フィールドを無視し、後述する 4 つの公式な方法で一貫性を確保することをお勧めします。
エラー「Invalid value at 'generation_config.seed' (TYPE_INT32)」が意味すること
ユーザーから報告されたエラー内容は以下の通りです:
[&{{Invalid value at 'generation_config.seed' (TYPE_INT32),
230718326286594 (request id: 2026041422181323975211237876978)
v_api_biz_error 400} 400 }]
このエラーには、解読すべき2つの層の情報が含まれています。
第1層:文字通りの意味
- 400 Bad Request:パラメータの検証に失敗しました。
- TYPE_INT32:サーバー側は
seedフィールドをint32型として期待しています。 - 入力された
230718326286594は 48ビット整数に近い値 であり、int32の最大値である2,147,483,647を大幅に超えています。
つまり文字通りには、サーバー側は「この seed 値を int32 として解析しようとしたが、数値がオーバーフローした」と言っているのです。
第2層:真の原因(より重要)
しかし、文字通りの意味に惑わされてはいけません。たとえ seed を int32 の範囲内(例:12345)に収めたとしても、同様に 400 エラーが発生します。その際、エラーメッセージは Unknown field や generation_config.seed is not supported for this model に変わる可能性があります。これは以下のことを意味します:
- Nano Banana Pro モデルにとって、
generation_config.seedは受け入れられないフィールドであるということ。 - Google サーバー側は未知のフィールドを検証する際、まず既知の proto スキーマに基づいて型チェックを行います。たまたま
seedが Gemini の汎用GenerationConfigproto でint32として宣言されているため、先にTYPE_INT32のエラーが投げられるのです。 - 真の問題は数値ではなく、モデルがそもそもこのフィールドを受け取るべきではないという点にあります。
他のモデルとの比較
- Gemini テキストモデル(Gemini 2.5 Pro / Flash):過去に SDK での
seedサポートには変遷がありました。一部のバージョンでは、内部の proto には定義されていても SDK では公開されていないケースがありました。 - Vertex AI の一部のモデル:再現可能なサンプリングパラメータとして
seedが正式に開放されています。 - Nano Banana Pro / Nano Banana 2(画像モデル):
seedをサポートしていません。どのような方法で注入しても無効です。

Seed が使えない場合の 4 つの一貫性確保策
Seed を使ってランダム性を固定することはできませんが、**画像の一貫性(同一キャラクター / 同一シーン / 同一スタイル)**は、Nano Banana Pro が公式にサポートしている仕組みを通じて達成可能です。
対策 1:参照画像(Reference Images)
これが最も直接的で効果的な方法です:
- プロンプトに 1〜3 枚の 同一キャラクター / 同一オブジェクト / 同一シーン の参照画像を追加します。
- Nano Banana Pro の自己回帰アーキテクチャは、参照画像を活用した「同一テーマの再生成」に非常に優れています。
- 用途:連載漫画、キャラクターシート、シリーズ製品画像など。
対策 2:構造化プロンプトで主要な特徴を固定する
ランダム性をプロンプトの中に「閉じ込める」方法です:
- 詳細な視覚的特徴(髪の色、目の色、服装、構図、光の当たり方)をリストアップします。
- 一貫したスタイルキーワード(例:
cinematic photo, 35mm, soft rim light)を使用します。 - ネガティブプロンプトを併用して、意図しない方向への変化を排除します。
対策 3:大量生成 + 人力選別
ランダム性が再現できないのであれば、「数で一貫性を担保」します:
- 一度に 4〜8 枚生成します。
- 最も基準に近いものを 1 枚選び、それを指標にします。
- その後、その画像をモデルに参照画像としてフィードバックします。
対策 4:後処理による調整(PS / AE / カラーマネジメント)
商用レベルの出力が必要な場合:
- カラーマッチングツール(LUT / カーブ)を使用して色調を統一します。
- Photoshop の生成塗りつぶし(Generative Fill)で部分的な微調整を行います。
- 人物の重要な部位(顔、手)に対してレイヤー分けして処理を行います。

🎯 一貫性確保のための実践アドバイス:真に安定した手法は「参照画像 + 構造化プロンプト」の組み合わせです。APIYI (apiyi.com) を活用して複数のリクエストを並列で実行し、制限なく並行処理できる利点を活かせば、このような「数で一貫性を担保する」シナリオにおいて、生成から選別までの時間を大幅に短縮できます。
公式サポートパラメータ早見表とエラーフィールド対照表
| フィールド | Nano Banana Pro 対応状況 | 説明 |
|---|---|---|
aspect_ratio |
✅ 対応 | 9種類の比率(1:1 / 16:9 / 21:9 など) |
resolution |
✅ 対応 | 1K / 2K / 4K |
response_modalities |
✅ 対応 | text / image / 混合 |
| reference images | ✅ 対応 | 1〜3枚の参照画像 |
seed / generation_config.seed |
❌ 未対応 | 指定すると400エラーが発生 |
random_seed |
❌ 未対応 | 同上 |
temperature |
⚠️ 解析されない可能性あり | 画像モデルではサンプリング温度は適用されません |
top_k / top_p |
⚠️ 画像モデル用パラメータではありません | テキストモデル用です |
クイックスタート:Seedエラーを回避する正しい呼び出し方
Python サンプル(OpenAI互換 + APIYI中継サービス)
from openai import OpenAI
client = OpenAI(
base_url="https://api.apiyi.com/v1",
api_key="YOUR_API_KEY",
)
# ✅ 正解:seedを含めず、プロンプトと参照画像で一貫性を制御します
resp = client.images.generate(
model="nano-banana-pro",
prompt=(
"A young woman with silver hair and blue eyes, "
"wearing a red coat, cinematic photo, 35mm, soft rim light"
),
size="2048x2048",
n=4, # 一度に4枚生成し、手動で選別します
)
for i, img in enumerate(resp.data):
print(f"Image {i}: {img.url}")
📎 参照画像を使用した高度な呼び出し例を展開
# 注意:Nano Banana Proは参照画像をサポートしていますが、OpenAI SDKのImages APIで
# 参照画像を使用する場合は、/chat/completions のマルチモーダル構造に切り替える必要があります。
# 擬似コードによる実装イメージ:
messages = [
{"role": "user", "content": [
{"type": "image_url", "image_url": {"url": "https://.../ref1.jpg"}},
{"type": "image_url", "image_url": {"url": "https://.../ref2.jpg"}},
{"type": "text", "text": "キャラクターの外見を維持したまま、朝の海辺のシーンに変更して"},
]}
]
# 画像出力をサポートするエンドポイントを呼び出し、Nano Banana Proのマルチモーダル機能と連携させます
エラー例(400エラーが発生します)
# ❌ このコードは TYPE_INT32 / Invalid value エラーになります
resp = client.images.generate(
model="nano-banana-pro",
prompt="a cute corgi",
extra_body={"generation_config": {"seed": 230718326286594}},
)
# → 400 Invalid value at 'generation_config.seed' (TYPE_INT32)
🎯 移行のアドバイス:拡散モデル(Flux / SDXL / Imagen 3)から Nano Banana Pro へ移行する際は、既存コード内の seed フィールドを必ず削除してください。「再現性」が必要な業務の場合は、Flux を予備の経路として残しておくことをお勧めします。APIYI (apiyi.com) を利用すれば、同一アカウント内で複数のモデルを併用できるため、アカウントを切り替える手間は不要です。
Seed エラーへの3つの対処法
提案1:seed フィールドを削除する
最もシンプルな方法です。コード内の seed、generation_config.seed、random_seed をすべて削除してください。これが Nano Banana Pro を正常に動作させる唯一の方法です。
提案2:互換レイヤーを挟む
Flux / SDXL(seed 対応)と Nano Banana Pro(非対応)の両方をサポートする必要がある場合は、クライアント側でモデルを判別するロジックを組み込みます。
def build_params(model, prompt, seed=None):
params = {"model": model, "prompt": prompt}
# seed に対応しているモデルのみパラメータを追加
if seed is not None and model.startswith(("flux", "sdxl", "imagen")):
params["seed"] = seed
# Nano Banana Pro / Nano Banana 2 は自動的に seed を無視します
return params
提案3:ビジネスレイヤーで request_id を記録し、追跡可能にする
seed がないからといって「バージョン管理」ができないわけではありません。各呼び出しの request_id + プロンプト + 参照画像のハッシュ を保存しておくことで、少なくとも「どのように生成されたか」を追跡できます(完全に再現できるわけではありません)。
よくある質問(FAQ)
Q1:同じプロンプトでも生成結果が毎回異なるのはなぜですか?
Nano Banana Pro の自己回帰サンプリング自体にランダム性が含まれており、再現性を担保する入り口がないためです。これはバグではなく、アーキテクチャ上の仕様です。安定性を高めたい場合は、参照画像と構造化されたプロンプトを組み合わせて使用してください。
Q2:Nano Banana 2 でも同じエラーが出ますが、これも非対応ですか?
はい。Nano Banana 2(gemini-3.1-flash-image-preview)も同様に seed をサポートしていません。Nano Banana Pro と同じアーキテクチャファミリーであり、速度とポジショニングが異なるだけだからです。
Q3:サードパーティが「Nano Banana Pro の seed をサポートする」と言っていますが、本当ですか?
それは多くの場合、中継レイヤーでのダミー実装です。Google に呼び出す前に seed を受け取りますが、実際には Google に送信されません(送信してもエラーになるため)。実際の画像出力において、再現性を高める効果は一切ありません。中継レイヤーが Google の公式パラメータをそのまま透過的に転送することを望むなら、APIYI(apiyi.com)のような透明性の高いプラットフォームを選択することをお勧めします。
Q4:Vertex AI の同モデルは seed をサポートしますか?
本記事執筆時点(2026年4月)では、Vertex AI ドキュメント内の gemini-3-pro-image 画像生成インターフェースでも seed パラメータは公開されていません。他の Gemini モデルの一部は Vertex AI 上で seed をサポートしていますが、モデル間での互換性はありません。
Q5:temperature も機能しないのはなぜですか?
temperature は主にテキストモデルのトークンサンプリング分布に使用されるためです。Nano Banana Pro は画像生成エンドポイントであり、画像サンプリングのパスと temperature は直接マッピングされていないため、渡しても無視されるか、同様に 400 エラーが発生します。
Q6:複数回の生成結果で「スタイルを固定」する方法はありますか?
あります。以下の3点セットを推奨します:(a) 「アンカー画像」を参照画像として使用する、(b) プロンプトのテンプレートを固定する、(c) 生成されたベストなサンプルをリファレンス画像ライブラリとして蓄積する。これらを繰り返すことで、安定性が向上します。APIYI(apiyi.com)の無制限の同時実行能力を活用すれば、一度に 4〜8 枚の画像を生成してアンカー画像を選定できるため、一貫性のチューニング期間を大幅に短縮できます。
まとめ:Seed エラーの背後にあるアーキテクチャの真実
冒頭の疑問である「Nano Banana Pro は Seed パラメータをサポートしているか?」という問いに対する答えは、**明確に「いいえ」**です。
- エラーメッセージの真相:
Invalid value at 'generation_config.seed' (TYPE_INT32)というエラーは、単にサーバー側でのパラメータ検証によるものです。 - 根本的な原因:Nano Banana Pro は自己回帰型の Gemini アーキテクチャを採用しており、設計上 Seed という入力項目が存在しません。
- 再現可能な代替案:参照画像 + 構造化プロンプト + バッチ生成による選別 + 後処理。
- エンジニアリング上の推奨事項:すべての Seed フィールドを削除し、モデル認識型の互換レイヤーを作成し、request_id を使用して追跡を行ってください。
Nano Banana 2 も同様にサポートしていません。試行錯誤は不要です。Seed への依存が不可欠な業務については、拡散モデル(Flux / SDXL / Imagen 3)をバックアップとして維持してください。
🎯 導入のヒント:APIYI (apiyi.com) プラットフォームでは、1つのアカウントで Nano Banana Pro(Seed なし、メインの画像生成用)と Flux / Imagen 3(Seed あり、再現性が必要な予備用)を並行して呼び出すことができます。チャージキャンペーンでは最大 15% OFF となり、同時実行数制限もないため、「一度に複数枚生成して一貫性のあるものを選ぶ」ワークフローに最適です。今すぐコード内の Seed を削除し、参照画像と構造化プロンプトに切り替えてみてください。Nano Banana Pro の真の実力を即座に実感できるはずです。
— APIYI Team(APIYI apiyi.com 技術チーム)