ブログ

使用ガイド

Nano Banana ベーシック版テキストtoイメージガイド:アスペクト比、余白、プロンプトの使い方

タスク API の aspect_ratio と prompt フィールドを使い、バナーとソーシャルカード向けに構図が明確な画像を生成する

Nov 18, 2026
温かい砂色の背景にテラコッタと赭色の横方向の階段状ストライプが左から右へ下降するフラットな幾何学調のカバー画像。周囲に十分な余白がある。
このページの内容

この回線の位置づけと境界

nano-banana は HiAPI 上ではテキストtoイメージ(text-to-image)回線であり、非同期タスクとして送信する:リクエストボディの入力フィールドはすべて input オブジェクトの下にまとまり、送信後はタスク方式で結果を取得する。バッチでの画像生成ニーズがあるシナリオ、たとえば運用バナー、ソーシャルカード、記事挿絵の下書きに適している。本記事ではベーシック版のみを扱い、同シリーズの他のモデルには触れない。

利用できるフィールドは少ないため、まず契約を明確にする:prompt は必須の文字列で、長さは 1〜5000 文字;aspect_ratio は任意で、デフォルトは自動。列挙値は auto、1:1、16:9、9:16、3:4、4:3、3:2、2:3、5:4、4:5、21:9;output_format は任意で png または jpeg、デフォルトは png。旧フィールドの image_size は非推奨であり、目標アスペクト比を指定するには aspect_ratio を使う。

明確にすべきは、本回線では resolution、quality、width、height、seed、参照画像アップロードなどのフィールドが公開されていないことである。他の画像モデルの習慣に従ってこれらのキーを input に詰め込まないこと、また黙って無視されると仮定しないこと。同様に、aspect_ratio は目標アスペクトル比を指定するものであり、固定のピクセルサイズを約束するものではない。実際のアスペクト比とピクセルは返却画像を基準とし、納品前に確認する必要がある。

概念図:入力プロンプトとオプションがタスクチャネルを経て画像になる。この図は概念的な挿絵であり、nano-banana の実際の出力ではない。

フィールド契約と最小限の input 断片

以下は上記のフィールドのみを含む input 断片であり、フィールドの階層を説明するためのものである。完全な HTTP リクエストではない:endpoint、認証ヘッダー、タスクのポーリング方法は示していないため、これらは HiAPI の API ドキュメントを参照すること。

