gemini-3.1-flash-image AI画像API
gemini-3.1-flash-image (Nano Banana 2): Flatkey で画像生成、参照画像の編集、デザインの反復を行えます。サンプルは Gemini の contents/parts を使い、Images API の本文とは置き換えられません。
出力
プレビュー
Image 2 で生成
リクエスト概要
- エンドポイント
- POST /v1beta/models/gemini-3.1-flash-image:generateContent
- モデル ID
- gemini-3.1-flash-image
- アスペクト比
- 16:9
- 解像度
- 1K
プレビューのみです。Flatkey に送信するにはログインしてください。
{
"model": "gemini-3.1-flash-image",
"contents": [
{
"role": "user",
"parts": [
{
"text": "Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark.\n\nComposition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium.\n\nAvoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above."
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "1K"
}
}
}APIパフォーマンス
gemini-3.1-flash-image APIの信頼性と可用性
十分な本番トラフィックが集まると、gemini-3.1-flash-image の Flatkey リクエストテレメトリーをここに表示します。
APIアクティビティ
gemini-3.1-flash-image APIの利用状況とリクエスト
最新の集計期間における gemini-3.1-flash-image のリクエスト量と成功した推論アクティビティを確認できます。
gemini-3.1-flash-image 料金
gemini-3.1-flash-image API料金と課金
料金カードは Flatkey の現行入力・出力トークン料金です。トークン単価は画像一枚の固定料金ではなく、設定、参照入力、生成内容で使用量が変わります。Google 直接利用の料金や無料枠は自動適用されません。
クレジットを追加
画像・動画・音声・テキストモデルで同じFlatkey残高とAPIキーを使えます。
- モデルタイプ
- テキストから画像
- API
- /v1beta/models/gemini-3.1-flash-image:generateContent
- 課金基準
- 1M tokens
- 出力数
- 1
gemini-3.1-flash-image AI画像生成とAPI: 主な機能
Google の gemini-3.1-flash-image ルートは テキスト · 画像 をサポートします。カタログカテゴリ:Marketing。
テキストから画像
被写体、構図、光、描く文字を指定します。出力設定はプロンプトだけでなくリクエストのフィールドに設定してください。
参照画像
参照画像を添え、維持する部分と変更する部分を指定します。参照数は本ページのパラメータ表に従います。
出力数
Playground にある比率とサイズのみ選んでください。Flash、Flash Lite、Pro の出力制限は異なります。
API
サンプルの正確なモデル ID と contents/parts 構造を維持します。一括処理の前に小さなリクエストで検証してください。
比較
gemini-3.1-flash-image API比較:機能とアクセス
統合を変更する前に、gemini-3.1-flash-image のカタログ情報を前世代の基準と比較します。
| 機能 | 前世代 | gemini-3.1-flash-image |
|---|---|---|
| プロバイダー | このカタログスナップショットでは未確認 | |
| モダリティ | このカタログスナップショットでは未確認 | テキスト · 画像 |
| コンテキスト | このカタログスナップショットでは未確認 | カタログにコンテキストウィンドウの記載がありません |
| エンドポイント | このカタログスナップショットでは未確認 | /v1beta/models/gemini-3.1-flash-image:generateContent |
| 課金 | このカタログスナップショットでは未確認 | $0.5/$3 per 1M tokens |
統合前に正しいリクエストを選択
対応ワークフロー、現在の費用、Flatkey の正確なパラメータ契約を確認します。
固定単価がある場合、現在の設定とライブ料金から計算します。
- 現在の設定
- 1×
- ライブ料金
- $0.06
- リクエスト見積もり
- 従量課金
最終料金は送信内容とアカウントグループに従います。トークン・段階料金は固定額にできません。
ワークフローと Model ID
利用可能なものだけを使用します。公開モデル ID は共通で、入力方式はリクエスト本文で選択します。
テキストから画像
テキストから新しい画像を生成します。
- モデル ID
gemini-3.1-flash-image- エンドポイント
/v1beta/models/gemini-3.1-flash-image:generateContent
参照画像による生成
参照画像で編集やバリエーションを作ります。
- モデル ID
gemini-3.1-flash-image- エンドポイント
/v1beta/models/gemini-3.1-flash-image:generateContent
パラメータ互換性
Playground と同じモデル設定に基づく値です。
aspect_ratioアスペクト比1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9
既定値: 1:1image_sizeサイズ1K · 2K · 4K
既定値: 1Kimage参照上限4 ファイル
エンドポイント: /v1beta/models/gemini-3.1-flash-image:generateContent初回テストから本番へ
Playground と API で同じ契約を使い、検証、残高、状態、結果取得を明示的に処理します。
リクエストの流れ
- 1
モデル、プロンプト、参照、出力を検証。
- 2
画像リクエストを送信。
- 3
結果または非同期タスクを取得。
- 4
ファイルとメタデータを保存。
本番チェック
非対応の値や参照数を送信前に拒否します。
キー、残高、制限、グループ料金を分けて処理します。
交換すべきプロンプトや素材を明示します。
task ID を保持し、再試行を制限し、成功扱いしません。
プロンプトライブラリ
gemini-3.1-flash-image 画像生成プロンプト例
画像生成向けの gemini-3.1-flash-image プロンプトから始め、playground に表示されるリクエスト項目を調整します。
Image 2 で生成
Scene: A 16:9 futuristic game loadout frame shows a helmeted rider beside a black-and-orange motorcycle in a rainy industrial hangar. Blue-and-orange interface controls and a circular part-selection panel sit around the vehicle. Keep the rider, motorcycle geometry, wet floor reflections, lighting direction, and selected-part position fixed for a clean equipment swap. No readable words, logos, invented stats, or watermark. Composition and rendering: Deliver one 16:9 game-interface keyframe. Separate the character, held equipment and HUD into clear depth layers; keep slot spacing and icon scale consistent, with the selected item visually dominant. Preserve the scene-specific game art style. Let material edges catch the existing light without letting interface glow obscure the silhouette. Keep all equipment fully inside the frame. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Scene: A poolside sports broadcast catches a swimmer in a blue cap during freestyle, with one arm entering the water and a sharp splash across the lane. Use a low pool-deck camera, blue water, lane markings, and abstract blue lower-third graphics without readable text. Keep swimmer direction, splash shape, and framing consistent; no real athletes, teams, logos, or watermark. Composition and rendering: Deliver one 16:9 broadcast still at the decisive instant. Use coherent perspective for the playing surface and equipment, readable separation between competitors, and a softer crowd behind the action. Keep the principal subject sharp, with directional blur limited to fast extremities and spray. Preserve the specified broadcast angle and reserve overlay areas clear of the action. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Image 2 で生成
Scene: A metallic wireless-earbud charging case floats open above a glossy black surface while the two matching earbuds hover above their slots. Purple and cyan rim lights define the rounded metal, black interior, reflections, and empty dark background. Preserve the case, earbuds, hinge, highlights, and three-quarter camera angle. No readable branding, extra products, hands, or watermark. Composition and rendering: Deliver one 16:9 commercial product still. Keep the complete product silhouette inside generous crop-safe margins. Resolve edges, seams and material transitions precisely; shape highlights to describe volume without clipping bright surfaces or crushing dark details. Align reflections with the object and light source. Retain the stated camera angle and existing negative space; add no decorative props. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Image 2 で生成
Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark. Composition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Image 2 で生成
Scene: In a wet green park, a man in a coral-red raincoat and yellow boots struggles with an inverted rainbow umbrella in a gust of wind. His arms brace against the bent canopy while rain streaks through the trees and puddles reflect the bright colors. Keep the umbrella shape, body pose, wind direction, and safe footing clear; no injury, readable text, logos, or watermark. Composition and rendering: Deliver one 16:9 physical-comedy still at the described instant. Make the cause of the gag readable through body balance, grip and object spacing. Separate the reaction from the airborne props; retain believable gravity and contact points. Keep the face and important props sharp, with only restrained directional blur on fast edges. Preserve the stated lighting and room or stage layout. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Image 2 で生成
Scene: A softly faded historical dock scene shows several workers repairing a large wooden boat at a riverside boatyard. Timber ribs, scaffolding, hand tools, smaller boats, and weathered work clothes fill the wide documentary frame. Restore the wood grain, riverbank structures, faces, and natural color aging without modern objects, readable signs, logos, captions, or watermark. Composition and restoration: Deliver one 16:9 archival-style still. Preserve the original framing, period-specific construction and restrained tonal range; retain monochrome, sepia or faded color as described. Recover modest detail in faces, clothing and architecture without synthetic sharpening. Keep fine grain and authentic aging consistent across the frame; repair damage without replacing historical features. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
gemini-3.1-flash-image API を使う理由
Flatkey 経由で gemini-3.1-flash-image を使う理由
gemini-3.1-flash-image、アカウント制御、カタログ内の他モデルを 1 つのゲートウェイで管理できます。
1 つの API で gemini-3.1-flash-image
gemini-3.1-flash-image のモデル ID とエンドポイントを明示し、他のワークロードと同じ Flatkey キーを利用できます。
ライブカタログ料金
リクエスト送信前に gemini-3.1-flash-image の課金単位を確認し、アカウントで最終見積もりを確認できます。
実用的なモデル引き継ぎ
公開 playground で gemini-3.1-flash-image のプロンプトを試し、同じ設定を認証済み統合へ引き継げます。
利用量とルーティングの制御
プロバイダー向けアプリのワークフローを変えずに、gemini-3.1-flash-image のキー、クォータ、ルーティングを一元管理できます。
API
gemini-3.1-flash-image API
同じキーとモデルカタログで4つの方法から選べます。実行可能な例を確認してください。
curl https://router.flatkey.ai/v1beta/models/gemini-3.1-flash-image:generateContent \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"gemini-3.1-flash-image","contents":[{"role":"user","parts":[{"text":"gemini-3.1-flash-imageで高品質な商品画像を作成:整理された構図、正確な照明、被写体への強いフォーカス、リアルなディテール。"}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}}}'
よくある質問
gemini-3.1-flash-image API
料金・機能・利用に関するFAQ
gemini-3.1-flash-image の料金、機能、エンドポイント、カタログ制限に関する回答です。




