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

コード例

Python

cURL

Node.js

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

詳細なパラメータのドキュメント、使用可能な値、デフォルトについては、右側の Playground のフィールド説明をご覧ください。すべての enum 型フィールド(aspectRatioimageSize など)は、ドロップダウン選択に対応しており、手入力は不要です。
未対応の機能以下の Google 公式機能は APIYI 経由では サポートされておらず、別途課金が必要です。
  • Google Search によるグラウンディング: tools: [{"google_search": {}}] 経由のリアルタイム検索情報
  • thinkingConfig(Thinking モード): Nano Banana 2 でのみサポートされ、Nano Banana Pro ではサポートされません
検索グラウンディング機能については、別途課金オプションについてサポートまでお問い合わせください。

承認

Authorization
string
header
必須

API Key from APIYI Console

ボディ

application/json
contents
object[]
必須

Content array containing the text prompt

generationConfig
object
必須

レスポンス

Image generated successfully

candidates
object[]

Generated results array

usageMetadata
object