Gemini Nano Banana 2.1 圖像生成
使用 Gemini Nano Banana 2.1 生成與編輯圖片, 支援最多 14 張參考圖片及 1K, 2K, 4K 解析度.
中國大陸用戶請注意: 請使用 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:13:2,2:34:3,3:416:9,9:165:4,4:521:91:4,4:11: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 回調.