ToAPIsToAPIs
Gemini Nano Banana 2.1

Gemini Nano Banana 2.1 画像生成

Gemini Nano Banana 2.1 で画像の生成と編集を行えます. 最大 14 枚の参照画像と 1K, 2K, 4K の解像度に対応します.

POST
/v1/images/generations

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

モデルの選択

バージョンModel ID
通常版gemini-nano-banana-2.1

テキストからの画像生成と画像編集に対応します. リクエストは非同期タスクとして処理されます. 送信が成功したら, 返されたタスク ID で結果を取得してください.

image_urls は公開アクセス可能な画像 URL のみを受け付けます. base64 データは使用できません. ローカル画像は先に 画像アップロード API でアップロードして URL を取得してください.

認証

Authorizationstringヘッダー必須

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

Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

modelstringボディ必須デフォルト: gemini-nano-banana-2.1

gemini-nano-banana-2.1 を指定してください.

promptstringボディ必須

画像生成または編集のためのテキスト説明.

sizestringボディ

出力画像のアスペクト比. 対応する値:

  • 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
nintegerボディデフォルト: 1

出力枚数は数値の 1 に固定されています. 文字列の "1" は使用しないでください.

image_urlsstring[]ボディ

画像生成や編集に使用する参照画像 URL の文字列配列. 最大 14 枚. 各 URL は公開アクセス可能である必要があります. 参照画像の枚数は出力画像の枚数ではありません.

画像 1 枚につき最大 10MB. 対応形式: .jpeg, .jpg, .png, .webp.

["https://example.com/photo.jpg"]
metadataobjectボディ

追加の設定パラメータ.

metadata
resolutionstringボディデフォルト: 1K

出力画像の解像度. 対応する値: 1K, 2K, 4K. デフォルトは 1K. 大文字の K を使用してください.

レスポンスフィールド

idstring

状態と結果の取得に使用するタスク ID.

objectstring

常に generation.task.

modelstring

リクエストで使用したモデル ID.

statusstring

タスクの状態: queued, in_progress, completed, failed.

progressinteger

タスクの進捗率. 0-100 の範囲.

created_atinteger

タスク作成時刻. 秒単位の Unix タイムスタンプ.

metadataobject

タスクのメタデータ.

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-nano-banana-2.1",
  "prompt": "ネオンが輝くサイバーパンク風の都市の夜景",
  "size": "16:9",
  "n": 1,
  "metadata": {
    "resolution": "2K"
  }
}'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-nano-banana-2.1",
  "prompt": "この写真を水彩画のスタイルに変換してください",
  "size": "1:1",
  "n": 1,
  "image_urls": [
    "https://example.com/photo.jpg"
  ],
  "metadata": {
    "resolution": "2K"
  }
}'
import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-nano-banana-2.1",
        "prompt": "ネオンが輝くサイバーパンク風の都市の夜景",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "resolution": "2K"
        }
    }
)
response.raise_for_status()
task = response.json()
print(task["id"])
const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "model": "gemini-nano-banana-2.1",
    "prompt": "ネオンが輝くサイバーパンク風の都市の夜景",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    }
  })
});

if (!response.ok) {
  throw new Error(await response.text());
}
const task = await response.json();
console.log(task.id);

レスポンス例

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-nano-banana-2.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

結果の取得

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