Source: https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/ Canonical: https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/ Language: zh-hant-tw # Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) [Markdown](https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/facts.json) ## [Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)](https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/) Nano Banana 2（Gemini 3.1 Flash Image Preview）依文字與視覺參考建立及編輯圖像。文件記載的優勢包括主體一致性、圖中文字與在地化、對話式修改，以及對構圖、長寬比及解析度的創意控制。 - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/#method-0) - [**Ailoot Ultra · 圖片** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/google-gemini-3-1-flash-image-preview/#method-2) 關於模型 此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。 Nano Banana 2 是 Google 用於圖像生成與對話式編輯的 Gemini 3.1 Flash Image 模型。此項目保留確切的 Preview 身分。書面描述可定義新視覺，輸入圖像則可確立要修改的主體、外觀或構圖。結果可包含圖像與附帶文字。Google 發布素材強調世界知識、文字呈現及主體一致性，以及透過相關回合逐步完善場景的能力。 需要依據來源建立視覺時，文件記載此模型可使用網頁及圖像搜尋資訊輔助生成。這可支援地點啟發的插圖，或根據提供資訊建立圖解等任務。請定義必須呈現的來源事實，並與藝術選擇區分。搜尋輔助生成不代表最終圖像的每個細節都是經驗證的陳述。產品、地標或圖解必須準確時，應提供權威參考並依其檢查輸出。 發布說明描述圖中文字呈現及在地化的改善。海報、資訊圖表或行銷樣稿應提供每個文字元素的確切措辭、語言及角色。依圖像指南建議，先定稿文案，再要求包含它的視覺。請說明閱讀順序及相對強調，避免標題、說明文字及圖解標籤混淆。用於出版前，應檢查拼字、標點及標籤與圖示元素的連結。 創意控制包括長寬比及解析度。發布新增 512 像素輸出，與 1K、2K、4K 選項並列，另加入 4:1、1:4、8:1、1:8 長寬比。開發者指南將 minimal thinking 列為預設，high thinking 則可用於更複雜構圖。構圖前應先選擇用途：直式限時動態、寬幅橫幅與精簡圖解，對主體及文字所需空間不同。這些設定描述開發者此系列的生成流程，不代表會自動縮放既有完成素材。 主體一致性應標示每個參考的角色：產品外觀、角色身分、背景或視覺風格。先說明要保留的細節，再指出要修改的元素。一個任務可以將提供的產品照片放入新場景，同時保留形狀、材質及可見品牌。插畫序列應保持相同參考，並定義哪些場景專屬細節可變動。更多參考無法取代對每張圖像貢獻的清楚指示。 對話式編輯適合具體修訂。可要求調整單一物件、背景或光線，同時保留已接受的構圖。開發者指南描述語意遮罩，以文字識別編輯區域。多回合工作應保留所選介面的對話及必要推理脈絡中繼資料；Gemini 3 指南說明 thought signatures 有助於攜帶該脈絡。描述保持不變的區域，是需要對照原圖檢查的指令，不是每個像素完全相同的保證。 Gemini 3 開發者表明確列出 gemini-3.1-flash-image-preview，輸入額度為 128K、輸出額度為 32K。記錄生成時請保留確切 Preview 模型名稱。應將可用參考、輸出及解析度設定，與來源圖像和請求一起保存，讓修訂可一致重現。修訂應使用相同來源參考，指定確切視覺變更，並保留已接受的各輸入角色。 圖像指南提醒，模型不一定遵循所要求的圖像數量，並指出生成圖像帶有 SynthID 標記。應檢查所有回傳圖像及附帶文字，而非假設結果是單一固定圖像。以預期顯示尺寸檢查主體身分、物件數量、圖中文字、構圖及參考忠實度。複雜場景應依邏輯順序指定元件，並正面描述所需外觀。實用成果是經檢查的視覺素材，並保留來源參考及確切模型身分，以利下一次編輯。 實用任務 ### 實用任務 英文技術範例 ``` Create a four-stage growing guide Create a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants. ``` #### 預期結果 ``` An image with four distinct growing stages in the specified order and a consistent illustration style. ``` #### 檢查結果 ``` Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) Google /`google/gemini-3.1-flash-image-preview` ### 入門 Nano Banana 2（Gemini 3.1 Flash Image Preview）依文字與視覺參考建立及編輯圖像。文件記載的優勢包括主體一致性、圖中文字與在地化、對話式修改，以及對構圖、長寬比及解析度的創意控制。 接受的輸入 文字 結果 文字 ### Ailoot 可用 · 輸入與方法 **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` 輸入 `text` 輸出 `text` 輸出格式 json 或 SSE | 欄位 | 類型 | 要求 | 值與限制 | 預設值 | | --- | --- | --- | --- | --- | | 欄位`model` | 類型`string` | 要求必填 | 值與限制 google/gemini-3.1-flash-image-preview | 預設值— | | 欄位`messages` | 類型`message[]` | 要求必填 | 值與限制 項目數下限: 1 | 預設值— | | 欄位`messages[].role` | 類型`string` | 要求必填 | 值與限制 範例：system, user, assistant, tool, function 條件: 這些角色由 原始碼中的相容型別明確表示；確切角色集合仍依模型而定。 依模型而定 | 預設值— | | 欄位`messages[].content` | 類型`string\|content_part[]\|null` | 要求選填 | 值與限制 | 預設值— | | 欄位`messages[].tool_calls` | 類型`tool_call[]` | 要求選填 | 值與限制 | 預設值— | | 欄位`messages[].tool_call_id` | 類型`string` | 要求選填 | 值與限制 適用條件: role=tool；使用實際回傳的 ID | 預設值— | | 欄位`messages[].name` | 類型`string` | 要求選填 | 值與限制 | 預設值— | | 欄位`messages[].reasoning_content` | 類型`string` | 要求選填 | 值與限制 適用條件: 此模型使用推理內容時，將實際回傳的推理內容帶回後續請求 | 預設值— | | 欄位`messages[].reasoning_details` | 類型`object\|array` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`max_tokens` | 類型`integer` | 要求選填 | 值與限制 最小值: 1 依模型而定 | 預設值— | | 欄位`max_completion_tokens` | 類型`integer` | 要求選填 | 值與限制 最小值: 1 依模型而定 | 預設值— | | 欄位`stream` | 類型`boolean` | 要求選填 | 值與限制 | 預設值false | | 欄位`stream_options.include_usage` | 類型`boolean` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`temperature` | 類型`number` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`top_p` | 類型`number` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`stop` | 類型`string\|string[]` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`tools` | 類型`function_tool[]` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`tools[].type` | 類型`string` | 要求選填 | 值與限制 function 依模型而定 | 預設值— | | 欄位`tools[].function.name` | 類型`string` | 要求必填 | 值與限制 適用條件: 已提供函式工具 | 預設值— | | 欄位`tools[].function.description` | 類型`string` | 要求選填 | 值與限制 | 預設值— | | 欄位`tools[].function.parameters` | 類型`JSON_schema` | 要求選填 | 值與限制 | 預設值— | | 欄位`tool_choice` | 類型`string\|object` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`parallel_tool_calls` | 類型`boolean` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`response_format` | 類型`object` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`reasoning_effort` | 類型`string` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`reasoning` | 類型`object` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`service_tier` | 類型`string` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`instructions` | 類型`string` | 要求選填 | 值與限制 相容性欄位 | 預設值— | | 欄位`functions` | 類型`function[]` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`function_call` | 類型`string\|object` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`prompt_cache_options` | 類型`object` | 要求選填 | 值與限制 依模型而定 | 預設值— | | 欄位`modalities` | 類型`string[]` | 要求選填 | 值與限制 text | 預設值— | | 欄位`provider` | 類型`object` | 要求選填 | 值與限制 條件: 此 Ultra 文字路由拒絕 provider.options | 預設值— | | 欄位`cache_control.ttl` | 類型`string` | 要求選填 | 值與限制 條件: 實際提示詞快取位置拒絕 1h | 預設值— | 輸入素材組合 **文字** · UTF8 文字 `messages[].content` 方法參數與生命週期 | 參數 | 規格 | | --- | --- | | 參數`content_type` | 規格application/json | | 參數`required` | 規格model, messages | | 參數`material_types` | 規格text | | 參數`messages` | 規格具有 role/content 結構的訊息陣列 | | 參數`file_material` | 規格實際 UTF-8 文件以原文文字插入；不推定檔案 ID | | 參數`optional_controls` | 規格stream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | 參數`control_scope` | 規格依模型而定；使用者函式工具與託管工具不同 | | 參數`output_modalities` | 規格text | | 參數`hosted_operations` | 規格false | | 參數`multimodal_input_binding` | 規格null | 生命週期： `synchronous_or_streamed` 將確切模型 ID 與 messages 一併送出。 上下文長度不是輸出上限。 文字檔案可提供原文文字；圖片／音訊／檔案物件輸入需要精確綁定。 ### 方案 費率資訊不會增加請求選項。支援的參數列於所選方法中。 快速模式 標準費率 選取快速模式時 flex 模式 標準費率 選取 flex 模式時 最高推理強度 標準費率 最高推理強度採用 default 調整值時 推理強度 · high 標準費率 推理強度設為 high 時 推理強度 · minimal 標準費率 推理強度設為 minimal 時 顯式快取計價 未啟用 請求顯式快取時 #### Ailoot 費率 #### 各設定的價格 請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。 | 設定 | 費率表 | 上下文 Token 數大於 | 上下文 Token 數小於或等於 | 費用 | | --- | --- | --- | --- | --- | | 設定詞元基本費率 | 費率表基本費率 | 上下文 Token 數大於— | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token **$0.001** / 1K Token 輸出 · 輸出 Token **$0.006** / 1K Token 輸入 · 讀取快取 **—** / 1K Token 輸入 · 寫入快取 **—** / 1K Token 輸入 · 寫入快取，1 小時 **—** / 1K Token 輸出 · 圖片輸出詞元 **$0.12** / 1K 圖片 Token | | 設定請求長度級距 1 | 費率表— | 上下文 Token 數大於0 | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token **$0.001** / 1K Token 輸出 · 輸出 Token **$0.006** / 1K Token 輸入 · 讀取快取 **—** / 1K Token 輸入 · 寫入快取 **—** / 1K Token 輸入 · 寫入快取，1 小時 **—** / 1K Token | #### 參考費率詳情 模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。 google/gemini-3.1-flash-image-preview #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定google/gemini-3.1-flash-image-preview · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 **US$0.001** / 1K Token 輸出 · 輸出 **US$0.12** / 1K Token | google/gemini-3.1-flash-image-preview #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定google/gemini-3.1-flash-image-preview · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 **US$0.001** / 1K Token 輸出 · 輸出 **US$0.12** / 1K Token | google/gemini-3.1-flash-image-preview #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定google/gemini-3.1-flash-image-preview · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 **US$0.00** 每次呼叫 輸出 · 輸出 **US$0.16** 每次呼叫 | google/gemini-3.1-flash-image-preview #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定google/gemini-3.1-flash-image-preview · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 **US$0.00** 每次呼叫 輸出 · 輸出 **US$0.32** 每次呼叫 | google/gemini-3.1-flash-image-preview #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定google/gemini-3.1-flash-image-preview · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 **US$0.00** 每次呼叫 輸出 · 輸出 **US$0.00** 每次呼叫 | Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 Token **US$0.001** / 1K Token 輸出 · 輸出 Token **US$0.006** / 1K Token 輸出 · 輸出圖片 **US$0.12** / 1K Token 輸出 · 網頁搜尋 **US$0.028** 每次搜尋 | Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/) ### 請求範例 #### Ailoot Ultra · OpenAI Chat curlPython SDKPython 串流 ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-3.1-flash-image-preview", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### 接收並儲存結果 #### Ailoot Ultra · OpenAI Chat json 或 SSE ##### 保留所有已完成的結果 請保留所有完整傳回的回應、檔案與內容區塊。 保留每個候選項及其內容／工具呼叫／推理。SSE 中依候選項／工具索引組合增量，保留最終完成原因與用量。 ##### 需要檢查原始回應時 保留請求／回應 ID 與標頭。未提供通用的文字工作擷取 URL。 回應欄位 | 欄位 | 類型 | | --- | --- | | 欄位`choices[].index` | 類型integer | | 欄位`choices[].message.content` | 類型string\|null | | 欄位`choices[].message.tool_calls` | 類型tool\_call\[\] | | 欄位`choices[].message.reasoning_content` | 類型string | | 欄位`choices[].message.reasoning_details` | 類型object\|array | | 欄位`choices[].finish_reason` | 類型string\|null | | 欄位`usage` | 類型object | 錯誤與後續步驟 | 回應 | 條件 | 下一步 | | --- | --- | --- | | 回應400 · `invalid_request_error` | 條件必要欄位、素材表示方式或參數值無效 | 下一步提出新的建立請求前，先修正指定欄位。 | ### 別名 #### 模型別名 **Ailoot Ultra** [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) #### 方法路徑別名 `/v1/images` #### 相關呼叫用 ID [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) **Ailoot Ultra · 圖片** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=images) Google /`google/gemini-3.1-flash-image-preview` ### 入門 Nano Banana 2（Gemini 3.1 Flash Image Preview）依文字與視覺參考建立及編輯圖像。文件記載的優勢包括主體一致性、圖中文字與在地化、對話式修改，以及對構圖、長寬比及解析度的創意控制。 接受的輸入 文字 · 圖片 結果 圖片 ### Ailoot 可用 · 輸入與方法 **Ailoot Ultra · 圖片** `POST /v1/images/generations` 輸入 `text`, `image` 輸出 `image` | 欄位 | 類型 | 要求 | 值與限制 | 預設值 | | --- | --- | --- | --- | --- | | 欄位`model` | 類型`string` | 要求必填 | 值與限制 google/gemini-3.1-flash-image-preview | 預設值— | | 欄位`prompt` | 類型`string` | 要求必填 | 值與限制 長度下限: 1 | 預設值— | | 欄位`resolution` | 類型`string` | 要求選填 | 值與限制 512, 1K, 2K, 4K | 預設值— | | 欄位`aspect_ratio` | 類型`string` | 要求選填 | 值與限制 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | 預設值— | | 欄位`n` | 類型`integer` | 要求選填 | 值與限制 最小值: 1 最大值: 1 | 預設值— | | 欄位`input_references` | 類型`array` | 要求選填 | 值與限制 項目數下限: 0 項目數上限: 14 | 預設值— | | 欄位`provider` | 類型`object` | 要求選填 | 值與限制 | 預設值— | 方法參數與生命週期 | 參數 | 規格 | | --- | --- | | 參數`content_type` | 規格application/json | | 參數`required` | 規格model, prompt | | 參數`material_types` | 規格text, image | 生命週期： `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · 實際回傳的 task\_id 或媒體庫紀錄 `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### 方案 ##### 最終費用的計算方式 顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。 費率資訊不會增加請求選項。支援的參數列於所選方法中。 快速模式 未指定 選取快速模式時 flex 模式 未指定 選取 flex 模式時 最高推理強度 未指定 最高推理強度採用 default 調整值時 #### 供比較的預估費率 #### 各設定的價格 請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。 | 設定 | 費率表 | 預估數量 | 費用 | | --- | --- | --- | --- | | 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用 輸入 · 輸入 Token · 僅供比較的估算 **—** / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 **—** / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 **—** / 1K Token | | 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 費用 輸出 · 預估生成費用 · 僅供比較的估算 **$0.49152** 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 | Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/) ### 請求範例 #### Ailoot Ultra · 圖片 curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-3.1-flash-image-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"