Skip to main content
POST
プレイグラウンド
APIキーとプロンプトを入力して送信してください。実際の API にリクエストが送信されます。これは、コードから呼び出すエンドポイントと同じです。
このページから送信されたリクエストは実際のものであり、APIキーに課金されます。 1K画像1枚あたりの料金は、モデルによって約 $0.02~0.09です。ここでの操作は サンドボックスでもモックでもありません。

パラメータ

string
必須
実行するモデルです。gemini-3-pro-image または gemini-3.1-flash-image を受け付けます。 完全一致が必要です — エイリアスや -preview サフィックスは使用できません。
object
必須
生成パラメータです。以下に記載されていないキーは invalid_params により拒否されます。
string
完了したタスクを POST する https URL です。これによりポーリングを省略できます。 https である必要があり、それ以外は送信時に拒否されます。

返ってくる内容

送信すると、1秒未満ですぐにレスポンスが返ります。画像はこのレスポンスには含まれません。生成はバックグラウンドで行われます。

その後、画像のポーリングを行います

このプレイグラウンドでは作成呼び出しのみを扱います。上記のレスポンスから id を取得し、 statuscompleted または failed に到達するまでタスクを読み取ります。1K画像の場合、 15~40秒かかると見込んでください。
完了したタスクには、画像URLの outputs 配列が含まれます。
出力URLは認証なしで使用でき、タスクの作成から24時間後に有効期限が切れます。 ダウンロード時には User-Agent ヘッダーを送信してください。配信CDNは、ヘッダーなしの リクエストに対して単なる 403 を返します。

次のステップ

概要

シリーズのすべてのパラメータ、解像度ティア、実測レイテンシ。

非同期タスク API

ポーリングループ、コールバック、完全なエラーテーブル。