Source: https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/ Canonical: https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/ Language: zh-hant-tw # Google: Nano Banana 2.1 [Markdown](https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/facts.json) ## [Google: Nano Banana 2.1](https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/) Gemini Nano Banana 2.1 可透過對話，依文字與視覺素材生成及編輯圖像。它改善了文字呈現、資訊圖表版面及多回合一致性，為明確的視覺需求提供 1K–4K 輸出，並支援最多 14 張參考圖像。 - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/#method-0) - [**Ailoot Ultra · 圖片** `POST /v1/images/generations` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/google-gemini-nano-banana-2-1/#method-2) 關於模型 此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。 Gemini Nano Banana 2.1 是 Google 的圖像生成與對話式編輯模型。它是 Nano Banana 2 的更新版本，改善了視覺真實感、指令遵循、文字呈現，以及連續編輯時的角色一致性。其輸入表列出文字、圖像、影片與 PDF，輸出則為圖像及文字。適合製作產品場景、資訊圖表，或透過數次具體修改逐步發展的視覺系列。 模型提供 1K、2K 及 4K 輸出，預設為 1K。它未沿用 Nano Banana 2 的 0.5K 選項。文件列出的長寬比包括 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9，以及直長或全景格式 1:4、4:1、1:8、8:1。Google 表示，後述寬幅與直長格式在 2K、4K 下的拼接瑕疵已獲修正。解析度標籤代表尺寸級距，而非固定矩形：正方形 4K 圖像為 4096 × 4096，文件中的 16:9 4K 輸出則為 5504 × 3072。 文字是此視覺工作流程的重要部分。模型旨在呈現清晰可讀的風格化文字，並更準確地組織資訊圖表元素。請先準備確切的標題、標籤及閱讀順序，再要求圖像使用這些定稿文字。製作菜單、圖解或教學圖時，應說明文字說明與視覺元素的關係。Google 建議先建立文字，再要求圖像，讓視覺構圖從已確定的文字需求出發。 參考圖像融合支援最多 14 張圖像。文件所述能力包括最多四個角色的一致性，以及最多十個物件的忠實呈現。請為每張參考圖指定角色：必須保持可辨識的產品、角色外觀、預期背景或視覺風格。例如產品需求可寫成：「使用圖像 A 的瓶身形狀與標籤。使用圖像 B 的表面與光線。產品維持不變，將它放在摺好的毛巾旁，上方留出清楚空間放置提供的標題。」 Google Web Search 與 Image Search grounding 可為生成提供最新資訊及視覺脈絡。Image Search 以檢索到的網路圖像作為參考；標準網頁 grounding 則提供主題相關資訊。這適合需要事實依據的圖像，或外觀取決於真實物件的場景。圖像搜尋流程不支援為此目的檢索真實人物圖像。在 Google 記載的流程中，grounding 回應附有來源及署名中繼資料，因此應用程式應隨生成結果一併保留。 Thinking 可設定為 minimal、medium、high，此確切模型預設為 medium。它協助模型在最終輸出前處理構圖及較複雜的指令。圖像指南描述此過程中的中間構圖圖像；這些與預期交付的最終成果不同。請明確選擇最終版面、長寬比及解析度，不要期待單憑提示敘述就能決定所有輸出設定。 對話式編輯讓後續回合可修改既有結果的一部分：調整光線、移動物件，或在保留其他構圖的同時翻譯標籤。將先前圖像或互動帶入下一回合，並同時說明要修改與保留的特徵。角色系列應使用一致的外觀參考；若新角度或複雜姿勢很重要，則提供姿勢參考。實用的修改需求可以是：「保留產品、標籤與版面；只將背景改為較暖的灰色。」 模型表列出的輸入上限為 131,072 token，輸出上限為 32,768 token。此版本支援圖像生成與搜尋 grounding；音訊生成、程式碼執行、函式呼叫、結構化輸出、快取、檔案搜尋、URL context 及 Live API 則未列為支援項目。影片可以為生成的靜態圖像提供資訊，但不代表此模型能生成影片。Google 也指出，要求確切的圖像數量不一定會得到該數量。所有生成圖像均包含 SynthID 浮水印。 第一份實用需求應說明圖像用途、主體、構圖、光線、鏡頭視角、必要文字及輸出形狀。例如要求直式資訊圖表，包含三個有標籤的步驟、可讀標題及指定的色彩層級，再於下一次編輯前檢查文字及相對位置。結果可作為產品插圖、編輯圖像或設計參考，並將選定圖像與解說文字一併保留。 實用任務 ### 實用任務 英文技術範例 ``` Refine an approved poster background Edit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image. ``` #### 預期結果 ``` One edited poster with the original wording and layout preserved over a warm ivory background. ``` #### 檢查結果 ``` Compare every word and element position against the supplied poster, then inspect text contrast. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-nano-banana-2.1` [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) Google /`google/gemini-nano-banana-2.1` ### 入門 Gemini Nano Banana 2.1 可透過對話，依文字與視覺素材生成及編輯圖像。它改善了文字呈現、資訊圖表版面及多回合一致性，為明確的視覺需求提供 1K–4K 輸出，並支援最多 14 張參考圖像。 接受的輸入 文字 結果 文字 ### Ailoot 可用 · 輸入與方法 **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` 輸入 `text` 輸出 `text` 輸出格式 json 或 SSE | 欄位 | 類型 | 要求 | 值與限制 | 預設值 | | --- | --- | --- | --- | --- | | 欄位`model` | 類型`string` | 要求必填 | 值與限制 google/gemini-nano-banana-2.1 | 預設值— | | 欄位`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.003** / 1K Token 輸出 · 輸出 Token **$0.015** / 1K Token 輸入 · 讀取快取 **—** / 1K Token 輸入 · 寫入快取 **—** / 1K Token 輸入 · 寫入快取，1 小時 **—** / 1K Token 輸出 · 圖片輸出詞元 **$0.06** / 1K 圖片 Token | | 設定請求長度級距 1 | 費率表— | 上下文 Token 數大於0 | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token **$0.003** / 1K Token 輸出 · 輸出 Token **$0.015** / 1K Token 輸入 · 讀取快取 **—** / 1K Token 輸入 · 寫入快取 **—** / 1K Token 輸入 · 寫入快取，1 小時 **—** / 1K Token | #### 參考費率詳情 模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。 Google: Nano Banana 2.1 #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定Google: Nano Banana 2.1 · 預設設定 | 計費條件預設設定 | 費用 輸入 · 輸入 Token **US$0.003** / 1K Token 輸出 · 輸出 Token **US$0.015** / 1K Token 輸出 · 輸出圖片 **US$0.06** / 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-nano-banana-2.1", "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-nano-banana-2.1',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-nano-banana-2.1',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-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) #### 方法路徑別名 `/v1/images` #### 相關呼叫用 ID [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) **Ailoot Ultra · 圖片** `POST /v1/images/generations` `google/gemini-nano-banana-2.1` [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/zh-hant-tw/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=images) Google /`google/gemini-nano-banana-2.1` ### 入門 Gemini Nano Banana 2.1 可透過對話，依文字與視覺素材生成及編輯圖像。它改善了文字呈現、資訊圖表版面及多回合一致性，為明確的視覺需求提供 1K–4K 輸出，並支援最多 14 張參考圖像。 接受的輸入 文字 · 圖片 結果 圖片 ### Ailoot 可用 · 輸入與方法 **Ailoot Ultra · 圖片** `POST /v1/images/generations` 輸入 `text`, `image` 輸出 `image` | 欄位 | 類型 | 要求 | 值與限制 | 預設值 | | --- | --- | --- | --- | --- | | 欄位`model` | 類型`string` | 要求必填 | 值與限制 google/gemini-nano-banana-2.1 | 預設值— | | 欄位`prompt` | 類型`string` | 要求必填 | 值與限制 長度下限: 1 | 預設值— | | 欄位`resolution` | 類型`string` | 要求選填 | 值與限制 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.24576** 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 | 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-nano-banana-2.1', '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"