ToAPIsToAPIs
Gemini Nano Banana 2.1

Gemini Nano Banana 2.1 圖像生成

使用 Gemini Nano Banana 2.1 生成與編輯圖片, 支援最多 14 張參考圖片及 1K, 2K, 4K 解析度.

POST
/v1/images/generations

中國大陸用戶請注意: 請使用 https://toapis.cn 作為 Base URL. 將以下範例中的 https://toapis.com 替換為 https://toapis.cn.

模型選擇

版本Model ID
普通版gemini-nano-banana-2.1

支援文生圖和圖生圖. 請求以非同步任務執行, 提交成功後使用回傳的任務 ID 查詢結果.

image_urls 只接收公開可存取的圖片 URL, 不接收 base64 資料. 請先使用 上傳圖片接口 上傳本機圖片並取得 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 必須公開可存取. 參考圖數量不代表輸出圖片數量.

單張圖片不超過 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. 使用 圖片任務查詢接口 取得任務狀態和最終圖片. 非同步通知請參考 Webhook 回調.