Skip to main content
POST
中国本土のユーザー向け: Base URL として https://toapis.cn を使用してください. 以下の例の https://toapis.com を https://toapis.cn に置き換えてください.

モデルの選択

両モデルは同じエンドポイントとリクエストパラメータを使用します. model フィールドで切り替えてください. テキストからの画像生成と画像編集に対応します. リクエストは非同期で実行され, 送信後に返されるタスク ID で結果を取得できます.
image_urls は公開アクセス可能な画像 URL のみを受け付けます. base64 データは使用できません. ローカル画像は先に 画像アップロード API でアップロードして URL を取得してください.

認証

string
必須
すべてのリクエストに Bearer Token が必要です. API Key 管理ページ から API Key を取得してください.

リクエストパラメータ

string
デフォルト:"gemini-nano-banana-2.1"
必須
モデル名. gemini-nano-banana-2.1 または gemini-nano-banana-2.1-vip を使用します.
string
必須
画像生成または編集のためのテキスト説明.
string
出力画像のアスペクト比. 対応する値:
  • 1:1
  • 3:2, 2:3
  • 4:3, 3:4
  • 16:9, 9:16
  • 5:4, 4:5
  • 21:9
  • 1:4, 4:1
  • 1:8, 8:1
integer
デフォルト:1
出力枚数は数値の 1 に固定されています. 文字列の "1" は使用しないでください.
string[]
画像生成や編集に使用する参照画像 URL の文字列配列. 最大 14 枚. 各 URL は公開アクセス可能である必要があります. 参照画像の枚数は出力画像の枚数ではありません.画像 1 枚につき最大 10MB. 対応形式: .jpeg, .jpg, .png, .webp.
object
追加の設定パラメータ.

レスポンスフィールド

string
状態と結果の取得に使用するタスク ID.
string
常に generation.task.
string
リクエストで使用したモデル ID.
string
タスクの状態: queued, in_progress, completed, failed.
integer
タスクの進捗率. 0-100 の範囲.
integer
タスク作成時刻. 秒単位の Unix タイムスタンプ.
object
タスクのメタデータ.

結果の取得

送信レスポンスの id がタスク ID です. 画像タスク状態 API で状態と最終画像を取得してください. 非同期通知については タスク Webhook を参照してください.