Google: Gemini 3 Flash Preview (batch)

Gemini 3 Flash Preview spája multimodálne porozumenie a uvažovanie s textovým výstupom. Podporuje analýzu kódu, dokumentov a vizuálnych podkladov, štruktúrované výsledky a pracovné postupy orientované na nástroje so štyrmi dokumentovanými úrovňami uvažovania na výber hĺbky analýzy.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-3-flash-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 Flash Preview je model spoločnosti Google s uvažovaním na multimodálne porozumenie, programovanie a úlohy agentov. Prijíma text, obrázky, video, zvuk a PDF a vracia text. Požiadavka preto môže okolo jedného problému spojiť písomné pokyny, zdrojové súbory, vizuálne pozorovania a históriu konverzácie. Výsledkom môže byť vysvetlenie, návrh kódu, extrahované dáta alebo plán podložený týmito materiálmi namiesto generovaného obrázka alebo hovorenej odpovede.

Karta konkrétneho modelu uvádza vstupný limit 1 048 576 tokenov a výstupný limit 65 536 tokenov. Zdroj a výsledok plánujte samostatne: dlhý výňatok z repozitára, zbierka dokumentov alebo nahrávka sa zmestia iba vtedy, keď sa ich spracovaná reprezentácia a pokyny zmestia do vstupného rozpočtu, a odpoveď stále potrebuje vlastnú vyhradenú dĺžku. Označte súvisiace zdroje a určte, ktorý materiál je záväzný. Pri dlhom prompte príručka pre vývojárov odporúča umiestniť konkrétnu otázku za dáta a výslovne ju prepojiť s predchádzajúcimi informáciami.

Uvažovanie je dynamické a dokumentovanou predvolenou úrovňou tohto modelu je high. Podporované úrovne sú minimal, low, medium a high. Ide o relatívny priestor na uvažovanie, nie o zaručené počty tokenov. Aj minimal môže pri náročnom programátorskom probléme zahŕňať určité uvažovanie. Úroveň voľte podľa úlohy: krátka transformácia a ladenie problému s viacerými podmienkami potrebujú odlišný prístup. Používajte priame, jasné pokyny namiesto vynucovania zložitých rituálov uvažovania v prompte; vyžiadajte si konečný artefakt a kontroly, ktoré ho robia použiteľným.

Karta výrobcu uvádza štruktúrované výstupy, volanie funkcií, vykonávanie kódu, používanie počítača, vyhľadávanie v súboroch, ukotvenie vo vyhľadávaní, ukotvenie v Google Maps, kontext URL a ukladanie do vyrovnávacej pamäte. V dokumentovanom postupe Gemini 3 možno vstavané nástroje kombinovať s volaním vlastných funkcií. Aplikácia definuje funkcie, kontroluje ich argumenty, vykonáva prijaté akcie a posiela späť ich výsledky. Pri programátorskom asistentovi môže nástroj na čítanie súborov alebo riadené spúšťanie testov poskytnúť konkrétne dôkazy pre ďalší krok. Navrhovaná akcia a pozorovaný výsledok nástroja majú v konečnej správe zostať odlíšené.

Pri programovaní poskytnite relevantné súbory, jazyk, očakávané správanie a vstup, ktorý demonštruje problém. Určte rozsah zmeny a pomenujte rozhranie alebo správanie, ktoré musí zostať zachované. Žiadajte upravenú implementáciu a prípady, ktoré treba skontrolovať. Pri analytickej práci s dokumentom definujte otázku, požadované polia a odkazy na zdroje. Ak sa používa štruktúrovaný výstup, poskytnite schému s jasným významom polí a pravidlami pre chýbajúce hodnoty. Overte jej syntax aj to, či každá hodnota vyplýva z pôvodného materiálu.

Pri multimodálnej analýze určte, čo je v každom zdroji podstatné. Snímka obrazovky môže podporiť vysvetlenie rozhrania, PDF môže poskytnúť tabuľku alebo graf a nahrávka môže dodať hovorené alebo viditeľné udalosti. Príručka pre vývojárov rozoberá ovládanie rozlíšenia médií, pretože úroveň detailu mení spracovanú reprezentáciu a spotrebu tokenov. Postup výrobcu s vykonávaním kódu môže dodané obrázky orezať alebo priblížiť, vykonať výpočty z vizuálnych dát a pridať anotácie ešte pred prípravou odpovede modelu. Čitateľný drobný text môže vyžadovať iné nastavenie než všeobecný opis scény. Relevantnú stránku, obrázok alebo klip ponechajte dostupný, aby sa pozorovania dali overiť, namiesto považovania plynulého zhrnutia za dôkaz, že každý detail bol správne prečítaný.

Vo vybranom rozhraní treba zachovať stav konverzácie a nástrojov. Gemini 3 používa podpisy uvažovania na prenos kontextu uvažovania medzi volaniami; príručka pre vývojárov odlišuje automaticky spravovanú stavovú históriu od ručne spravovanej bezstavovej histórie. Pri pokračovaní úlohy s nástrojmi alebo revízii výsledku zachovajte požadovaný kontext. Google tiež odporúča ponechať predvolenú temperature 1.0 namiesto prenášania postupu s nízkou teplotou, ktorý môže pri zložitých úlohách spôsobiť slučky alebo zhoršené správanie. Ide o integračné postupy výrobcu, nie o nové tvrdenia o prenose v konkrétnej aplikácii.

Textový model neuvádza generovanie obrázkov alebo zvuku ani Live API. Príručka tiež odlišuje vizuálne porozumenie od segmentácie obrázkov na úrovni pixelov, ktorú Gemini 3 Flash nepodporuje. Pre skutočnú úlohu zvoľte vhodný konečný výsledok: pozorovania s odkazmi na zdroje, štruktúrovaný záznam, zmenu kódu alebo rozhodnutie s uvedenými predpokladmi. Skontrolujte aritmetiku, overte kód v zamýšľanom prostredí a preskúmajte vrátené informácie z nástrojov. Keď záleží na aktuálnych faktoch, používajte nakonfigurované zdroje ukotvenia alebo dodané aktuálne dáta namiesto predpokladu, že znalosti modelu sú živou databázou.

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

google/gemini-3-flash-preview:batch

Google /google/gemini-3-flash-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-flash-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-flash-preview:batch, google/gemini-3-flash-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.0005 / 1K tokenov Výstup · Výstupné tokeny $0.003 / 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)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.0005 / 1K tokenov Výstup · Výstupné tokeny $0.003 / 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-flash-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-flash-preview:batch', 'google/gemini-3-flash-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3-flash-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-flash-preview:batch

Aliasy ciest metód

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

Súvisiace ID na volanie

google/gemini-3-flash-preview:batch

FAQ · Google: Gemini 3 Flash Preview (batch)

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

Google: Gemini 3 Flash Preview (batch)