Google: Gemini 3.8 Flash (batch)
A Gemini 3.8 Flash a Google széles körben használható multimodális modellje tartós szoftvermérnöki munkához, ágensekhez és összetett tudásfeladatokhoz. Szöveget, képet, hangot, videót és PDF-et fogad, szöveget ad vissza, és low, medium vagy high gondolkodást kínál eszközökkel és strukturált kimenettel. Dokumentált bemeneti/kimeneti korlátja 1 048 576/65 536 token.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Gemini 3.8 Flash a Google szöveges kimenetű modellje tartós szoftvermérnöki munkához, többlépéses ágensekhez és összetett tudásmunkafolyamatokhoz. A Gemini 3.7 Flash modellre épül, szoftvermérnöki és ágensalapú tudásmunkát érintő fejlesztésekkel. Szöveget, képeket, hangot, videót és PDF-et fogad, így egy feladat az írott célt a megoldásához ténylegesen szükséges anyaggal kapcsolhatja össze. A hasznos eredmény kódváltoztatás, magyarázattal ellátott elemzés, írott válasz vagy strukturált rekord.
Kódolási feladathoz adja meg a követelményt, a releváns fájlokat, a megfigyelt működést és a megőrzendő korlátokat. Egy képernyőkép rögzítheti a kívánt felületet, a naplók vagy egy reprodukáló példa pedig megmutathatják a hibát. Hibakeresésnél kérje a modelltől egy űrlap látható állapota és tárolt értéke közötti eltérés követését, a felelős kódútvonal azonosítását és célzott javítás javaslatát. A tervezett végső anyag maradjon egyértelmű, hogy a vizsgálat és eszközhasználat hosszabb sorozatának is konkrét befejezési feltétele legyen.
Hosszabb munkához használjon kisebb gondolkodási lépéseket, ismétlődő eszközhívásokat és közteseredmény-ellenőrzéseket. A low, medium és high gondolkodási szintek szabályozzák a gondolkodás mennyiségét; a dokumentált alapértelmezés medium. A low gyors tervezethez vagy körülhatárolt elemzéshez illik, a high pedig nehéz matematikai, kódolási vagy többlépéses feladatokra szolgál. A Gemini 3.8 Flash nem támogatja a minimal gondolkodási szintet. Egy tartós hibakeresési feladat és egy egyszerű mezőkinyerés ezért eltérő gondolkodási választást kíván, nem ugyanazt a beállítást minden kéréshez.
A dokumentált eszközök között függvényhívás, kódvégrehajtás, fájlkeresés, keresésalapú forráshoz kötés, Google Maps-alapú forráshoz kötés és URL-kontextus szerepel, a Computer Use pedig előzetes képességként van felsorolva. A strukturált kimenetek géppel feldolgozható eredményt határoznak meg. A függvényeknek legyen egyértelmű céljuk és paramétermeghatározásuk: a modell kérhet egy függvényt, a kapcsolódó alkalmazás pedig végrehajtja a műveletet és visszaadja annak eredményét. Őrizze meg a függvényazonosításokat és a ténylegesen visszakapott anyagot a fordulók között. Hasznos végső válasz az, amely elmagyarázza, milyen bizonyíték támasztja alá a javasolt javítást vagy kinyert értéket.
A 3.8 migrációs útmutató a korábbi gondolkodásikeret-konfiguráció helyett gondolkodási szintekkel működő vezérlőket használ, és javasolja az elavult mintavételi paraméterek és előre kitöltött model-fordulók eltávolítását. Az érintett állapotmentes munkafolyamatban a gondolkodási aláírások megőrzését, valamint a függvényválaszok hívásaikkal való összerendelését is előírja azonosító és név alapján. Ezek a részletek fontosak egy többlépéses feladat folytatásakor: a következő fordulónak a tényleges korábbi kontextus kell, nem olyan átírt beszámoló, amelyből elveszik az eszközeredmény vagy az aláírás. Az új user fordulóban is tegye egyértelművé a kérdést és a kért kimenetet.
Multimodális tudásmunkánál azonosítsa a releváns dokumentumoldalakat, diagramot, hangintervallumot vagy videóeseményt, és mondja el, hogyan járuljon hozzá a válaszhoz. Dokumentumok összehasonlításakor kérheti a különbségek táblázatát forrásszövegrészekkel; diagramkérdésben a látható értékeket és az általuk alátámasztott következtetést. Videóelemzésben kérhető a megállapítást indokló események leírása. A modell ezekből a bemenetekből szöveget ad vissza. A generált képek, a beszéd és az élő hanginterakció külön modellprofilokhoz tartozik.
Gemini API-korlátai 1 048 576 bemeneti és 65 536 kimeneti token, a natív modell legfeljebb 1M méretű kontextusának és 64K szöveges kimenetének megfelelően. Az utasítások, a beszélgetési előzmények és a megadott média bemeneti kontextust fogyasztanak, a gondolkodásnak vagy egy hosszú végső eredménynek pedig bele kell férnie a dokumentált kimeneti keretbe. A Google ehhez a fejlesztői profilhoz gyorsítótárazást, kötegelt feldolgozást, Flex és Priority feldolgozást is felsorol. Független elemeknél őrizzen meg stabil elemazonosítót és kifejezett kimeneti formátumot, hogy minden eredmény a saját forrásához kapcsolódjon.
Lehetséges korlátai közé tartoznak a hallucinációk, az időnkénti lassúság vagy időtúllépés és a magasabb ráfordításhoz társuló nagyobb tokenhasználat. Ismeretzárása 2026. március, egyes területeken továbbra is 2025. januári korláttal. Ha a feladat későbbi információtól függ, adjon meg aktuális bizonyítékot, vagy használja a dokumentált forráshoz kötési eszközöket. A forráshivatkozásokat, számításokat és javasolt kódot ellenőrizze a tényleges bemenetek és végrehajtási eredmények alapján. A végső hasznos anyag különböztesse meg az alátámasztott megállapítást a megoldatlan kérdéstől, anélkül hogy a gördülékeny válaszból a kért eredmény elérését feltételezné.
Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches google/gemini-3.8-flash:batch
google/gemini-3.8-flash:batchKezdő lépések
A Gemini 3.8 Flash a Google széles körben használható multimodális modellje tartós szoftvermérnöki munkához, ágensekhez és összetett tudásfeladatokhoz. Szöveget, képet, hangot, videót és PDF-et fogad, szöveget ad vissza, és low, medium vagy high gondolkodást kínál eszközökkel és strukturált kimenettel. Dokumentált bemeneti/kimeneti korlátja 1 048 576/65 536 token.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Szöveg
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches
- Bemenet
text- Kimenet
text- Kimeneti formátum
- Beágyazott results[].response.body JSON-adatok
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőendpoint | Típusstring | KövetelményKötelező | Értékek és korlátok /v1/chat/completions | Alapértelmezett— |
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok google/gemini-3.8-flash:batch | Alapértelmezett— |
Mezőrequests | Típusbatch_item[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 | Alapértelmezett— |
Mezőrequests[].custom_id | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőrequests[].body.messages | Típusmessage[] | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőcompletion_window | Típusstring | KövetelményOpcionális | Értékek és korlátok 24h | Alapértelmezett— |
Mezőprovider | Típusobject|null | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőrequests[].body.model | Típusstring | KövetelményOpcionális | Értékek és korlátok google/gemini-3.8-flash:batch, google/gemini-3.8-flash | Alapértelmezett— |
Mezőprovider.only | Típusstring[] | KövetelményOpcionális | Értékek és korlátok google-vertex/global | Alapértelmezett— |
Mezőprovider.allow_fallbacks | Típusboolean|null | KövetelményOpcionális | Értékek és korlátok false, null | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésendpoint, model, requests |
Paramétermaterial_types | Szerződéstext |
Paraméterrepresentation | SzerződésA kérésbe ágyazott requests[]; minden elemhez custom_id és body tartozik |
Paraméterrequest_endpoint_profile | Szerződés/v1/chat/completions |
Paraméterfile_material | SzerződésA hívó helyben beolvashatja a tényleges UTF-8 JSONL-adatokat a requests[] tömbbe. A kérés nem használ feltöltési célt, input_file_id mezőt vagy fájlhivatkozást. Hiányzó vagy üres ügyfélanyag esetén az előkészítés még a POST előtt leáll. |
Paraméterserialization_order | Szerződésendpoint, model, provider (ha meg van adva), completion_window (ha meg van adva), requests utoljára |
Paraméteroptional_controls | Szerződésprovider.only, provider.allow_fallbacks, completion_window |
Paraméterschema_scope | SzerződésText Chat Completions-kéréstörzsek a dokumentált, kérésbe ágyazott Batch-borítékban. |
Életciklus: asynchronous
GET /v1/batches/{operation_id} · Az eredeti létrehozási válasz tényleges response.id értéke; ugyanaz a felhasználó/kulcs/csoport
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
- Explicit gyorsítótárazás díjai
- Nincs engedélyezve Ha explicit gyorsítótárazást kérnek
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj |
|---|---|---|---|---|
| BeállításTokenenkénti alapárak | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.00075 / 1K token Kimenet · Kimeneti tokenek $0.00375 / 1K token Bemenet · Gyorsítótár olvasása $0.000075 / 1K token Bemenet · Írás a gyorsítótárba $0.0000833333333333334 / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.00075 / 1K token Kimenet · Kimeneti tokenek $0.00375 / 1K token Bemenet · Gyorsítótár olvasása $0.000075 / 1K token Bemenet · Írás a gyorsítótárba $0.0000833333333333334 / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Kötegelt feldolgozás
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.
Eredmények fogadása és mentése
Ailoot Ultra · Kötegelt feldolgozás
Beágyazott results[].response.body JSON-adatok
GET /v1/batches/{operation_id}
Feladatállapot ellenőrzése
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
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg a teljes eredeti állapot-JSON-t, minden eredményt/custom_id értéket, valamint a teljes válasz- vagy hibatörzset. A befejezett results[] elemeket szűrés nélkül mentse JSONL-ként.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti műveletazonosítót. A 503 result_pending_check válasz X-Should-Retry:false fejlécet tartalmaz; soha ne küldje be újra az ismeretlen kimenetelű eredeti köteget.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőresults[].custom_id | Típusstring |
Mezőresults[].response.body.choices[].message.content | Típusstring|null |
Mezőresults[].error | Típusobject|null |
Mezőusage | Típusobject|null |
Mezőid | Típusstring |
Mezőmodel | Típusstring |
Mezőendpoint | Típusstring |
Mezőstatus | Típusstring |
Mezőrequest_counts | Típusobject |
Mezőresults[].id | Típusstring |
Mezőresults[].response.status_code | Típusinteger |
Mezőresults[].response.request_id | Típusstring |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen a dokumentált, kérésbe ágyazott boríték, ismétlődő kulcsok vagy az elemek azonosságával kapcsolatos hiba található benne, vagy ütközés van a beállított modellképességekkel. | Következő lépésBármilyen új beküldés előtt javítsa ki a megjelölt mezőket. |
Válasz401 · authentication_error | FeltételÉrvénytelen API-kulcs. | Következő lépésHasználja az engedélyezett Ailoot-kulcsot. |
Válasz403 · permission_error | FeltételA Batch-csoport nem érhető el. | Következő lépésEllenőrizze a kulcs/csoport jogosultságát. |
Válasz422 · invalid_request_error | FeltételA Batch az egyenlegből számol el; az előfizetés terhére indított létrehozási kérés elutasításra kerül. | Következő lépésHasználja az engedélyezett, egyenlegből elszámoló csoportot. |
Válasz422 · price_unavailable | FeltételA Batch-bemenethez nem készíthető árajánlat. | Következő lépésŐrizze meg a választ; használja az API-család dokumentált bemenetét. |
Válasz402 · billing_error | FeltételA Batch költségfedezeti foglalása nem érhető el. | Következő lépésAz új kérés előtt rendezze a befogadási feltételeket. |
Válasz503 · price_unavailable | FeltételA Batch-módszer ára vagy natív díjtételei nem érhetők el. | Következő lépésŐrizze meg a választ; ne helyettesítse az árakat más árakkal. |
Válasz503 · api_error | FeltételA pontos szolgáltatói útvonal nem érhető el. | Következő lépésŐrizze meg a választ az útvonal javításához. |
Válasz503 · result_pending_check | FeltételAz eredeti eredmény ellenőrzést igényel; X-Should-Retry:false. | Következő lépésŐrizze meg az eredeti operation_id/id értéket, és kérdezze le az állapotát; soha ne ismételje meg az eredeti POST kérést. |
Válasz404 · not_found | FeltételA Batch állapotlekérdezési művelete nem létezik, vagy más identitáshoz tartozik. | Következő lépésHasználja az eredeti id pontos értékét és ugyanazt a felhasználót/kulcsot/csoportot. |
Álnevek
Modell álnevei
Ailoot Ultra google/gemini-3.8-flash:batch
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Google: Gemini 3.8 Flash (batch)
- Milyen bemenetek és eredmények érhetők el?
POST /v1/batches·google/gemini-3.8-flash:batch:text→text- Mely mezőket használja a kérés?
POST /v1/batches·google/gemini-3.8-flash:batch:endpoint,model,requests,completion_window,provider- Milyen korlátok érvényesek?
POST /v1/batches·google/gemini-3.8-flash:batch:requests.min_items:1