Google: Gemini 3.1 Pro Preview (batch)

Gemini 3.1 Pro Preview je multimodálny uvažovací model spoločnosti Google pre zložité softvérové, algoritmické a znalostné úlohy. Prijíma text, obrázky, audio, video a PDF a vracia text alebo kód s podporou nástrojov a štruktúrovaného výstupu. Úrovne uvažovania low, medium a high riadia úsilie; high je zdokumentovaná predvolená hodnota.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-3.1-pro-preview:batch

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Gemini 3.1 Pro Preview je textový model spoločnosti Google orientovaný na uvažovanie pri zložitých úlohách vyžadujúcich softvérové inžinierstvo, vývoj algoritmov alebo syntézu multimodálnych dôkazov. Vychádza z Gemini 3 Pro a zdôrazňuje presné používanie nástrojov, efektívnejšie uvažovanie a spoľahlivé viackrokové vykonávanie. Text, obrázky, zvuk, video a PDF môžu prispieť k písomnej odpovedi, kódovému artefaktu alebo štruktúrovanému výsledku.

Pri náročnej programátorskej úlohe poskytnite cieľ, relevantný materiál z repozitára, pozorované správanie a obmedzenia, ktoré sa majú zachovať. Kontext pre zadanie môžu poskytnúť celé repozitáre kódu. Pri kontrole dátového kontraktu v kóde požiadajte model, aby porovnal spôsob, akým dva moduly spracúvajú spoločný dátový kontrakt, identifikoval nesúlad a navrhol cielenú opravu s podpornými odkazmi na kód. Užitočný výstup odlišuje analýzu, navrhovanú úpravu a dôkazy od overenia, ktoré vykonala pripojená aplikácia.

Materiály k uvedeniu modelu ukazujú vizuálne vysvetlenia vytvorené kódom a interaktívne projekty vrátane animovaného SVG výstupu z textového zadania. Ide o kódové artefakty, nie o generovanie rastrových obrázkov. Jasné zadanie môže definovať, čo sa má vysvetliť, ako sa má vizualizácia správať a aké dáta má reprezentovať. Výsledný kód a vykreslenie skontrolujte podľa týchto požiadaviek. Pri syntéze dát poskytnite skutočné zdroje a žiadajte jeden pohľad, ktorý zachová vzťahy a spresnenia obsiahnuté v nich.

Dokumentovanými úrovňami uvažovania sú low, medium a high, pričom pre 3.1 Pro Preview je predvolená high. V tomto profile Pro nemožno uvažovanie úplne vypnúť. Na ohraničenú odpoveď zvoľte nižšiu intenzitu a na náročnú viackrokovú prácu viac uvažovania, pričom ponechajte dostatočnú výstupnú rezervu pre konečný artefakt. Malý výstupný limit môže prerušiť uvažovanie skôr, než vznikne použiteľná konečná odpoveď. Príručka uvažovania oddeľuje zhrnutie uvažovania od celého vnútorného procesu a vysvetľuje, prečo záleží na kontexte podpisov uvažovania v konverzácii.

Presná tabuľka Preview uvádza volanie funkcií, vykonávanie kódu, ukotvenie vo vyhľadávaní, ukotvenie v Maps, kontext URL a štruktúrované výstupy. File Search obmedzuje na AI Studio. Poskytnite účel funkcií a definície parametrov a pokračujte na základe skutočne vráteného výsledku. Samostatný profil Custom Tools Preview je optimalizovaný na uprednostňovanie vlastných nástrojov a bash; ide o osobitný pomenovaný endpoint výrobcu, preto sa táto špecializácia nemá automaticky považovať za vlastnosť každej požiadavky 3.1 Pro. Ak úloha potrebuje definované záznamy namiesto voľnej prózy, vyberte schému štruktúrovaného výsledku.

Pri multimodálnej analýze určte relevantnú stránku, vizuálny prvok, interval nahrávky alebo udalosť vo videu. Pri analýze dokumentov porovnajte diagram s jeho písomnou špecifikáciou a vráťte každý nesúlad s podpornou pasážou. Hovorený zdroj môže poskytnúť prepis alebo textovú interpretáciu. Pri záveroch vyžadujúcich kontrolu zachovajte odkazy na zdroje a oddeľte viditeľné alebo výslovne uvedené skutočnosti od odvodených. Výstupom tohto profilu zostáva text vrátane kódu; natívne generovanie obrázkov alebo reči nie je súčasťou jeho konkrétnej tabuľky schopností.

