{ "aboutHtml": "

Gemini 4 Argon (batch) 是 Google 多模態推理模型中公開的 batch 標記版本。它保留 Argon 家族對軟體工程、數學與科學分析，以及大量證據上的多步驟推理之專注。此項目接受文字、影像、音訊、影片及 PDF 等檔案，並回傳文字。

整理一組獨立任務

有用的批次工作包含許多明確定義的項目，具有可比較的結果需求。文件集合可以對所有項目使用同一套擷取或比較標準。程式碼審查工作可以為一連串修改定義相同的審查問題。研究集合則可以要求每個來源套件提供相同的證據欄位。

請為每個工作項目提供識別，讓周邊應用程式將它與輸入及結果一起保留。工作可比較時，維持穩定指令，將項目特定的證據與問題放在個別任務中。這能讓完成輸出更容易比較，不會把不同文件或儲存庫修改混在一起。

長上下文與精確的輸出契約

公開的上下文視窗為 1,048,576 個 token。請將相關來源素材保留在一起，指出對任務重要的文件邊界、檔名或章節。要求服務於集合目的的輸出：已審查的修改、證據表、結構化發現集合，或簡潔報告。

batch 版本公布必要的推理配置，強度級別為 low、medium 及 high。請依必須解決的問題調整強度，並明確保留答案格式。另一個程序會使用回覆時，公開的結構化輸出能力可以支援在整組項目間保持可比較的欄位。工具呼叫也列為模型功能；應用程式定義並執行提供給任務的工具。

將版本識別與工作一起保留

標準與 batch 項目在 Argon 家族中有不同的公開識別碼。選擇此版本時，請保留確切的 batch 後綴，並將選擇與完成成果一起記錄。整理集合時，使用所選版本自己的容量及輸出需求。

需要大量輸出時，請在選擇工作項目大小前，規劃預期內容及所選 batch 模型規格的生成額度。batch 來源頁面將長輸出與標準項目分開討論。請將 batch 版本及選定生成額度與集合一起保留，讓每項都遵循相同輸出計畫。

一致地比較輸出

請使用集合中具代表性的樣本，評估所選指令是否產出必要證據及詳細程度。每項結果應將文件參照、擷取發現及未解決問題一起保留。需要修訂的項目應保留原始證據及選擇，讓修正後的結果仍可與集合其他項目比較。

另行發布、帶有 batch 標籤的 Argon 識別碼。
接受文字、圖片、音訊、影片及文件輸入，並輸出文字。
公開規格的上下文視窗為 1,048,576 個 token。
必須進行推理，且公開規格支援工具呼叫。
依結構定義產生結構化輸出，使結果可相互比較。

文件集合審查 — 一致的審查準則，以及每個項目各自可識別的來源資料套件。保留文件參照、可相互比較的審查結果。
變更集合審查 — 一系列採用共同預期行為與測試準則的程式碼變更。每項變更各自可識別的審查結果。
研究資料的結構化處理 — 彼此獨立的證據集合，要求相同的結果欄位。已整理好、可供比較的結構化研究結果集合。
詳盡的綜合整理 — 大量相互關聯的輸入資料與明確的報告大綱。在所選 batch 設定的生成額度內，產生內容充實的文字成果。

上下文 — 公開規格的 batch 上下文視窗：1,048,576 個 token。
變體 — 將 google/gemini-4-argon:batch 與標準識別碼分開保留。
輸出規劃 — 依所選 batch 設定的生成額度決定工作項目的大小，並明確指定預期的結果格式。
推理 — 推理為必要步驟；公開的投入程度為 low、medium 與 high。

", "aboutText": "Gemini 4 Argon (batch) 是 Google 多模態推理模型中公開的 batch 標記版本。它保留 Argon 家族對軟體工程、數學與科學分析，以及大量證據上的多步驟推理之專注。此項目接受文字、影像、音訊、影片及 PDF 等檔案，並回傳文字。\n\n### 整理一組獨立任務\n\n有用的批次工作包含許多明確定義的項目，具有可比較的結果需求。文件集合可以對所有項目使用同一套擷取或比較標準。程式碼審查工作可以為一連串修改定義相同的審查問題。研究集合則可以要求每個來源套件提供相同的證據欄位。\n\n請為每個工作項目提供識別，讓周邊應用程式將它與輸入及結果一起保留。工作可比較時，維持穩定指令，將項目特定的證據與問題放在個別任務中。這能讓完成輸出更容易比較，不會把不同文件或儲存庫修改混在一起。\n\n### 長上下文與精確的輸出契約\n\n公開的上下文視窗為 1,048,576 個 token。請將相關來源素材保留在一起，指出對任務重要的文件邊界、檔名或章節。要求服務於集合目的的輸出：已審查的修改、證據表、結構化發現集合，或簡潔報告。\n\nbatch 版本公布必要的推理配置，強度級別為 low、medium 及 high。請依必須解決的問題調整強度，並明確保留答案格式。另一個程序會使用回覆時，公開的結構化輸出能力可以支援在整組項目間保持可比較的欄位。工具呼叫也列為模型功能；應用程式定義並執行提供給任務的工具。\n\n### 將版本識別與工作一起保留\n\n標準與 batch 項目在 Argon 家族中有不同的公開識別碼。選擇此版本時，請保留確切的 batch 後綴，並將選擇與完成成果一起記錄。整理集合時，使用所選版本自己的容量及輸出需求。\n\n需要大量輸出時，請在選擇工作項目大小前，規劃預期內容及所選 batch 模型規格的生成額度。batch 來源頁面將長輸出與標準項目分開討論。請將 batch 版本及選定生成額度與集合一起保留，讓每項都遵循相同輸出計畫。\n\n### 一致地比較輸出\n\n請使用集合中具代表性的樣本，評估所選指令是否產出必要證據及詳細程度。每項結果應將文件參照、擷取發現及未解決問題一起保留。需要修訂的項目應保留原始證據及選擇，讓修正後的結果仍可與集合其他項目比較。\n\n- 另行發布、帶有 batch 標籤的 Argon 識別碼。\n- 接受文字、圖片、音訊、影片及文件輸入，並輸出文字。\n- 公開規格的上下文視窗為 1,048,576 個 token。\n- 必須進行推理，且公開規格支援工具呼叫。\n- 依結構定義產生結構化輸出，使結果可相互比較。\n\n- **文件集合審查** — 一致的審查準則，以及每個項目各自可識別的來源資料套件。保留文件參照、可相互比較的審查結果。\n- **變更集合審查** — 一系列採用共同預期行為與測試準則的程式碼變更。每項變更各自可識別的審查結果。\n- **研究資料的結構化處理** — 彼此獨立的證據集合，要求相同的結果欄位。已整理好、可供比較的結構化研究結果集合。\n- **詳盡的綜合整理** — 大量相互關聯的輸入資料與明確的報告大綱。在所選 batch 設定的生成額度內，產生內容充實的文字成果。\n\n- **上下文** — 公開規格的 batch 上下文視窗：1,048,576 個 token。\n- **變體** — 將 google/gemini-4-argon:batch 與標準識別碼分開保留。\n- **輸出規劃** — 依所選 batch 設定的生成額度決定工作項目的大小，並明確指定預期的結果格式。\n- **推理** — 推理為必要步驟；公開的投入程度為 low、medium 與 high。\n", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b072e568c58626965177a514644b7c251ad705a1aae80b42c151bd6c9410b3b3", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "zh-hant-tw", "methods": [ { "html": "

G

Google: Gemini 4 Argon (batch)

Google /google/gemini-4-argon:batch

入門

Gemini 4 Argon (batch) 是 Google 長上下文推理模型中另行列出的 batch 版本。它接受文字、影像、音訊、影片及文件，產出文字，並具備工具呼叫與結構化輸出功能。整理批次工作時，請將其識別碼及輸出額度與標準 Argon 分開保留。

接受的輸入: 文字
結果: 文字

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

Gemini 4 Argon (batch) 是 Google 多模態推理模型中公開的 batch 標記版本。它保留 Argon 家族對軟體工程、數學與科學分析，以及大量證據上的多步驟推理之專注。此項目接受文字、影像、音訊、影片及 PDF 等檔案，並回傳文字。

整理一組獨立任務

有用的批次工作包含許多明確定義的項目，具有可比較的結果需求。文件集合可以對所有項目使用同一套擷取或比較標準。程式碼審查工作可以為一連串修改定義相同的審查問題。研究集合則可以要求每個來源套件提供相同的證據欄位。

請為每個工作項目提供識別，讓周邊應用程式將它與輸入及結果一起保留。工作可比較時，維持穩定指令，將項目特定的證據與問題放在個別任務中。這能讓完成輸出更容易比較，不會把不同文件或儲存庫修改混在一起。

長上下文與精確的輸出契約

公開的上下文視窗為 1,048,576 個 token。請將相關來源素材保留在一起，指出對任務重要的文件邊界、檔名或章節。要求服務於集合目的的輸出：已審查的修改、證據表、結構化發現集合，或簡潔報告。

batch 版本公布必要的推理配置，強度級別為 low、medium 及 high。請依必須解決的問題調整強度，並明確保留答案格式。另一個程序會使用回覆時，公開的結構化輸出能力可以支援在整組項目間保持可比較的欄位。工具呼叫也列為模型功能；應用程式定義並執行提供給任務的工具。

將版本識別與工作一起保留

標準與 batch 項目在 Argon 家族中有不同的公開識別碼。選擇此版本時，請保留確切的 batch 後綴，並將選擇與完成成果一起記錄。整理集合時，使用所選版本自己的容量及輸出需求。

需要大量輸出時，請在選擇工作項目大小前，規劃預期內容及所選 batch 模型規格的生成額度。batch 來源頁面將長輸出與標準項目分開討論。請將 batch 版本及選定生成額度與集合一起保留，讓每項都遵循相同輸出計畫。

一致地比較輸出

請使用集合中具代表性的樣本，評估所選指令是否產出必要證據及詳細程度。每項結果應將文件參照、擷取發現及未解決問題一起保留。需要修訂的項目應保留原始證據及選擇，讓修正後的結果仍可與集合其他項目比較。

另行發布、帶有 batch 標籤的 Argon 識別碼。
接受文字、圖片、音訊、影片及文件輸入，並輸出文字。
公開規格的上下文視窗為 1,048,576 個 token。
必須進行推理，且公開規格支援工具呼叫。
依結構定義產生結構化輸出，使結果可相互比較。

文件集合審查 — 一致的審查準則，以及每個項目各自可識別的來源資料套件。保留文件參照、可相互比較的審查結果。
變更集合審查 — 一系列採用共同預期行為與測試準則的程式碼變更。每項變更各自可識別的審查結果。
研究資料的結構化處理 — 彼此獨立的證據集合，要求相同的結果欄位。已整理好、可供比較的結構化研究結果集合。
詳盡的綜合整理 — 大量相互關聯的輸入資料與明確的報告大綱。在所選 batch 設定的生成額度內，產生內容充實的文字成果。

上下文 — 公開規格的 batch 上下文視窗：1,048,576 個 token。
變體 — 將 google/gemini-4-argon:batch 與標準識別碼分開保留。
輸出規劃 — 依所選 batch 設定的生成額度決定工作項目的大小，並明確指定預期的結果格式。
推理 — 推理為必要步驟；公開的投入程度為 low、medium 與 high。

Ailoot 可用 · 輸入與方法

Ailoot Ultra · 批次處理（Batch） POST /v1/batches

輸入: text
輸出: text
輸出格式: 內嵌的 results[].response.body JSON

欄位	類型	要求	值與限制	預設值
欄位`endpoint`	類型`string`	要求必填	值與限制 /v1/chat/completions	預設值—
欄位`model`	類型`string`	要求必填	值與限制 google/gemini-4-argon:batch	預設值—
欄位`requests`	類型`batch_item[]`	要求必填	值與限制項目數下限: 1	預設值—
欄位`requests[].custom_id`	類型`string`	要求必填	值與限制	預設值—
欄位`requests[].body.messages`	類型`message[]`	要求必填	值與限制	預設值—
欄位`completion_window`	類型`string`	要求選填	值與限制 24h	預設值—
欄位`provider`	類型`object\|null`	要求選填	值與限制	預設值—
欄位`requests[].body.model`	類型`string`	要求選填	值與限制 google/gemini-4-argon:batch, google/gemini-4-argon	預設值—
欄位`provider.only`	類型`string[]`	要求選填	值與限制 google-vertex/global	預設值—
欄位`provider.allow_fallbacks`	類型`boolean\|null`	要求選填	值與限制 false, null	預設值—

方法參數與生命週期

參數	規格
參數`content_type`	規格application/json
參數`required`	規格endpoint, model, requests
參數`material_types`	規格text
參數`representation`	規格內嵌的 requests[]；每個項目皆含 custom_id 與 body
參數`request_endpoint_profile`	規格/v1/chat/completions
參數`file_material`	規格呼叫端可在本機將實際的 UTF-8 JSONL 讀入 requests[]。此流程不使用上傳用途、input_file_id 或檔案參照。若缺少客戶素材或素材為空，應在 POST 前停止準備。
參數`serialization_order`	規格endpoint, model, provider（如有提供）, completion_window（如有提供）, requests 放在最後
參數`optional_controls`	規格provider.only, provider.allow_fallbacks, completion_window
參數`schema_scope`	規格依文件規定的內嵌 Batch 封裝格式提供文字 Chat Completions 請求主體。

生命週期： asynchronous

GET /v1/batches/{operation_id} · 原始建立回應中實際回傳的 response.id；使用相同使用者／金鑰／群組

方案

費率資訊不會增加請求選項。支援的參數列於所選方法中。

快速模式: 未指定選取快速模式時
flex 模式: 未指定選取 flex 模式時
最高推理強度: 未指定最高推理強度採用 default 調整值時
顯式快取計價: 未啟用請求顯式快取時

Ailoot 費率

各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

設定	費率表	上下文 Token 數大於	上下文 Token 數小於或等於	費用
設定詞元基本費率	費率表基本費率	上下文 Token 數大於—	上下文 Token 數小於或等於無上限	費用輸入 · 輸入 Token $0.002 / 1K Token 輸出 · 輸出 Token $0.01 / 1K Token 輸入 · 讀取快取 $0.0001 / 1K Token 輸入 · 寫入快取 $0.000375 / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token
設定請求長度級距 1	費率表—	上下文 Token 數大於0	上下文 Token 數小於或等於無上限	費用輸入 · 輸入 Token $0.002 / 1K Token 輸出 · 輸出 Token $0.01 / 1K Token 輸入 · 讀取快取 $0.0001 / 1K Token 輸入 · 寫入快取 $0.000375 / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot Ultra · 批次處理（Batch）

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-4-argon:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\n

import json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n    path = Path(customer_path)\n    if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n    if not items: raise ValueError("Customer JSONL contains no requests")\n    ids = set()\n    for item in items:\n        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n        cid = item["custom_id"]\n        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n        ids.add(cid)\n        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n        supplied_model = item["body"].get("model")\n        if supplied_model is not None and supplied_model not in ['google/gemini-4-argon:batch', 'google/gemini-4-argon']: raise ValueError("body.model must be an exact documented caller or wire ID")\n    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-4-argon:batch", "requests":items}\n\nif __name__ == "__main__":\n    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n    body = prepare_requests(material)\n    key = os.environ.get("AILOOT_API_KEY", "")\n    if not key: raise SystemExit("Set AILOOT_API_KEY")\n    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n    with urlopen(request) as response:\n        raw = response.read()\n        Path("batch-create-response.json").write_bytes(raw)\n        print(raw.decode("utf-8"))\n

import json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n    raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n    raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\n

接收並儲存結果

Ailoot Ultra · 批次處理（Batch）

內嵌的 results[].response.body JSON

GET /v1/batches/{operation_id}

查看工作狀態

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\n

保留所有已完成的結果

請保留所有完整傳回的回應、檔案與內容區塊。

保留完整的原始狀態 JSON、每個結果／custom_id，以及完整的回應或錯誤主體。將已完成的 results[] 儲存為 JSONL，不得篩除任何項目。

需要檢查原始回應時

保留原始作業 ID。503 result_pending_check 回應帶有 X-Should-Retry:false；請勿重新提交狀態不明的原始批次。

回應欄位

欄位	類型
欄位`results[].custom_id`	類型string
欄位`results[].response.body.choices[].message.content`	類型string\|null
欄位`results[].error`	類型object\|null
欄位`usage`	類型object\|null
欄位`id`	類型string
欄位`model`	類型string
欄位`endpoint`	類型string
欄位`status`	類型string
欄位`request_counts`	類型object
欄位`results[].id`	類型string
欄位`results[].response.status_code`	類型integer
欄位`results[].response.request_id`	類型string

錯誤與後續步驟

回應	條件	下一步
回應400 · `invalid_request_error`	條件文件規定的內嵌封裝格式無效、索引鍵重複、項目識別有誤，或與已設定的模型能力衝突。	下一步再次提交前，請先修正指出的欄位。
回應401 · `authentication_error`	條件API 金鑰無效。	下一步使用已獲授權的 Ailoot 金鑰。
回應403 · `permission_error`	條件批次處理群組無法使用。	下一步檢查金鑰／群組的使用權限。
回應422 · `invalid_request_error`	條件批次處理採用餘額計費；透過訂閱建立批次的請求會遭拒絕。	下一步使用已獲授權、以餘額計費的群組。
回應422 · `price_unavailable`	條件無法為批次輸入估價。	下一步保留回應；使用文件規定的該 API 家族輸入格式。
回應402 · `billing_error`	條件批次處理的預留額度無法取得。	下一步提交新請求前，請先解決請求受理問題。
回應503 · `price_unavailable`	條件批次處理方法的價格／原生費率無法取得。	下一步保留回應；請勿替換價格。
回應503 · `api_error`	條件指定的供應商路由無法使用。	下一步保留回應，以供修復路由。
回應503 · `result_pending_check`	條件原始結果需要檢查；X-Should-Retry:false。	下一步保留原始 operation_id/id 並讀取其狀態；請勿重複原始 POST。
回應404 · `not_found`	條件查詢批次狀態所需的作業不存在，或屬於其他身分。	下一步使用完全相同的原始 id，以及相同的使用者／金鑰／群組。

別名

模型別名

Ailoot Ultra google/gemini-4-argon:batch

方法路徑別名

請使用上方列出的 API 方法路徑。

相關呼叫用 ID

google/gemini-4-argon:batch

", "method_identity": { "effective_request_model_id": "google/gemini-4-argon:batch", "fmt": "batches", "http": "POST", "path": "/v1/batches", "request_model_id": "google/gemini-4-argon:batch", "route_label": "Ultra" }, "method_key": "Ultra|batches|/v1/batches|google%2Fgemini-4-argon%3Abatch", "ordinal": 0, "rawMethod": { "available": null, "cache_read": 0.1, "cache_write": 0.375, "cache_write_1h": null, "contract": { "data": { "all_results": "Preserve full JSON and every result; provider real IDs are only read from actual returned responses.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "errors": [ { "code": null, "condition": "文件規定的內嵌封裝格式無效、索引鍵重複、項目識別有誤，或與已設定的模型能力衝突。", "http_status": 400, "recovery": "再次提交前，請先修正指出的欄位。", "type": "invalid_request_error" }, { "code": null, "condition": "API 金鑰無效。", "http_status": 401, "recovery": "使用已獲授權的 Ailoot 金鑰。", "type": "authentication_error" }, { "code": null, "condition": "批次處理群組無法使用。", "http_status": 403, "recovery": "檢查金鑰／群組的使用權限。", "type": "permission_error" }, { "code": null, "condition": "批次處理採用餘額計費；透過訂閱建立批次的請求會遭拒絕。", "http_status": 422, "recovery": "使用已獲授權、以餘額計費的群組。", "type": "invalid_request_error" }, { "code": null, "condition": "無法為批次輸入估價。", "http_status": 422, "recovery": "保留回應；使用文件規定的該 API 家族輸入格式。", "type": "price_unavailable" }, { "code": null, "condition": "批次處理的預留額度無法取得。", "http_status": 402, "recovery": "提交新請求前，請先解決請求受理問題。", "type": "billing_error" }, { "code": null, "condition": "批次處理方法的價格／原生費率無法取得。", "http_status": 503, "recovery": "保留回應；請勿替換價格。", "type": "price_unavailable" }, { "code": null, "condition": "指定的供應商路由無法使用。", "http_status": 503, "recovery": "保留回應，以供修復路由。", "type": "api_error" }, { "code": "result_pending_check", "condition": "原始結果需要檢查；X-Should-Retry:false。", "http_status": 503, "recovery": "保留原始 operation_id/id 並讀取其狀態；請勿重複原始 POST。", "type": null }, { "code": "not_found", "condition": "查詢批次狀態所需的作業不存在，或屬於其他身分。", "http_status": 404, "recovery": "使用完全相同的原始 id，以及相同的使用者／金鑰／群組。", "type": null } ], "example_body": { "endpoint": "/v1/chat/completions", "model": "google/gemini-4-argon:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "input_constraints": [ "Use the exact shown :batch model ID.", "Each custom_id must be nonempty and unique within the batch.", "Keep requests last in the serialized body; duplicate JSON keys are rejected.", "Each body.model is omitted or equals the exact batch caller or its documented base ID.", "Per-item provider, service_tier and input_type are outside this batch profile.", "stream is omitted or false.", "Supply text messages for this Chat batch profile; image/audio/file/video objects, hosted tools and cache-control fields are outside this profile.", "If body.model is present, use only the exact caller or wire ID listed here; no suffix conversion is needed.", "For google/ wire IDs, all items use an identical response_format." ], "outputs": { "all_results": "保留完整的原始狀態 JSON、每個結果／custom_id，以及完整的回應或錯誤主體。將已完成的 results[] 儲存為 JSONL，不得篩除任何項目。", "enclosing_family": "batch", "family": "text", "fields": [ { "name": "results[].custom_id", "type": "string" }, { "name": "results[].response.body.choices[].message.content", "type": "string|null" }, { "name": "results[].error", "type": "object|null" }, { "name": "usage", "type": "object|null" }, { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "endpoint", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "request_counts", "type": "object" }, { "description": null, "name": "results[].id", "type": "string" }, { "description": null, "name": "results[].response.status_code", "type": "integer" }, { "description": null, "name": "results[].response.request_id", "type": "string" } ], "format": "內嵌的 results[].response.body JSON" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "/v1/chat/completions" ], "enum_known": true, "name": "endpoint", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-4-argon:batch" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_items": 1, "name": "requests", "required": true, "type": "batch_item[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].custom_id", "required": true, "type": "string", "unique_within_batch": true }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].body.messages", "required": true, "type": "message[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "24h" ], "enum_known": true, "name": "completion_window", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "provider", "required": false, "type": "object|null" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-4-argon:batch", "google/gemini-4-argon" ], "enum_known": true, "name": "requests[].body.model", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ [ "google-vertex/global" ] ], "enum_known": true, "name": "provider.only", "required": false, "type": "string[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, null ], "enum_known": true, "name": "provider.allow_fallbacks", "required": false, "type": "boolean|null" } ], "provider_policy": { "allow_fallbacks": false, "configured_only": [ "google-vertex/global" ], "per_item_override": false, "when_omitted": "Current Source injects the exact persisted declaration before fresh submission." }, "request_schema": { "additionalProperties": false, "properties": { "completion_window": { "enum": [ "24h" ], "type": "string" }, "endpoint": { "enum": [ "/v1/chat/completions" ], "type": "string" }, "model": { "enum": [ "google/gemini-4-argon:batch" ], "type": "string" }, "provider": { "additionalProperties": false, "properties": { "allow_fallbacks": { "enum": [ false, null ], "type": [ "boolean", "null" ] }, "only": { "enum": [ [ "google-vertex/global" ] ], "items": { "enum": [ "google-vertex/global" ], "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "type": [ "object", "null" ] }, "requests": { "items": { "additionalProperties": false, "properties": { "body": { "additionalProperties": true, "properties": { "max_tokens": { "minimum": 1, "type": "integer" }, "messages": { "items": { "properties": { "content": { "type": "string" }, "role": { "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "model": { "enum": [ "google/gemini-4-argon:batch", "google/gemini-4-argon" ], "type": "string" } }, "required": [ "messages" ], "type": "object" }, "custom_id": { "minLength": 1, "type": "string" } }, "required": [ "custom_id", "body" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "endpoint", "model", "requests" ], "type": "object" }, "schema_template": { "endpoint": "/v1/chat/completions", "model": "google/gemini-4-argon:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "unsupported": [ "Files/input_file_id batch upload workflow", "active cancel route", "public batch list/delete/result-download route", "model-name-derived capability or weights equivalence" ] }, "input": { "content_type": "application/json", "file_material": "呼叫端可在本機將實際的 UTF-8 JSONL 讀入 requests[]。此流程不使用上傳用途、input_file_id 或檔案參照。若缺少客戶素材或素材為空，應在 POST 前停止準備。", "material_types": [ "text" ], "optional_controls": [ "provider.only", "provider.allow_fallbacks", "completion_window" ], "representation": "內嵌的 requests[]；每個項目皆含 custom_id 與 body", "request_endpoint_profile": "/v1/chat/completions", "required": [ "endpoint", "model", "requests" ], "schema_scope": "依文件規定的內嵌 Batch 封裝格式提供文字 Chat Completions 請求主體。", "serialization_order": [ "endpoint", "model", "provider（如有提供）", "completion_window（如有提供）", "requests 放在最後" ] }, "lifecycle": { "cancel": null, "create": { "accepted_status": 202, "http": "POST", "path": "/v1/batches" }, "delete": null, "file_upload": null, "mode": "asynchronous", "observed_status_values": [ "validating", "in_progress", "finalizing", "completed", "failed", "expired", "cancelling", "cancelled" ], "owned_results": { "behavior": "Completed results are saved as owned JSONL, read back byte-for-byte and registered in the existing media library before publication after settlement. Status returns inline results; no separate Batch download route is added.", "format": "application/x-ndjson", "public_url_field_in_status": null }, "status": { "http": "GET", "id_source": "原始建立回應中實際回傳的 response.id；使用相同使用者／金鑰／群組", "path": "/v1/batches/{operation_id}" }, "terminal": [ "completed", "failed", "expired", "cancelled" ], "unknown": "保留原始作業 ID。503 result_pending_check 回應帶有 X-Should-Retry:false；請勿重新提交狀態不明的原始批次。" }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/batches" }, "output": { "all_results": "Preserve the full original status JSON, every result/custom_id and complete response or error body. Save completed results[] as JSONL without filtering.", "family": "batch", "format": "JSON; completed results[] are returned inline and can be saved as JSONL." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "詞元基本費率", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "請求長度級距 1", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{\"endpoint\":\"/v1/chat/completions\",\"model\":\"google/gemini-4-argon:batch\",\"requests\":[{\"custom_id\":\"req-0001\",\"body\":{\"messages\":[{\"role\":\"user\",\"content\":\"Hello!\"}],\"max_tokens\":16}}]}')\nPath(\"batch-request.json\").write_text(json.dumps(body,ensure_ascii=False),encoding=\"utf-8\")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\n", "label": "curl · retained fixture", "language": "bash" }, { "code": "import json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError(\"Customer JSONL file is missing\")\n items = [json.loads(line) for line in path.read_text(encoding=\"utf-8\").splitlines() if line.strip()]\n if not items: raise ValueError(\"Customer JSONL contains no requests\")\n ids = set()\n for item in items:\n if set(item) != {\"custom_id\", \"body\"}: raise ValueError(\"Each item needs custom_id and body\")\n cid = item[\"custom_id\"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError(\"custom_id must be nonempty and unique\")\n ids.add(cid)\n if not isinstance(item[\"body\"], dict) or not item[\"body\"].get(\"messages\"): raise ValueError(\"Supply actual text messages\")\n supplied_model = item[\"body\"].get(\"model\")\n if supplied_model is not None and supplied_model not in ['google/gemini-4-argon:batch', 'google/gemini-4-argon']: raise ValueError(\"body.model must be an exact documented caller or wire ID\")\n return {\"endpoint\":\"/v1/chat/completions\", \"model\":\"google/gemini-4-argon:batch\", \"requests\":items}\n\nif __name__ == \"__main__\":\n material = os.environ.get(\"AILOOT_BATCH_REQUESTS_JSONL\", \"\")\n if not material: raise SystemExit(\"Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file\")\n body = prepare_requests(material)\n key = os.environ.get(\"AILOOT_API_KEY\", \"\")\n if not key: raise SystemExit(\"Set AILOOT_API_KEY\")\n request = Request(\"https://api.ailoot.ai/v1/batches\", data=json.dumps(body, ensure_ascii=False).encode(\"utf-8\"), headers={\"Authorization\":\"Bearer \" + key, \"Content-Type\":\"application/json\"}, method=\"POST\")\n with urlopen(request) as response:\n raw = response.read()\n Path(\"batch-create-response.json\").write_bytes(raw)\n print(raw.decode(\"utf-8\"))\n", "label": "Python HTTP · actual customer JSONL", "language": "python" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nBATCH_OPERATION_ID=\"$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path(\"batch-create-response.json\").read_text(encoding=\"utf-8\"))\noperation = response.get(\"id\")\nif not isinstance(operation, str) or not operation: raise SystemExit(\"No actual original operation ID; preserve the response and do not resubmit\")\nprint(quote(operation, safe=\"\"))\nPY_ID\n)\"\ncurl --fail-with-body --silent --show-error \"https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -o batch-status-response.json\n", "label": "curl · original operation status", "language": "bash" }, { "code": "import json\nfrom pathlib import Path\nraw = Path(\"batch-status-response.json\").read_bytes()\nresponse = json.loads(raw)\nif response.get(\"status\") != \"completed\":\n raise SystemExit(\"Keep the original operation; read its status without resubmitting\")\nresults = response.get(\"results\")\nif not isinstance(results, list) or not results:\n raise SystemExit(\"Preserve the original response; completed results are missing\")\nPath(\"batch-results.jsonl\").write_text(\"\".join(json.dumps(item, ensure_ascii=False) + \"\\n\" for item in results), encoding=\"utf-8\")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\n", "label": "Python · save every completed result", "language": "python" } ], "family": "batch", "fast_multiplier": null, "flex_multiplier": null, "fmt": "batches", "hints": [ "Read your actual request items before submission; inline requests are required.", "Keep the returned operation ID and every result. Never replay an unknown submission." ], "http": "POST", "in": 2, "input": [ "text" ], "label": "批次處理（Batch）", "max_out": null, "max_reasoning_effort_multiplier": null, "out": 10, "output": [ "text" ], "path": "/v1/batches", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" }, { "label": "Explicit cache pricing", "value": "Not enabled", "when": "When explicit cache is requested" } ], "pricing": { "billing_mode": "token", "image_input_price": null, "image_output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Request-length tier 1", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "request_model_id": "google/gemini-4-argon:batch", "route_label": "Ultra", "status_reads": [ "GET /v1/batches/{operation_id}" ], "tiers": [ { "cache_read": 0.1, "cache_read_multiplier": null, "cache_write": 0.375, "cache_write_1h": null, "cache_write_multiplier": null, "created_at": "0001-01-01T00:00:00Z", "in": 2, "input_multiplier": null, "max": null, "max_tokens": null, "min": 0, "min_tokens": 0, "out": 10, "output_multiplier": null, "per_request_price": null, "sort_order": 0, "tier_label": "", "updated_at": "0001-01-01T00:00:00Z" } ], "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } } ], "model_id": "google/gemini-4-argon:batch", "nativeProvenance": { "input_facts_canonical_sha256": "6dfce47826f262ae3cacf8fde5e251a5ccbddc49f74dbca70e42f0ba627d199c", "input_html_sha256": "9038aafa4b36fe4bef53ee553729129da9bd47584b5af9d1ddb9b04f027f56f9", "private_audit_sha256": "c227b85e052286902531962ba449d186e15562b6a3f0d97bd045ae9431a448ae", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/zh-hant-tw/google-gemini-4-argon-u003a-batch/", "description": "Gemini 4 Argon (batch) 是 Google 長上下文推理模型中另行列出的 batch 版本。它接受文字、影像、音訊、影片及文件，產出文字，並具備工具呼叫與結構化輸出功能。整理批次工作時，請將其識別碼及輸出額度與標準 Argon 分開保留。", "locale": "zh-hant-tw", "md_url": "https://ailoot.ai/models/zh-hant-tw/google-gemini-4-argon-u003a-batch/index.md", "title": "Google: Gemini 4 Argon (batch) — Ailoot", "url": "https://ailoot.ai/models/zh-hant-tw/google-gemini-4-argon-u003a-batch/" }, "rawModel": { "about": "Gemini 4 Argon (batch) 是 Google 多模態推理模型中公開的 batch 標記版本。它保留 Argon 家族對軟體工程、數學與科學分析，以及大量證據上的多步驟推理之專注。此項目接受文字、影像、音訊、影片及 PDF 等檔案，並回傳文字。\n\n### 整理一組獨立任務\n\n有用的批次工作包含許多明確定義的項目，具有可比較的結果需求。文件集合可以對所有項目使用同一套擷取或比較標準。程式碼審查工作可以為一連串修改定義相同的審查問題。研究集合則可以要求每個來源套件提供相同的證據欄位。\n\n請為每個工作項目提供識別，讓周邊應用程式將它與輸入及結果一起保留。工作可比較時，維持穩定指令，將項目特定的證據與問題放在個別任務中。這能讓完成輸出更容易比較，不會把不同文件或儲存庫修改混在一起。\n\n### 長上下文與精確的輸出契約\n\n公開的上下文視窗為 1,048,576 個 token。請將相關來源素材保留在一起，指出對任務重要的文件邊界、檔名或章節。要求服務於集合目的的輸出：已審查的修改、證據表、結構化發現集合，或簡潔報告。\n\nbatch 版本公布必要的推理配置，強度級別為 low、medium 及 high。請依必須解決的問題調整強度，並明確保留答案格式。另一個程序會使用回覆時，公開的結構化輸出能力可以支援在整組項目間保持可比較的欄位。工具呼叫也列為模型功能；應用程式定義並執行提供給任務的工具。\n\n### 將版本識別與工作一起保留\n\n標準與 batch 項目在 Argon 家族中有不同的公開識別碼。選擇此版本時，請保留確切的 batch 後綴，並將選擇與完成成果一起記錄。整理集合時，使用所選版本自己的容量及輸出需求。\n\n需要大量輸出時，請在選擇工作項目大小前，規劃預期內容及所選 batch 模型規格的生成額度。batch 來源頁面將長輸出與標準項目分開討論。請將 batch 版本及選定生成額度與集合一起保留，讓每項都遵循相同輸出計畫。\n\n### 一致地比較輸出\n\n請使用集合中具代表性的樣本，評估所選指令是否產出必要證據及詳細程度。每項結果應將文件參照、擷取發現及未解決問題一起保留。需要修訂的項目應保留原始證據及選擇，讓修正後的結果仍可與集合其他項目比較。\n\n- 另行發布、帶有 batch 標籤的 Argon 識別碼。\n- 接受文字、圖片、音訊、影片及文件輸入，並輸出文字。\n- 公開規格的上下文視窗為 1,048,576 個 token。\n- 必須進行推理，且公開規格支援工具呼叫。\n- 依結構定義產生結構化輸出，使結果可相互比較。\n\n- **文件集合審查** — 一致的審查準則，以及每個項目各自可識別的來源資料套件。保留文件參照、可相互比較的審查結果。\n- **變更集合審查** — 一系列採用共同預期行為與測試準則的程式碼變更。每項變更各自可識別的審查結果。\n- **研究資料的結構化處理** — 彼此獨立的證據集合，要求相同的結果欄位。已整理好、可供比較的結構化研究結果集合。\n- **詳盡的綜合整理** — 大量相互關聯的輸入資料與明確的報告大綱。在所選 batch 設定的生成額度內，產生內容充實的文字成果。\n\n- **上下文** — 公開規格的 batch 上下文視窗：1,048,576 個 token。\n- **變體** — 將 google/gemini-4-argon:batch 與標準識別碼分開保留。\n- **輸出規劃** — 依所選 batch 設定的生成額度決定工作項目的大小，並明確指定預期的結果格式。\n- **推理** — 推理為必要步驟；公開的投入程度為 low、medium 與 high。\n", "alias_of": null, "aliases": [], "author": "Google", "capabilities": { "context_length": 1048576, "manufacturer_input": [ "audio", "file", "image", "text", "video" ], "manufacturer_output": [ "text" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" } ], "summary": "完整的設定價格資訊請見詳細資料。" } ], "ctx": null, "formats": [ "batches" ], "id": "google/gemini-4-argon:batch", "input": [ "text" ], "kind": "text", "max_out": null, "methods": [ { "available": null, "cache_read": 0.1, "cache_write": 0.375, "cache_write_1h": null, "contract": { "data": { "all_results": "Preserve full JSON and every result; provider real IDs are only read from actual returned responses.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "errors": [ { "code": null, "condition": "文件規定的內嵌封裝格式無效、索引鍵重複、項目識別有誤，或與已設定的模型能力衝突。", "http_status": 400, "recovery": "再次提交前，請先修正指出的欄位。", "type": "invalid_request_error" }, { "code": null, "condition": "API 金鑰無效。", "http_status": 401, "recovery": "使用已獲授權的 Ailoot 金鑰。", "type": "authentication_error" }, { "code": null, "condition": "批次處理群組無法使用。", "http_status": 403, "recovery": "檢查金鑰／群組的使用權限。", "type": "permission_error" }, { "code": null, "condition": "批次處理採用餘額計費；透過訂閱建立批次的請求會遭拒絕。", "http_status": 422, "recovery": "使用已獲授權、以餘額計費的群組。", "type": "invalid_request_error" }, { "code": null, "condition": "無法為批次輸入估價。", "http_status": 422, "recovery": "保留回應；使用文件規定的該 API 家族輸入格式。", "type": "price_unavailable" }, { "code": null, "condition": "批次處理的預留額度無法取得。", "http_status": 402, "recovery": "提交新請求前，請先解決請求受理問題。", "type": "billing_error" }, { "code": null, "condition": "批次處理方法的價格／原生費率無法取得。", "http_status": 503, "recovery": "保留回應；請勿替換價格。", "type": "price_unavailable" }, { "code": null, "condition": "指定的供應商路由無法使用。", "http_status": 503, "recovery": "保留回應，以供修復路由。", "type": "api_error" }, { "code": "result_pending_check", "condition": "原始結果需要檢查；X-Should-Retry:false。", "http_status": 503, "recovery": "保留原始 operation_id/id 並讀取其狀態；請勿重複原始 POST。", "type": null }, { "code": "not_found", "condition": "查詢批次狀態所需的作業不存在，或屬於其他身分。", "http_status": 404, "recovery": "使用完全相同的原始 id，以及相同的使用者／金鑰／群組。", "type": null } ], "example_body": { "endpoint": "/v1/chat/completions", "model": "google/gemini-4-argon:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "input_constraints": [ "Use the exact shown :batch model ID.", "Each custom_id must be nonempty and unique within the batch.", "Keep requests last in the serialized body; duplicate JSON keys are rejected.", "Each body.model is omitted or equals the exact batch caller or its documented base ID.", "Per-item provider, service_tier and input_type are outside this batch profile.", "stream is omitted or false.", "Supply text messages for this Chat batch profile; image/audio/file/video objects, hosted tools and cache-control fields are outside this profile.", "If body.model is present, use only the exact caller or wire ID listed here; no suffix conversion is needed.", "For google/ wire IDs, all items use an identical response_format." ], "outputs": { "all_results": "保留完整的原始狀態 JSON、每個結果／custom_id，以及完整的回應或錯誤主體。將已完成的 results[] 儲存為 JSONL，不得篩除任何項目。", "enclosing_family": "batch", "family": "text", "fields": [ { "name": "results[].custom_id", "type": "string" }, { "name": "results[].response.body.choices[].message.content", "type": "string|null" }, { "name": "results[].error", "type": "object|null" }, { "name": "usage", "type": "object|null" }, { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "endpoint", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "request_counts", "type": "object" }, { "description": null, "name": "results[].id", "type": "string" }, { "description": null, "name": "results[].response.status_code", "type": "integer" }, { "description": null, "name": "results[].response.request_id", "type": "string" } ], "format": "內嵌的 results[].response.body JSON" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "/v1/chat/completions" ], "enum_known": true, "name": "endpoint", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-4-argon:batch" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_items": 1, "name": "requests", "required": true, "type": "batch_item[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].custom_id", "required": true, "type": "string", "unique_within_batch": true }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].body.messages", "required": true, "type": "message[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "24h" ], "enum_known": true, "name": "completion_window", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "provider", "required": false, "type": "object|null" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-4-argon:batch", "google/gemini-4-argon" ], "enum_known": true, "name": "requests[].body.model", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ [ "google-vertex/global" ] ], "enum_known": true, "name": "provider.only", "required": false, "type": "string[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, null ], "enum_known": true, "name": "provider.allow_fallbacks", "required": false, "type": "boolean|null" } ], "provider_policy": { "allow_fallbacks": false, "configured_only": [ "google-vertex/global" ], "per_item_override": false, "when_omitted": "Current Source injects the exact persisted declaration before fresh submission." }, "request_schema": { "additionalProperties": false, "properties": { "completion_window": { "enum": [ "24h" ], "type": "string" }, "endpoint": { "enum": [ "/v1/chat/completions" ], "type": "string" }, "model": { "enum": [ "google/gemini-4-argon:batch" ], "type": "string" }, "provider": { "additionalProperties": false, "properties": { "allow_fallbacks": { "enum": [ false, null ], "type": [ "boolean", "null" ] }, "only": { "enum": [ [ "google-vertex/global" ] ], "items": { "enum": [ "google-vertex/global" ], "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "type": [ "object", "null" ] }, "requests": { "items": { "additionalProperties": false, "properties": { "body": { "additionalProperties": true, "properties": { "max_tokens": { "minimum": 1, "type": "integer" }, "messages": { "items": { "properties": { "content": { "type": "string" }, "role": { "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "model": { "enum": [ "google/gemini-4-argon:batch", "google/gemini-4-argon" ], "type": "string" } }, "required": [ "messages" ], "type": "object" }, "custom_id": { "minLength": 1, "type": "string" } }, "required": [ "custom_id", "body" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "endpoint", "model", "requests" ], "type": "object" }, "schema_template": { "endpoint": "/v1/chat/completions", "model": "google/gemini-4-argon:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "unsupported": [ "Files/input_file_id batch upload workflow", "active cancel route", "public batch list/delete/result-download route", "model-name-derived capability or weights equivalence" ] }, "input": { "content_type": "application/json", "file_material": "呼叫端可在本機將實際的 UTF-8 JSONL 讀入 requests[]。此流程不使用上傳用途、input_file_id 或檔案參照。若缺少客戶素材或素材為空，應在 POST 前停止準備。", "material_types": [ "text" ], "optional_controls": [ "provider.only", "provider.allow_fallbacks", "completion_window" ], "representation": "內嵌的 requests[]；每個項目皆含 custom_id 與 body", "request_endpoint_profile": "/v1/chat/completions", "required": [ "endpoint", "model", "requests" ], "schema_scope": "依文件規定的內嵌 Batch 封裝格式提供文字 Chat Completions 請求主體。", "serialization_order": [ "endpoint", "model", "provider（如有提供）", "completion_window（如有提供）", "requests 放在最後" ] }, "lifecycle": { "cancel": null, "create": { "accepted_status": 202, "http": "POST", "path": "/v1/batches" }, "delete": null, "file_upload": null, "mode": "asynchronous", "observed_status_values": [ "validating", "in_progress", "finalizing", "completed", "failed", "expired", "cancelling", "cancelled" ], "owned_results": { "behavior": "Completed results are saved as owned JSONL, read back byte-for-byte and registered in the existing media library before publication after settlement. Status returns inline results; no separate Batch download route is added.", "format": "application/x-ndjson", "public_url_field_in_status": null }, "status": { "http": "GET", "id_source": "原始建立回應中實際回傳的 response.id；使用相同使用者／金鑰／群組", "path": "/v1/batches/{operation_id}" }, "terminal": [ "completed", "failed", "expired", "cancelled" ], "unknown": "保留原始作業 ID。503 result_pending_check 回應帶有 X-Should-Retry:false；請勿重新提交狀態不明的原始批次。" }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/batches" }, "output": { "all_results": "Preserve the full original status JSON, every result/custom_id and complete response or error body. Save completed results[] as JSONL without filtering.", "family": "batch", "format": "JSON; completed results[] are returned inline and can be saved as JSONL." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "詞元基本費率", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "請求長度級距 1", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{\"endpoint\":\"/v1/chat/completions\",\"model\":\"google/gemini-4-argon:batch\",\"requests\":[{\"custom_id\":\"req-0001\",\"body\":{\"messages\":[{\"role\":\"user\",\"content\":\"Hello!\"}],\"max_tokens\":16}}]}')\nPath(\"batch-request.json\").write_text(json.dumps(body,ensure_ascii=False),encoding=\"utf-8\")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\n", "label": "curl · retained fixture", "language": "bash" }, { "code": "import json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError(\"Customer JSONL file is missing\")\n items = [json.loads(line) for line in path.read_text(encoding=\"utf-8\").splitlines() if line.strip()]\n if not items: raise ValueError(\"Customer JSONL contains no requests\")\n ids = set()\n for item in items:\n if set(item) != {\"custom_id\", \"body\"}: raise ValueError(\"Each item needs custom_id and body\")\n cid = item[\"custom_id\"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError(\"custom_id must be nonempty and unique\")\n ids.add(cid)\n if not isinstance(item[\"body\"], dict) or not item[\"body\"].get(\"messages\"): raise ValueError(\"Supply actual text messages\")\n supplied_model = item[\"body\"].get(\"model\")\n if supplied_model is not None and supplied_model not in ['google/gemini-4-argon:batch', 'google/gemini-4-argon']: raise ValueError(\"body.model must be an exact documented caller or wire ID\")\n return {\"endpoint\":\"/v1/chat/completions\", \"model\":\"google/gemini-4-argon:batch\", \"requests\":items}\n\nif __name__ == \"__main__\":\n material = os.environ.get(\"AILOOT_BATCH_REQUESTS_JSONL\", \"\")\n if not material: raise SystemExit(\"Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file\")\n body = prepare_requests(material)\n key = os.environ.get(\"AILOOT_API_KEY\", \"\")\n if not key: raise SystemExit(\"Set AILOOT_API_KEY\")\n request = Request(\"https://api.ailoot.ai/v1/batches\", data=json.dumps(body, ensure_ascii=False).encode(\"utf-8\"), headers={\"Authorization\":\"Bearer \" + key, \"Content-Type\":\"application/json\"}, method=\"POST\")\n with urlopen(request) as response:\n raw = response.read()\n Path(\"batch-create-response.json\").write_bytes(raw)\n print(raw.decode(\"utf-8\"))\n", "label": "Python HTTP · actual customer JSONL", "language": "python" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nBATCH_OPERATION_ID=\"$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path(\"batch-create-response.json\").read_text(encoding=\"utf-8\"))\noperation = response.get(\"id\")\nif not isinstance(operation, str) or not operation: raise SystemExit(\"No actual original operation ID; preserve the response and do not resubmit\")\nprint(quote(operation, safe=\"\"))\nPY_ID\n)\"\ncurl --fail-with-body --silent --show-error \"https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -o batch-status-response.json\n", "label": "curl · original operation status", "language": "bash" }, { "code": "import json\nfrom pathlib import Path\nraw = Path(\"batch-status-response.json\").read_bytes()\nresponse = json.loads(raw)\nif response.get(\"status\") != \"completed\":\n raise SystemExit(\"Keep the original operation; read its status without resubmitting\")\nresults = response.get(\"results\")\nif not isinstance(results, list) or not results:\n raise SystemExit(\"Preserve the original response; completed results are missing\")\nPath(\"batch-results.jsonl\").write_text(\"\".join(json.dumps(item, ensure_ascii=False) + \"\\n\" for item in results), encoding=\"utf-8\")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\n", "label": "Python · save every completed result", "language": "python" } ], "family": "batch", "fast_multiplier": null, "flex_multiplier": null, "fmt": "batches", "hints": [ "Read your actual request items before submission; inline requests are required.", "Keep the returned operation ID and every result. Never replay an unknown submission." ], "http": "POST", "in": 2, "input": [ "text" ], "label": "批次處理（Batch）", "max_out": null, "max_reasoning_effort_multiplier": null, "out": 10, "output": [ "text" ], "path": "/v1/batches", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" }, { "label": "Explicit cache pricing", "value": "Not enabled", "when": "When explicit cache is requested" } ], "pricing": { "billing_mode": "token", "image_input_price": null, "image_output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Request-length tier 1", "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "request_model_id": "google/gemini-4-argon:batch", "route_label": "Ultra", "status_reads": [ "GET /v1/batches/{operation_id}" ], "tiers": [ { "cache_read": 0.1, "cache_read_multiplier": null, "cache_write": 0.375, "cache_write_1h": null, "cache_write_multiplier": null, "created_at": "0001-01-01T00:00:00Z", "in": 2, "input_multiplier": null, "max": null, "max_tokens": null, "min": 0, "min_tokens": 0, "out": 10, "output_multiplier": null, "per_request_price": null, "sort_order": 0, "tier_label": "", "updated_at": "0001-01-01T00:00:00Z" } ], "units": [ { "amount": "0.002000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.000002", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.01000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.00001", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": "0.0001000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": "0.0000001", "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": "0.000375000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": "0.000000375", "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "model_aliases": [ { "canonical_model_id": "google/gemini-4-argon:batch", "request_model_id": "google/gemini-4-argon:batch", "route_label": "Ultra" } ], "name": "Google: Gemini 4 Argon (batch)", "price": { "in": 2, "in_label": null, "out": 10, "out_label": null, "scope_label": "Token rates", "sort_in": 2, "sort_out": 10, "varies": true }, "short": "Gemini 4 Argon (batch) 是 Google 長上下文推理模型中另行列出的 batch 版本。它接受文字、影像、音訊、影片及文件，產出文字，並具備工具呼叫與結構化輸出功能。整理批次工作時，請將其識別碼及輸出額度與標準 Argon 分開保留。" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Gemini 4 Argon (batch) 是 Google 長上下文推理模型中另行列出的 batch 版本。它接受文字、影像、音訊、影片及文件，產出文字，並具備工具呼叫與結構化輸出功能。整理批次工作時，請將其識別碼及輸出額度與標準 Argon 分開保留。", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "cbfb704d87ade98219db95541be503245c37025e307d3d120e805ff6913be60b", "renderer_sha256": "13a3fc1b22d07359278e2249d630bfc9bb9e6416c71ba53def933fb5a903660b" }, "sourceRevision": "66f6b221c002717ef24aa9ebb0fdc5276383bac03640e6bf94b0543771989592" }