Google: Gemini 3.5 Flash (batch)
A Gemini 3.5 Flash multimodális megértést és gondolkodást egyesít kódoláshoz és többlépéses ágensfeladatokhoz. Szöveget, képeket, videót, hangot és PDF-et fogad, és szöveget állít elő; dokumentált profiljában strukturált kimenetek, eszközök és 1 048 576 tokenes bemeneti korlát szerepel.
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.5 Flash a Google multimodális Flash modellprofilja tartós kódolási és ágensmunkához. Dokumentált bemenetei szöveg, kép, videó, hang és PDF, kimenete szöveg. A modell feladatfókusza az iteratív kódolást, alternatív megoldások feltárását és hosszabb utasítás- és eszközhasználati sorozatokat foglalja magában. A 3.5 kiadás dokumentált gondolkodási vezérlőket, multimodális bemeneteket és eszközmunkafolyamatokat biztosít.
Egy kódolási feladat egyesíthet írott követelményt, releváns forrásfájlokat és a tervezett eredmény képernyőképét. Adja meg a megfigyelt működést, az elvárt működést és az érintetlenül megőrzendő korlátokat. Szemléltető feladatleírás: „Vesse össze a képernyőképet a komponens szövegével, azonosítsa az eltérést az űrlap munkafolyamatában, és javasoljon egyetlen célzott javítást. Magyarázza el, mely forrásrészletek indokolják a változtatást.” Dokumentumfeladathoz adja meg a releváns oldalakat, és kérjen összehasonlítást kifejezett követelményekkel, minden megállapításhoz forráshivatkozással.
A kiadás minimal, low, medium és high gondolkodási szinteket dokumentál. Az alapértelmezés medium, a Gemini 3 Flash Preview high alapértelmezéséhez képest megváltoztatva. A minimal egyszerű válaszokhoz és egyértelmű eszközdöntésekhez illik, anélkül hogy garantálná a gondolkodás teljes kikapcsolását; a low kevesebb lépést igénylő feladatokat céloz; a high mélyebb gondolkodást ad nehéz matematikai, kódolási és ágensproblémákhoz. A Google a thinking_level használatát javasolja a ráfordítás szabályozásához és az alapértelmezett mintavételi beállítások megtartását, ahelyett hogy a temperature, top-p vagy top-k változtatásával próbálná kikényszeríteni a gondolkodást.
Meghatározó működés a gondolkodási kontextus megőrzése többfordulós feladaton át. A Google Interactions munkafolyamata ezt a kontextust automatikusan továbbviszi; a GenerateContent munkafolyamat teljes, módosítatlan beszélgetési előzményt igényel a gondolkodási aláírásokkal együtt. Ez olyan folytatódó hibakeresési vagy refaktorálási feladatot támogat, amelyben a korábbi gondolatmenet megalapozza a következő lépést. Őrizze meg a tényleges beszélgetésszerkezetet ahelyett, hogy minden követő kérést független prompttá alakítana, és a munka előrehaladtával is legyen világos a végső kért anyag.
A dokumentált eszközkészlet Google Search, Google Maps-alapú forráshoz kötés, File Search, Code Execution, URL Context és szokásos Function Calling funkciót tartalmaz, az együttes eszközhasználat és a Computer Use pedig előzetes képességként van jelölve. A Structured Outputs meghatározott adatrekordot biztosíthat. Adjon a függvényeknek egyértelmű célt és paramétermeghatározást: a modell választ függvényt, a kapcsolódó alkalmazás pedig végrehajtja annak műveletét és visszaadja az eredményt. A Google megköveteli, hogy a függvényeredmények az előző hívásokkal azonosító, név és darabszám szerint egyezzenek; a multimodális eredmények a függvényválaszon belülre tartoznak.
A konkrét API-modelltáblázat legfeljebb 1 048 576 bemeneti és 65 536 kimeneti tokent ad meg. A beszélgetési előzmények és a megadott média a bemeneti keretbe számítanak. Ehhez a profilhoz dokumentált a gyorsítótárazás és kötegelt feldolgozás, a Google táblázatában további Flex és Priority feldolgozási lehetőségekkel. Ezek a korlátok és képességek a fejlesztő kiadását írják le; nem követelik meg, hogy egy válasz a teljes kimeneti ablakot kitöltse, és nem tesznek minden eszközt szükségessé a feladathoz.
Ez a profil képek vagy hang helyett szöveget generál, és nem használ Live API-t. Fejlesztői útmutatója a képszegmentálást is kizárja. Vizuális kérdésnél kérjen leírást, adatkinyerést vagy értelmezést a megadott anyagról; beszédfelvételnél szöveges eredményt. Ha a válasz újabb információtól függ, a dokumentált keresésalapú forráshoz kötési munkafolyamat a tanítási ismereteken túli forrásokat adhat hozzá. Határozza meg, szükséges-e külső információ, és milyen bizonyítékot tartson meg a végső válasz.
Hasznos hosszabb feladathoz az első lépés előtt határozza meg a végső eredményt és a befejezési kritériumot. Ügyfélszolgálati elemzés kérheti a megfigyelt problémák, alátámasztó szövegrészek és javasolt válasz táblázatát; kódolási feladat a célzott változtatást és a releváns validálási eredményt. Csatolja a lényeges forráskontextust, határozza meg az engedélyezett eszközműveleteket, és kérjen kifejezett végső választ, amely elkülöníti a befejezett munkát a még információt igénylő kérdésektől. Így a modell tartós munkafolyamata konkrét szöveggé, kóddá vagy strukturált anyaggá válik.
Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches google/gemini-3.5-flash:batch
google/gemini-3.5-flash:batchKezdő lépések
A Gemini 3.5 Flash multimodális megértést és gondolkodást egyesít kódoláshoz és többlépéses ágensfeladatokhoz. Szöveget, képeket, videót, hangot és PDF-et fogad, és szöveget állít elő; dokumentált profiljában strukturált kimenetek, eszközök és 1 048 576 tokenes bemeneti korlát szerepel.
- 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.5-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.5-flash:batch, google/gemini-3.5-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.0015 / 1K token Kimenet · Kimeneti tokenek $0.009 / 1K token Bemenet · Gyorsítótár olvasása $0.00015 / 1K token Bemenet · Írás a gyorsítótárba — / 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.0015 / 1K token Kimenet · Kimeneti tokenek $0.009 / 1K token Bemenet · Gyorsítótár olvasása $0.00015 / 1K token Bemenet · Írás a gyorsítótárba — / 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.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.
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.5-flash:batch
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Google: Gemini 3.5 Flash (batch)
- Milyen bemenetek és eredmények érhetők el?
POST /v1/batches·google/gemini-3.5-flash:batch:text→text- Mely mezőket használja a kérés?
POST /v1/batches·google/gemini-3.5-flash:batch:endpoint,model,requests,completion_window,provider- Milyen korlátok érvényesek?
POST /v1/batches·google/gemini-3.5-flash:batch:requests.min_items:1