Oficiálna karta 3.1 Pro uvádza kontext až 1M a textový výstup 64K a presná tabuľka Preview API uvádza 1 048 576 vstupných a 65 536 výstupných tokenov. Do vstupného rozpočtu zahrňte pokyny, históriu konverzácie a médiá. Dokumentované sú ukladanie do vyrovnávacej pamäte a dávkové spracovanie a profil výrobcu uvádza aj možnosti Flex a Priority. Pri viacerých nezávislých položkách definujte požadovaný výstup a zachovajte identifikátor každého zdroja namiesto spájania nesúvisiacich dôkazov do jednej odpovede bez možnosti dohľadania.

Pomenovaná edícia Preview zostáva odlišná od profilu Pro Custom Tools a neskorších vydaní Flash alebo Pro. Jej silné stránky sa týkajú zložitého uvažovania, programovania a syntézy dôkazov; konečný artefakt sa stále musí skontrolovať podľa zdroja a skutočných výsledkov nástrojov. Ak dodané informácie nepodporujú jednoznačný záver, zachovajte nevyriešenú nejednoznačnosť. Užitočným výstupom je podložená odpoveď, kód alebo záznam požadovaný úlohou s dostatkom dôkazov na posúdenie jeho praktických hraníc.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-3.1-pro-preview:batch

google/gemini-3.1-pro-preview:batch

Google /google/gemini-3.1-pro-preview:batch

Úvod

Povolené vstupy: Text
Výsledky: Text

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Dávkové spracovanie POST /v1/batches

Vstup: text
Výstup: text
Výstupný formát: JSON priamo vložený v results[].response.body

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`endpoint`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity /v1/chat/completions	Predvolené—
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity google/gemini-3.1-pro-preview:batch	Predvolené—
Pole`requests`	Typ`batch_item[]`	PožiadavkaPovinné	Hodnoty a limity Minimálny počet položiek: 1	Predvolené—
Pole`requests[].custom_id`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity	Predvolené—
Pole`requests[].body.messages`	Typ`message[]`	PožiadavkaPovinné	Hodnoty a limity	Predvolené—
Pole`completion_window`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 24h	Predvolené—
Pole`provider`	Typ`object\|null`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—
Pole`requests[].body.model`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview	Predvolené—
Pole`provider.only`	Typ`string[]`	PožiadavkaVoliteľné	Hodnoty a limity google-vertex/global	Predvolené—
Pole`provider.allow_fallbacks`	Typ`boolean\|null`	PožiadavkaVoliteľné	Hodnoty a limity false, null	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciaendpoint, model, requests
Parameter`material_types`	Špecifikáciatext
Parameter`representation`	Špecifikáciapriamo vložené requests[]; každá položka obsahuje custom_id a body
Parameter`request_endpoint_profile`	Špecifikácia/v1/chat/completions
Parameter`file_material`	ŠpecifikáciaVolajúci môže lokálne načítať skutočný súbor UTF-8 JSONL do requests[]. Nepoužíva sa účel nahrávania, input_file_id ani odkaz na súbor. Chýbajúce alebo prázdne podklady zákazníka zastavia prípravu pred POST.
Parameter`serialization_order`	Špecifikáciaendpoint, model, provider (ak je zadaný), completion_window (ak je zadaný), requests na konci
Parameter`optional_controls`	Špecifikáciaprovider.only, provider.allow_fallbacks, completion_window
Parameter`schema_scope`	ŠpecifikáciaTelá textových požiadaviek Chat Completions v zdokumentovanom obale dávky s priamo vloženými požiadavkami.

Životný cyklus: asynchronous

GET /v1/batches/{operation_id} · skutočná hodnota response.id z pôvodnej odpovede na vytvorenie; rovnaký používateľ/kľúč/skupina

Cenník

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Ceny explicitnej cache: Nie je zapnuté Keď sa požaduje explicitná cache

Sadzby Ailoot

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Počet tokenov kontextu väčší než	Tokeny kontextu, najviac (vrátane hranice)	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Počet tokenov kontextu väčší než—	Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.002 / 1K tokenov Výstup · Výstupné tokeny $0.012 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 1	Sadzobník—	Počet tokenov kontextu väčší než0	Tokeny kontextu, najviac (vrátane hranice)200 000	Poplatok Vstup · Vstupné tokeny $0.002 / 1K tokenov Výstup · Výstupné tokeny $0.012 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 2	Sadzobník—	Počet tokenov kontextu väčší než200 000	Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.004 / 1K tokenov Výstup · Výstupné tokeny $0.018 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Dávkové spracovanie

