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

コード例

Python

cURL

Node.js

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

詳細なパラメータドキュメント、使用可能な値、デフォルト値については、右側のプレイグラウンドにある各フィールドの説明をご覧ください。列挙型フィールド(aspectRatioimageSizethinkingLevel のようなもの)はすべてドロップダウン選択に対応しており、手動入力は不要です。
未対応機能以下の Google 公式機能は APIYI ではサポートされておらず、別途課金が必要です。
  • Grounding with Google Search: tools: [{"google_search": {}}] 経由のリアルタイム検索情報
  • 画像検索グラウンディング (Nano Banana 2 専用): Google の画像検索からのビジュアルコンテキスト
これらの機能には追加の Google Search API 課金が必要で、APIYI の転送には含まれていません。

承認

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