Skip to main content
POST
Text-to-Image: Generate an image from a text prompt
右側のインタラクティブなPlaygroundでは、パラメータ(アスペクト比、解像度、レスポンスタイプなど)のドロップダウン選択に対応しています。AuthorizationフィールドにAPIキー(形式: Bearer sk-xxx)を入力すると、ワンクリックでテストリクエストを送信できます。
対象範囲: 本ページはテキストからの画像生成向けです。promptを入力するだけで利用でき、画像のアップロードは不要です。既存の画像を編集する場合は、画像編集エンドポイントをご利用ください。
🖥️ ブラウザPlaygroundの制限事項(重要)このエンドポイントは、レスポンス内にbase64エンコードされた画像(inlineData.data、通常は数MB)を返します。ブラウザのレンダリング制限により、レスポンスの受信後に右側のPlaygroundに请求时发生错误: unable to complete requestと表示される場合がありますが、リクエスト自体は正常に成功しています。単にブラウザがこれほど長いbase64文字列をレンダリングできないだけです。推奨ワークフロー(初心者向け):
  • 下記のPython / Node.js / cURLサンプルをコピーしてローカルで実行してください。コードが自動的にレスポンスをbase64.b64decodeし、画像をファイルに書き込みます。
  • ブラウザ内のPlaygroundを使用する必要がある場合は、imageSizeを最小レベル(1K)に設定してレスポンスサイズを抑えてください。
すべての画像APIは同期型です。ポーリング用のタスクIDは存在せず、クライアントの接続が切断された場合、リクエストに対して課金が発生したまま結果が失われます。このモデルには余裕を持ったタイムアウト時間を設定してください。詳細は画像APIの基本とベストプラクティスをご参照ください。

コード例

Python

cURL

Node.js

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

詳細なパラメータドキュメント、許容値、およびデフォルト値については、右側の Playground にあるフィールドの説明を参照してください。すべての enum 型フィールド(aspectRatio、imageSize、thinkingLevel など)はドロップダウン選択に対応しており、手動での入力は不要です。
Google Search grounding: リクエストのトップレベルに "tools": [{"googleSearch": {}}] を追加します。検索クエリごとに $0.014 が追加で課金され、モデルが実行するクエリ数を決定します。Nano Banana 2.1 の概要を参照してください。

承認

Authorization
string
header
必須

API Key obtained from APIYI Console

ボディ

application/json
contents
object[]
必須

Content array containing text prompts

generationConfig
object
必須

レスポンス

Successfully generated image

candidates
object[]

Generation results array

usageMetadata
object