Google: Gemini 3.8 Flash (batch)
Gemini 3.8 Flash je multimodálny pracovný model Google pre dlhodobú softvérovú prácu, agentov a zložité znalostné úlohy. Prijíma text, obrázky, zvuk, video a PDF, vracia text a ponúka uvažovanie low, medium alebo high s nástrojmi a štruktúrovaným výstupom. Dokumentované vstupné/výstupné limity sú 1 048 576/65 536 tokenov.
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.8 Flash je model Google s textovým výstupom pre dlhodobú softvérovú prácu, viackrokových agentov a zložité znalostné postupy. Nadväzuje na Gemini 3.7 Flash so zlepšeniami softvérového inžinierstva a agentnej práce so znalosťami. Prijíma text, obrázky, zvuk, video a PDF, takže úloha môže spájať písomný cieľ so skutočným materiálom potrebným na jeho vyriešenie. Užitočným výsledkom je zmena kódu, vysvetlená analýza, písomná odpoveď alebo štruktúrovaný záznam.
Pri programátorskom zadaní dodajte požiadavku, relevantné súbory, pozorované správanie a obmedzenia, ktoré treba zachovať. Snímka obrazovky môže určiť zamýšľané rozhranie, zatiaľ čo protokoly alebo reprodukujúci príklad ukážu zlyhanie. Pri ladení žiadajte, aby model sledoval nesúlad medzi viditeľným stavom formulára a jeho uloženou hodnotou, určil zodpovednú cestu v kóde a navrhol cielenú opravu. Zamýšľaný konečný artefakt zachovajte jasný, aby aj dlhšia postupnosť skúmania a použitia nástrojov mala konkrétnu podmienku dokončenia.
Pri dlhšie trvajúcej práci používajte menšie kroky uvažovania, iteratívne volania nástrojov a kontroly priebežných výsledkov. Úrovne premýšľania low, medium a high riadia množstvo uvažovania; dokumentovaná predvolená voľba je medium. Low vyhovuje rýchlemu návrhu alebo ohraničenej analýze, zatiaľ čo high je určené na náročnú matematiku, programovanie alebo viackrokové úlohy. Gemini 3.8 Flash nepodporuje úroveň premýšľania minimal. Dlhodobé ladenie a jednoduchá extrakcia polí preto potrebujú odlišné voľby uvažovania, nie rovnaké nastavenie pre každú požiadavku.
Dokumentované nástroje zahŕňajú volanie funkcií, vykonávanie kódu, vyhľadávanie súborov, podloženie vyhľadávaním, podloženie cez Google Maps a kontext URL; Computer Use je uvedené ako predbežná funkcia. Štruktúrované výstupy definujú strojovo čitateľný výsledok. Funkcie majú mať jasný účel a definíciu parametrov: model môže požiadať o funkciu, zatiaľ čo prepojená aplikácia operáciu vykoná a vráti jej výsledok. Naprieč konverzačnými výmenami zachovajte identity funkcií a skutočne vrátený materiál. Užitočná konečná odpoveď vysvetľuje, ktoré dôkazy podporujú navrhnutú opravu alebo získanú hodnotu.
Migračný sprievodca 3.8 používa ovládanie úrovne premýšľania namiesto staršej konfigurácie limitu uvažovania a odporúča odstrániť zastarané parametre vzorkovania a vopred vyplnené správy modelu. Vyžaduje aj zachovanie podpisov myšlienok v príslušnom bezstavovom postupe a priradenie odpovedí funkcií k ich volaniam podľa identity a názvu. Tieto podrobnosti sú dôležité pri pokračovaní viackrokovej úlohy: ďalšia správa potrebuje skutočný predchádzajúci kontext, nie prepísaný opis strácajúci výsledok nástroja alebo podpis. V novej používateľskej správe ponechajte otázku a požadovaný výstup explicitné.
Pri multimodálnej znalostnej práci určite relevantné strany dokumentu, graf, zvukový interval alebo udalosť vo videu a uveďte ich príspevok k odpovedi. Porovnanie dokumentov môže požadovať tabuľku rozdielov so zdrojovými pasážami; otázka ku grafu môže žiadať viditeľné hodnoty a záver, ktorý podporujú. Analýza videa môže žiadať opis udalostí odôvodňujúcich zistenie. Model z týchto vstupov vracia text. Generované obrázky, reč a živá zvuková interakcia patria samostatným profilom modelov.
Limity Gemini API sú 1 048 576 vstupných tokenov a 65 536 výstupných tokenov, čo zodpovedá kontextu natívneho modelu najviac 1M a textovému výstupu 64K. Pokyny, história konverzácie a dodané médiá spotrebúvajú vstupný kontext a uvažovanie alebo dlhý konečný artefakt sa musia zmestiť do dokumentovaného výstupného limitu. Google pre tento profil výrobcu uvádza aj vyrovnávaciu pamäť, dávkové spracovanie, Flex a Priority spracovanie. Pri nezávislých položkách zachovajte stabilný identifikátor položky a explicitný formát výstupu, aby každý výsledok zostal spojený so zdrojom.
Možné obmedzenia zahŕňajú halucinácie, občasnú pomalosť alebo vypršanie časového limitu a vyššiu spotrebu tokenov pri vyššom úsilí. Časová hranica znalostí je marec 2026, pričom niektoré oblasti sú stále obmedzené na január 2025. Keď úloha závisí od neskorších informácií, dodajte aktuálne podklady alebo použite dokumentované nástroje podloženia. Zdrojové citácie, výpočty a navrhnutý kód skontrolujte podľa skutočných vstupov a výsledkov vykonania. Užitočný konečný artefakt má odlíšiť podložené zistenie od nevyriešenej otázky bez predpokladu, že plynulá odpoveď dokazuje požadovaný výsledok.
Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-3.8-flash:batch
google/gemini-3.8-flash:batchÚvod
Gemini 3.8 Flash je multimodálny pracovný model Google pre dlhodobú softvérovú prácu, agentov a zložité znalostné úlohy. Prijíma text, obrázky, zvuk, video a PDF, vracia text a ponúka uvažovanie low, medium alebo high s nástrojmi a štruktúrovaným výstupom. Dokumentované vstupné/výstupné limity sú 1 048 576/65 536 tokenov.
- 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é |
|---|---|---|---|---|
Poleendpoint | Typstring | PožiadavkaPovinné | Hodnoty a limity /v1/chat/completions | Predvolené— |
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/gemini-3.8-flash:batch | Predvolené— |
Polerequests | Typbatch_item[] | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 | Predvolené— |
Polerequests[].custom_id | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polerequests[].body.messages | Typmessage[] | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polecompletion_window | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 24h | Predvolené— |
Poleprovider | Typobject|null | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polerequests[].body.model | Typstring | PožiadavkaVoliteľné | Hodnoty a limity google/gemini-3.8-flash:batch, google/gemini-3.8-flash | Predvolené— |
Poleprovider.only | Typstring[] | PožiadavkaVoliteľné | Hodnoty a limity google-vertex/global | Predvolené— |
Poleprovider.allow_fallbacks | Typboolean|null | PožiadavkaVoliteľné | Hodnoty a limity false, null | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciaendpoint, model, requests |
Parametermaterial_types | Špecifikáciatext |
Parameterrepresentation | Špecifikáciapriamo vložené requests[]; každá položka obsahuje custom_id a body |
Parameterrequest_endpoint_profile | Špecifikácia/v1/chat/completions |
Parameterfile_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. |
Parameterserialization_order | Špecifikáciaendpoint, model, provider (ak je zadaný), completion_window (ak je zadaný), requests na konci |
Parameteroptional_controls | Špecifikáciaprovider.only, provider.allow_fallbacks, completion_window |
Parameterschema_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.00075 / 1K tokenov Výstup · Výstupné tokeny $0.00375 / 1K tokenov Vstup · Čítanie cache $0.000075 / 1K tokenov Vstup · Zápis do cache $0.0000833333333333334 / 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.00075 / 1K tokenov Výstup · Výstupné tokeny $0.00375 / 1K tokenov Vstup · Čítanie cache $0.000075 / 1K tokenov Vstup · Zápis do cache $0.0000833333333333334 / 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
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.8-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.8-flash:batch', 'google/gemini-3.8-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.8-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
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 |
|---|---|
Poleresults[].custom_id | Typstring |
Poleresults[].response.body.choices[].message.content | Typstring|null |
Poleresults[].error | Typobject|null |
Poleusage | Typobject|null |
Poleid | Typstring |
Polemodel | Typstring |
Poleendpoint | Typstring |
Polestatus | Typstring |
Polerequest_counts | Typobject |
Poleresults[].id | Typstring |
Poleresults[].response.status_code | Typinteger |
Poleresults[].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.8-flash:batch
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Google: Gemini 3.8 Flash (batch)
- Aké vstupy a výsledky sú dostupné?
POST /v1/batches·google/gemini-3.8-flash:batch:text→text- Aké polia používa požiadavka?
POST /v1/batches·google/gemini-3.8-flash:batch:endpoint,model,requests,completion_window,provider- Aké limity platia?
POST /v1/batches·google/gemini-3.8-flash:batch:requests.min_items:1