curl · uložená vzorová požiadavkaPython HTTP · skutočné údaje zákazníka vo formáte JSONLPython · uložte každý hotový výsledok

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

import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['google/gemini-3.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-preview:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    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")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))

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

Prijať a uložiť výsledky

Ailoot Ultra · Dávkové spracovanie

JSON priamo vložený v results[].response.body

GET /v1/batches/{operation_id}

Skontrolovať stav úlohy

curl · stav pôvodnej operácie

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

Uchovať všetky dokončené výsledky

Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.

Uchovajte úplný pôvodný stav vo formáte JSON, každý výsledok/custom_id a úplné telo odpovede alebo chyby. Dokončené results[] uložte ako JSONL bez filtrovania.

Ak treba overiť pôvodnú odpoveď

Uchovajte pôvodné ID operácie. Odpoveď 503 result_pending_check obsahuje X-Should-Retry:false; pôvodnú dávku s neznámym výsledkom nikdy znova neodosielajte.

Polia odpovede

Pole	Typ
Pole`results[].custom_id`	Typstring
Pole`results[].response.body.choices[].message.content`	Typstring\|null
Pole`results[].error`	Typobject\|null
Pole`usage`	Typobject\|null
Pole`id`	Typstring
Pole`model`	Typstring
Pole`endpoint`	Typstring
Pole`status`	Typstring
Pole`request_counts`	Typobject
Pole`results[].id`	Typstring
Pole`results[].response.status_code`	Typinteger
Pole`results[].response.request_id`	Typstring

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNeplatný zdokumentovaný obal s priamo vloženými požiadavkami, duplicitné kľúče alebo konflikt identity položky či nastavených schopností modelu.	Ďalší krokPred akýmkoľvek novým odoslaním opravte označené polia.
Odpoveď401 · `authentication_error`	PodmienkaNeplatný kľúč API.	Ďalší krokPoužite kľúč Ailoot, ktorý ste oprávnení používať.
Odpoveď403 · `permission_error`	PodmienkaSkupina pre dávkové spracovanie nie je dostupná.	Ďalší krokSkontrolujte oprávnenie kľúča/skupiny.
Odpoveď422 · `invalid_request_error`	PodmienkaDávkové spracovanie sa účtuje zo zostatku; vytvorenie cez predplatné sa odmieta.	Ďalší krokPoužite skupinu s účtovaním zo zostatku, ktorú ste oprávnení používať.
Odpoveď422 · `price_unavailable`	PodmienkaPre vstup dávky nemožno vypočítať cenovú ponuku.	Ďalší krokUchovajte odpoveď; použite zdokumentovaný vstup pre danú rodinu metód.
Odpoveď402 · `billing_error`	PodmienkaRezerva pre dávkové spracovanie nie je dostupná.	Ďalší krokPred novou požiadavkou vyriešte podmienky prijatia.
Odpoveď503 · `price_unavailable`	PodmienkaCena metódy dávkového spracovania alebo natívne sadzby nie sú dostupné.	Ďalší krokUchovajte odpoveď; nenahrádzajte ceny inými.
Odpoveď503 · `api_error`	PodmienkaPresná trasa k dodávateľovi nie je dostupná.	Ďalší krokUchovajte odpoveď na účely opravy smerovania.
Odpoveď503 · `result_pending_check`	PodmienkaPôvodný výsledok je potrebné skontrolovať; X-Should-Retry:false.	Ďalší krokUchovajte pôvodné operation_id/id a čítajte jeho stav; pôvodný POST nikdy neopakujte.
Odpoveď404 · `not_found`	PodmienkaOperácia na zisťovanie stavu dávky neexistuje alebo patrí inej identite.	Ďalší krokPoužite presné pôvodné id a rovnakého používateľa/kľúč/skupinu.

Aliasy

Aliasy modelov

Ailoot Ultra google/gemini-3.1-pro-preview:batch

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)

Aké vstupy a výsledky sú dostupné?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: text → text
Aké polia používa požiadavka?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: endpoint, model, requests, completion_window, provider
Aké limity platia?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: requests.min_items: 1

Google: Gemini 3.1 Pro Preview (batch)