Google: Gemini 3.5 Flash (batch)

Gemini 3.5 Flash spája multimodálne porozumenie s uvažovaním pri programovaní a viackrokových úlohách agentov. Prijíma text, obrázky, video, zvuk a PDF a vytvára text; jeho dokumentovaný profil podporuje štruktúrované výstupy, nástroje a vstupný limit 1 048 576 tokenov.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-3.5-flash: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.5 Flash je multimodálny profil modelu Flash od spoločnosti Google na dlhodobejšie programovanie a prácu agentov. Jeho dokumentovanými vstupmi sú text, obrázky, video, zvuk a PDF a výstupom je text. Model sa zameriava na iteratívne programovanie, skúmanie alternatívnych riešení a dlhšie sekvencie pokynov a používania nástrojov. Edícia 3.5 poskytuje dokumentované ovládanie uvažovania, multimodálne vstupy a pracovné postupy s nástrojmi.

Programátorská úloha môže kombinovať písomnú požiadavku, relevantné zdrojové súbory a snímku obrazovky zamýšľaného výsledku. Uveďte pozorované správanie, očakávané správanie a obmedzenia, ktoré musia zostať zachované. Príklad zadania: „Porovnajte snímku obrazovky s textom komponentu, identifikujte nesúlad v postupe práce s formulárom a navrhnite jednu cielenú opravu. Vysvetlite, ktoré detaily zo zdroja zmenu odôvodňujú.“ Pri práci s dokumentom poskytnite relevantné stránky a vyžiadajte si porovnanie s výslovnými požiadavkami spolu s odkazmi na zdroje pre každé zistenie.

Edícia dokumentuje úrovne uvažovania minimal, low, medium a high. Predvolená je medium, čo predstavuje zmenu oproti predvolenej úrovni high pri Gemini 3 Flash Preview. Minimal je vhodná na jednoduché odpovede a priamočiare rozhodnutia o nástrojoch, no nezaručuje úplné vypnutie uvažovania; low je určená pre úlohy s menším počtom krokov; high poskytuje hlbšie uvažovanie pri náročnej matematike, programovaní a problémoch agentov. Google odporúča riadiť intenzitu pomocou thinking_level a ponechať predvolené nastavenia vzorkovania namiesto vynucovania uvažovania zmenami temperature, top-p alebo top-k.

Určujúcim správaním je zachovávanie kontextu uvažovania počas viacťahovej úlohy. Pracovný postup Google Interactions prenáša tento kontext automaticky; postup GenerateContent vyžaduje úplnú nezmenenú históriu konverzácie vrátane podpisov uvažovania. To podporuje pokračujúcu úlohu ladenia alebo refaktoringu, v ktorej predchádzajúce uvažovanie ovplyvňuje ďalší krok. Zachovajte skutočnú štruktúru konverzácie namiesto premeny každého pokračovania na nesúvisiaci prompt a počas práce udržiavajte jasnú predstavu o požadovanom konečnom artefakte.

Dokumentovaná sada nástrojov zahŕňa Google Search, ukotvenie v Google Maps, File Search, Code Execution, URL Context a štandardné Function Calling, pričom kombinované používanie nástrojov a Computer Use sú označené ako predbežne dostupné funkcie. Structured Outputs môžu poskytnúť definovaný dátový záznam. Funkciám určte jasný účel a definíciu parametrov: model vyberá funkciu, zatiaľ čo pripojená aplikácia vykonáva jej operáciu a vracia výsledok. Google vyžaduje, aby výsledky funkcií zodpovedali predchádzajúcim volaniam podľa identity, názvu a počtu; multimodálne výsledky patria do odpovede funkcie.

Presná tabuľka modelu API uvádza maximálny vstup 1 048 576 tokenov a maximálny výstup 65 536 tokenov. História konverzácie a poskytnuté médiá sa započítavajú do vstupného rozpočtu. Pre tento profil sú dokumentované ukladanie do vyrovnávacej pamäte a dávkové spracovanie a tabuľka Google uvádza aj možnosti spracovania Flex a Priority. Tieto limity a schopnosti opisujú edíciu výrobcu; nevyžadujú, aby odpoveď vyplnila celé výstupné okno alebo aby boli pri každej úlohe potrebné všetky nástroje.

Tento profil generuje text, nie obrázky ani zvuk, a nepoužíva Live API. Jeho príručka pre vývojárov tiež vylučuje segmentáciu obrázkov. Pri vizuálnej otázke žiadajte opis, extrakciu alebo interpretáciu dodaného materiálu; pri hovorenom zázname žiadajte textový výsledok. Ak odpoveď závisí od novších informácií, dokumentovaný postup ukotvenia vo vyhľadávaní môže pridať zdroje nad rámec tréningových znalostí. Uveďte, či sú potrebné externé informácie a aké dôkazy má konečná odpoveď zachovať.

Pri užitočnej dlhšej úlohe definujte konečný výsledok a kritérium dokončenia ešte pred prvým krokom. Analýza zákazníckej podpory môže vyžadovať tabuľku pozorovaných problémov, podporných pasáží a návrhu odpovede; programátorská úloha môže požadovať cielenú zmenu a výsledok relevantného overenia. Priložte podstatný zdrojový kontext, určte povolené akcie nástrojov a vyžiadajte si výslovnú konečnú odpoveď, ktorá oddelí dokončenú prácu od otázok vyžadujúcich ďalšie informácie. Tým sa priebežný pracovný postup modelu zmení na konkrétny textový, kódový alebo štruktúrovaný artefakt.

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

google/gemini-3.5-flash:batch

Google /google/gemini-3.5-flash: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.5-flash: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.5-flash:batch, google/gemini-3.5-flash	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.0015 / 1K tokenov Výstup · Výstupné tokeny $0.009 / 1K tokenov Vstup · Čítanie cache $0.00015 / 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.0015 / 1K tokenov Výstup · Výstupné tokeny $0.009 / 1K tokenov Vstup · Čítanie cache $0.00015 / 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.5-flash: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.5-flash:batch', 'google/gemini-3.5-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.5-flash: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.5-flash:batch

Aliasy ciest metód

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

Súvisiace ID na volanie

google/gemini-3.5-flash:batch

FAQ · Google: Gemini 3.5 Flash (batch)

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

Google: Gemini 3.5 Flash (batch)