Skip to main content
POST
  • 直連 Google Vertex AI,使用 Gemini 2.5 Flash Image 原生 API
  • 通過 model 參數選擇 gemini-2.5-flash-image-official 模型
  • Nano Banana official alias: nano-banana-official
  • 支持文生圖、圖生圖
  • 支持 temperature、topP、maxOutputTokens 等原生生成參數
  • 支持 personGeneration、imageOutputOptions 圖像配置
  • 支持 safetySettings 安全設置
  • 異步任務管理,通過任務 ID 查詢結果
重要變更:爲了更好的性能和成本控制,我們不再支持在 image_urls 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
預設值:"gemini-2.5-flash-image-official"
必填
圖像生成模型名稱示例:"gemini-2.5-flash-image-official"
string
必填
圖像生成的文本描述
string
圖像寬高比支持的格式:
  • 1:1 - 正方形
  • 3:2 / 2:3
  • 3:4 / 4:3
  • 4:5 / 5:4
  • 9:16 / 16:9
  • 21:9
integer
預設值:1
生成圖像的數量固定爲 1
string[]
參考圖像 URL 數組,用於圖生圖或圖像編輯⚠️ 僅支持 URL 格式(不再支持 base64)
  • 公開可訪問的圖片 URL(http:// 或 https://)
  • 可使用 上傳圖片接口 上傳本地圖片獲取 URL
限制:
  • 最多 3 張圖片
  • 單張圖片不得超過 10MB
  • 支持格式:.jpeg, .jpg, .png, .webp
object
Vertex AI 原生擴展參數

Response

string
任務唯一標識符,用於查詢任務狀態
string
對象類型,固定爲 generation.task
string
使用的模型名稱
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務進度百分比(0-100)
integer
任務創建時間戳(Unix 時間戳)
object
任務元數據