{
  "input": {
    "prompt": "横構図のフラットな幾何学イラスト、温かい砂色の背景、右側三分の一に階段状のカラーブロック、左側は余白、画面に文字なし。",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

prompt の書き方は画面の制御しやすさに影響する。実用的な順序は:まず主体とシーンを書き、次に構図と主体の位置を書き、それから余白領域を書き、最後に色彩、光、スタイルを書く。画面に文字が不要な場合は、「画面に文字、アルファベット、数字を一切出さない」と明示する方が、後から画像を修正するより楽である。長さは 5000 文字を埋める必要はなく、重要な制約を明確に書けばよい。長すぎる積み重ねは逆に重点を互いに薄めてしまう。

output_format の選択は納品経路によって決める:png は可逆保存と後続の編集に適し、jpeg は非可逆圧縮の納品に適する。デフォルトは png であり、下流がファイルサイズに敏感な場合は明示的に jpeg に変更すること。補足すると、png を選べるからといってモデルがアルファ透明チャネルを生成したわけではない。本回線には透明背景の能力宣言やフィールドはなく、背景除去や透明出力を約束しない。

アスペクト比と余白:まずレイアウトを決め、それからプロンプトを書く

余白とは「空けておく」ことではなく、タイトル、ボタン、コーナーマークのために確保する位置である。アスペクト比ごとに余白戦略は異なり、プロンプトを書く際には余白を構図の一部として記述すべきである。

  • 16:9 バナー:サイトのヒーロー画像や記事カバーでよく使われる。主体を右または左の三分の一に寄せ、反対側に連続した低情報領域を残し、主体がタイトルを圧迫しないようにする。プロンプトには「画面左側に約三分の一の幅の低コントラストの余白領域を確保する」と書くとよい。
  • 1:1 ソーシャルカード:主体を中央に置き、上下にそれぞれ呼吸空間を一圈残す;周囲の要素は端に寄せず、フィードでのトリミング時に切られないようにする。
  • 9:16 縦版:上部と下部にそれぞれ帯状の領域を残し、タイトルと署名に使う;主体は中段に置き、両端のテキスト領域と重ならないようにする。
  • 4:5 と 3:4:印刷やフィードでよく使われる比率に近く、余白は少なめでよいが、四周の安全マージンは確保することを推奨する。
  • 21:9 超ワイド:横方向の空間に余裕があり、複数要素をリズムよく並べるのに適するが、両端がトリミングされやすいため、重要な主体は端に寄せない。
  • auto:比率をサーバー側が決めるため、初期探索に適する;バッチ生産に入ったら、比率を明示的に指定してレイアウトの手戻りを減らすことを推奨する。

再度強調する:比率はピクセルではない。aspect_ratio が設定するのは目標アスペクトル比であり、16:9 は固定のピクセルサイズ(例:1920×1080)を意味しない。画像を取得したら実際のアスペクト比が期待どおりか確認し、下流に厳格なサイズ要件がある場合は自身で拡大縮小やトリミングを行い、プロンプト段階で安全マージンを十分に確保しておく。

そのまま書き換え可能なプロンプト実例 2 つ

以下の 2 つは検証待ちの書き方であり、実測の結論ではない。まずそれぞれ 1 回呼び出し、主体の位置と余白が期待どおりか観察してから、プロジェクトに合わせて調整することを推奨する。

バナー余白(16:9):

「横構図のフラットな幾何学イラスト、温かい砂色の背景。画面右側三分の一に、テラコッタ色、赭色、濃茶色のブロックで構成された階段状の構造を配置し、左から右へ段階的に下降させ、エッジはクリーンにする;画面左側三分の二は低コントラストでディテールのない余白領域を維持し、ごく淡い横方向のカラーバンドをトランジションとしてのみ残す。全体の色調は抑制され、グラデーションノイズなし、文字、アルファベット、数字、ロゴなし、構図はバランスが取れており、記事のヒーロー画像として適する。」

ソーシャルカード(1:1):

「正方形構図のミニマルなイラスト、薄いベージュの背景。画面中央に、3 本の弧が重なり合ってできる抽象的なマークを配置し、色は深い墨緑と赭石、線の太さは均一;マークの周囲には均等な余白を確保し、上下の余白は左右よりやや大きくして、後からタイトルを重ねやすくする。背景は純粋で、テクスチャなし、影なし、文字、アルファベット、数字、ロゴなし、全体は静かで抑制されている。」

どちらのプロンプトも「余白」を「余白を多めに」という一文ではなく、実行可能な空間記述として書いている。1 回の生成で主体がまだ端に寄っている場合は、形容詞を足し続けるのではなく、記述中の方位詞と占有率を優先的に調整すること。

段階的なイテレーション:一度に 1 つの変数だけを変える

バッチ生成で最も犯しやすい誤りは、prompt、比率、フォーマットを一度に変えてしまい、どこが変化の原因か判断できなくなることである。より安定した方法は段階的に収束させることである。

  • 第一歩:aspect_ratio と output_format を固定し、短いプロンプトで主体が正しく理解されるか確認する。
  • 第二歩:構図の記述を加える:主体の位置、画面に占める割合、余白領域。
  • 第三歩:色彩、光、スタイルを補足し、余白を圧迫していないか観察する。
  • 第四歩:安定した記述をテンプレートに整理し、バッチ時には主体と配色だけを置き換え、構造文は変更しない。

各呼び出し後に prompt、aspect_ratio、output_format と結果の差異を記録する。記録自体が資産である:同じバッチのタスクで系統的なずれが生じた場合、記録から比率の選択ミス、プロンプト構造の変化、フィールドの綴り問題のどれかを素早く特定できる。

納品前のセルフチェックと失敗時の対処

画像を取得したら、以下の項目でセルフチェックする:アスペクト比が aspect_ratio の目標比率に合っているか;主体が完全でトリミングされていないか;確保したテキスト領域は十分にクリーンか;画面に不要な文字やウォーターマーク状の要素が現れていないか;出力フォーマットが下流の要件を満たしているか。バナー用途の場合は、実際のページサイズで一度プレビューし、タイトルを重ねても主体を圧迫しないことを確認する。

タスクが失敗した場合や結果が逸脱した場合は、順に確認する:prompt が空でないか、1〜5000 文字を超えていないか;aspect_ratio が列挙値内か;output_format が png または jpeg のみか;非推奨の image_size を誤って使っていないか;本回線で公開されていないフィールドを渡していないか。パラメータに誤りがないことを確認したら、同じ入力を繰り返し送信するのではなく、プロンプトを簡素化して再試行する。連続して複数回逸脱する場合は、まず画面要素を最小限に減らし、それから一つずつ加え戻す。

最後に注意:本文中の挿絵は概念図にすぎず、「入力がタスクチャネルを経て画像になる」流れを説明するためのものであり、nano-banana の実際の出力ではない。すべてのプロンプトとフィールドの組み合わせは、まず自身で呼び出して検証してから本番フローに入ることを推奨する。モデルの詳細は /models/nano-banana を参照。

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む