Skip to main content
POST
Text-to-image: generate an image from a text description
右側のインタラクティブな Playground では、パラメータ(アスペクト比、レスポンス形式など)をドロップダウンで選択できます。Authorization フィールドに API Key を入力し(形式: Bearer sk-xxx)、ワンクリックでテストリクエストを送信できます。
適用範囲: このページは テキストから画像生成 用です。prompt を入力するだけでよく、画像のアップロードは不要です。既存の画像を編集する場合は、Image Editing endpoint を使用してください。
🖥️ ブラウザ Playground の制限(重要)この endpoint は、レスポンス内で base64 エンコードされた画像(inlineData.data、通常は数 MB)を返します。ブラウザのレンダリング制限により、右側の Playground ではレスポンス到着後に 请求时发生错误: unable to complete request と表示されることがありますが、リクエスト自体は実際には成功しています。ブラウザがそのような長い base64 文字列をレンダリングできないだけです。推奨ワークフロー(初心者向け):
  • 下の Python / Node.js / cURL サンプルをコピーしてローカルで実行してください。コードはレスポンスを自動的にbase64.b64decodesし、画像をファイルに書き込みます
  • Nano Banana 2 Lite は 1K キャンバスに最適化されているため、レスポンスサイズは比較的控えめですが、それでも画像を保存するにはローカル実行が最も安全です。
すべての image API は 同期式 です。ポーリングするタスク ID はなく、クライアントが切断されると、リクエストがまだ課金対象のままであっても結果は失われます。このモデルでは十分に長いタイムアウトを設定してください。Image API Essentials & Best Practices を参照してください。

コード例

Python

cURL

Node.js

OpenAI 互換モード

パラメータのクイックリファレンス

詳細なパラメータドキュメント、使用可能な値、デフォルトは右側のプレイグラウンドのフィールド説明をご覧ください。列挙型のすべてのフィールド(aspectRatio など)はドロップダウン選択に対応しており、手動入力は不要です。
Nano Banana 2 からの移行: モデル名をgemini-3.1-flash-imageからgemini-3.1-flash-lite-imageに変更するだけで、他のパラメータは変更しないでください。Liteは1K のみをサポートしています。2K/4K を渡す場合は、1K に戻してください。

承認

Authorization
string
header
必須

API Key obtained from the APIYI console

ボディ

application/json
contents
object[]
必須

Content array containing the text prompt

generationConfig
object
必須

レスポンス

Image generated successfully

candidates
object[]

Array of generation results

usageMetadata
object