Nano Banana (Gemini 2.5 Flash Image)

    google/gemini-2.5-flash-image

    側重高速出圖與對話式編輯,延遲低、成本低,支援文字與圖像多模態輸入。

    實時響應創意生成高質量生成行銷
    模態
    輸入 / 輸出價格
    $0.3 / $2.5M tokens
    上下文
    32768
    發布時間
    2025-10-07

    價格

    Token 類型輸入輸出快取讀快取寫
    文字$0.3/ M tokens$2.5/ M tokens$0.03/ M tokens$0.08333/ M tokens
    圖片$0.3/ M tokens$30/ M tokens$0/ M tokens$0/ M tokens

    快速開始

    可直接貼上執行下方範例程式碼。Gate.AI API 與 OpenAI 相容,多數 SDK 只需替換 base URL;切換模型時,只需修改模型 ID。

    1

    取得 API Key

    登入 Gate.AI 控制台,在「API Keys」頁面建立一組新的金鑰並妥善保管,發送請求時透過 Authorization 標頭帶入該金鑰。

    前往控制台建立金鑰
    環境變數
    export GATEAI_API_KEY="YOUR_API_KEY"; export GATEAI_API_URL="https://api.gate.ai/openai/v1/images/generations"
    2

    發起請求

    向 Chat Completions 介面發送 POST 請求,帶入模型 ID 與對話訊息陣列,即可取得模型回覆。

    POSThttps://api.gate.ai/openai/v1/images/generations
    curl --location "https://api.gate.ai/openai/v1/images/generations" --header "Authorization: Bearer {API_KEY}" --header "Content-Type: application/json" --data '{"model":"gemini-2.5-flash-image","prompt":"A golden retriever running on a sunny beach, cinematic","n":1,"size":"1024x1024"}'
    3

    處理回應與串流輸出

    預設回傳完整 JSON 回應;若需要逐字回傳,可在請求主體加入 "stream": true,並依 SSE 格式逐塊解析。

    POSThttps://api.gate.ai/openai/v1/images/generations
    curl --silent --location "https://api.gate.ai/openai/v1/images/generations" --header "Authorization: Bearer {API_KEY}" --header "Content-Type: application/json" --data '{"model":"gemini-2.5-flash-image","prompt":"A golden retriever running on a sunny beach, cinematic","n":1,"size":"1024x1024"}' | jq -r '.data[].url'

    端點

    基礎 URL、請求方法與必要請求頭,皆依當前模型的協議模板渲染。

    POSThttps://api.gate.ai/openai/v1/images/generations
    欄位
    值
    Authorization
    驗證請求頭,使用 Bearer {API_KEY} 格式傳遞 API Key
    Content-Type
    請求內容型別,固定為 application/json
    model
    圖像模型 ID,目前模型為 gemini-2.5-flash-image
    prompt
    必填,圖像文字描述
    n
    可選,產生張數,範圍 1 到 10,預設 1
    size
    可選,輸出圖像尺寸,支援值取決於模型
    response_format
    可選,url 或 b64_json;部分模型不支援
    stream
    可選透傳欄位,目前圖像鏈路同步傳回

    基礎 URL、請求方法與必要請求頭,皆依當前模型的協議模板渲染。

    POSThttps://api.gate.ai/openai/v1/chat/completions
    欄位
    值
    Authorization
    驗證請求頭,使用 Bearer {API_KEY} 格式傳遞 API Key
    Content-Type
    請求內容型別,固定為 application/json
    model
    模型 ID,目前模型為 gemini-2.5-flash-image
    messages
    依順序排列的對話訊息陣列
    stream
    是否以 SSE 串流方式傳回結果

    基礎 URL、請求方法與必要請求頭,皆依當前模型的協議模板渲染。

    POSThttps://api.gate.ai/openai/v1/images/edits
    欄位
    值
    Authorization
    驗證請求頭,使用 Bearer {API_KEY} 格式傳遞 API Key
    Content-Type
    請求內容型別,固定為 application/json
    model
    必填,圖像模型 ID,目前模型為 gemini-2.5-flash-image
    image
    必填,作為編輯輸入的參考圖檔案
    mask
    可選 PNG 遮罩,透明區域為編輯區域
    prompt
    必填,編輯描述,最長 1000 個字元
    n
    可選,產生張數,範圍 1 到 10,預設 1
    size
    可選,輸出圖像尺寸,支援值取決於模型
    response_format
    可選,url 或 b64_json;部分模型不支援

    基礎 URL、請求方法與必要請求頭,皆依當前模型的協議模板渲染。

    POSThttps://api.gate.ai/v1beta/models/{{model_id}}:generateContent
    欄位
    值
    Authorization
    驗證請求頭,使用 Bearer {API_KEY} 格式傳遞 API Key
    Content-Type
    請求內容型別,固定為 application/json
    model
    URL 路徑中的模型 ID,目前模型為 gemini-2.5-flash-image
    contents
    傳送給模型的對話內容陣列
    contents[].role
    訊息角色,使用者訊息使用 user
    contents[].parts[].text
    傳送給模型的文字內容
    alt
    串流請求使用的回應格式參數,設定為 sse

    相關模型

    Gemini 3.8 Flash

    Gemini 3.8 系列 Flash 檔,相對 3.7 Flash 在軟體工程、Agent 任務與多步推理上提升,適合高頻開發與 Agent 編排。

    Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image)

    系列中最輕量的圖像模型,快速完成出圖,支援角色一致性與精細圖像編輯,面向高吞吐生成流程與互動式視覺迭代。

    Gemini 3.5 Flash

    適用於高效率、多模態 AI 任務,以 Flash 等級的成本與速度,支援程式碼、推理、即時對話與 Agent 執行場景。

    Gemini 3.1 Flash Lite

    高效率多模態輕量模型,適用於低延遲、高並發的批量任務,如即時翻譯、分類與資料抽取,價格約為 Gemini 3 Flash 的一半。

    Gemma-4-31B

    開源權重稠密模型,數學推理與程式碼能力較前代明顯提升,原生支援 function calling,適合自架部署與 Agent 工作流。

    Nano Banana 2 (Gemini 3.1 Flash Image)

    圖像生成與編輯模型,畫質接近旗艦而出圖速度更快,可渲染清晰文字與寫實主體,適用於資訊圖表與行銷視覺製作。

    Gemini 3.1 Pro

    Google 最新模型,原生支援圖像與影片的強大推理。

    Gemini 3 Flash

    Gemini 3 系列的快速款,主打 Pro 級推理搭配 Flash 級延遲與成本,適合互動應用、Agent 工作流與高吞吐批量任務。

    Nano Banana Pro (Gemini 3 Pro Image)

    內建推理能力,擅長複雜多輪創作,最高 4K,可聯網增強。

    Gemini 2.5 Flash Lite

    Gemini 2.5 系列的輕量推理模型,主打超低延遲與成本效益,具備更快的 Token 生成速度與更高吞吐量。思考功能預設關閉,也可透過 API 啟用。