Google: Gemini 3.1 Pro Preview (batch)

A Gemini 3.1 Pro Preview a Google multimodális következtető modellje összetett szoftveres, algoritmikus és tudásfeladatokhoz. Szöveget, képeket, hangot, videót és PDF-et fogad, és szöveget vagy kódot ad vissza, eszközökkel és strukturált kimenettel. A Low, medium és high következtetési szintek vezérlik az erőfeszítést; a high a dokumentált alapérték.

Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches google/gemini-3.1-pro-preview:batch

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.1 Pro Preview a Google gondolkodásközpontú szöveges modellje szoftvermérnöki munkát, algoritmusfejlesztést vagy multimodális bizonyítékok egyesítését igénylő összetett feladatokhoz. A Gemini 3 Pro modellre épül, a pontos eszközhasználatot, a hatékonyabb gondolkodást és a megbízható többlépéses végrehajtást hangsúlyozva. Szöveg, kép, hang, videó és PDF járulhat hozzá írott válaszhoz, kóderedményhez vagy strukturált eredményhez.

Igényes kódolási feladathoz adja meg a célt, a releváns repozitóriumanyagot, a megfigyelt működést és a megőrzendő korlátokat. Teljes kódrepozitóriumok is adhatnak kontextust a feladathoz. Kódszerződés ellenőrzésekor kérje a modelltől annak összehasonlítását, hogyan kezeli két modul a közös adatszerződést, az eltérés azonosítását és célzott javítás javaslatát alátámasztó kódhivatkozásokkal. A hasznos kimenet elkülöníti az elemzést, a javasolt módosítást és a bizonyítékokat a kapcsolódó alkalmazás által végzett validálástól.

A bevezető anyag kódalapú vizuális magyarázatokat és interaktív projekteket mutat be, köztük szöveges feladatleírásból létrehozott animált SVG-kimenetet. Ezek kóderedmények, nem raszteres képgenerálás. Egy egyértelmű feladatleírás meghatározhatja, mit kell elmagyarázni, hogyan működjön a vizuális megjelenítés és milyen adatot reprezentáljon. Ellenőrizze az elkészült kódot és megjelenítést e követelmények alapján. Adatok egyesítését célzó feladathoz adja meg a tényleges forrásokat, és kérjen olyan közös nézetet, amely megőrzi a bennük szereplő kapcsolatokat és megszorításokat.

A dokumentált gondolkodási szintek low, medium és high, a 3.1 Pro Preview esetében high alapértelmezéssel. Ebben a Pro profilban a gondolkodás nem kapcsolható ki teljesen. Körülhatárolt válaszhoz válasszon alacsonyabb ráfordítást, nehéz többlépéses munkához több gondolkodást, miközben elegendő kimeneti keretet hagy a végső anyagnak. Egy alacsony kimeneti korlát megszakíthatja a gondolkodást, mielőtt használható végső válasz születik. A gondolkodási útmutató külön kezeli a gondolatmenet összefoglalóját a teljes belső folyamattól, és elmagyarázza, miért fontos a beszélgetés gondolkodásialáírás-kontextusa.

A konkrét Preview-táblázat függvényhívást, kódvégrehajtást, keresésalapú forráshoz kötést, Maps-alapú forráshoz kötést, URL-kontextust és strukturált kimeneteket sorol fel. A File Search hatókörét az AI Studióra korlátozza. Adja meg a függvények célját és paramétermeghatározását, majd a valódi visszakapott eredményből folytassa. A külön Custom Tools Preview profil az egyéni eszközök és a bash előnyben részesítésére optimalizált; ez külön névvel jelölt fejlesztői végpont, ezért ezt a specializációt nem szabad észrevétlenül minden 3.1 Pro kérés tulajdonságának tekinteni. Válasszon strukturált eredménysémát, ha a feladat kötetlen próza helyett meghatározott rekordokat igényel.

Multimodális elemzéshez azonosítsa a releváns oldalt, vizuális anyagot, felvételi intervallumot vagy videóeseményt. Dokumentumelemzésnél hasonlítson össze egy diagramot az írott specifikációjával, és adjon vissza minden eltérést az azt alátámasztó szövegrésszel. Egy beszélt forrás szöveges átirattal vagy értelmezéssel járulhat hozzá. Őrizze meg a forráshivatkozásokat az ellenőrizendő következtetésekhez, és válassza el a látható vagy kimondott információt a következtetéstől. E profil kimenete továbbra is szöveg, beleértve a kódot; a natív kép- vagy beszédgenerálás nem része a konkrét képességtáblázatának.

A natív 3.1 Pro kártya legfeljebb 1M méretű kontextust és 64K szöveges kimenetet határoz meg, a konkrét Preview API-táblázat pedig 1 048 576 bemeneti és 65 536 kimeneti tokent ad meg. Az utasításokat, beszélgetési előzményeket és médiát számítsa bele a bemeneti keretbe. A gyorsítótárazás és kötegelt feldolgozás dokumentált, a fejlesztői profilnál Flex és Priority lehetőségek is szerepelnek. Több független elemhez határozza meg a szükséges kimenetet, és őrizzen meg minden forrásazonosítót ahelyett, hogy nem kapcsolódó bizonyítékokat egyetlen visszakövethetetlen válaszba vonna össze.

A névvel jelölt Preview-kiadás különbözik a Pro Custom Tools profiljától és a későbbi Flash vagy Pro kiadásoktól. Erősségei az összetett gondolkodáshoz, kódoláshoz és bizonyítékok egyesítéséhez kapcsolódnak; a végső eredményt továbbra is ellenőrizni kell a forrás és a tényleges eszközeredmények alapján. Őrizze meg a feloldatlan kétértelműséget, ha a megadott információ nem támaszt alá határozott következtetést. Hasznos eredmény a feladat által kért, alátámasztott válasz, kód vagy rekord, elegendő bizonyítékkal a gyakorlati korlátok értékeléséhez.

Ailoot Ultra · Kötegelt feldolgozás POST /v1/batches google/gemini-3.1-pro-preview:batch

google/gemini-3.1-pro-preview:batch

Google /google/gemini-3.1-pro-preview:batch

Kezdő lépések

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ípus`string`	KövetelményKötelező	Értékek és korlátok /v1/chat/completions	Alapértelmezett—
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok google/gemini-3.1-pro-preview:batch	Alapértelmezett—
Mező`requests`	Típus`batch_item[]`	KövetelményKötelező	Értékek és korlátok Minimális elemszám: 1	Alapértelmezett—
Mező`requests[].custom_id`	Típus`string`	KövetelményKötelező	Értékek és korlátok	Alapértelmezett—
Mező`requests[].body.messages`	Típus`message[]`	KövetelményKötelező	Értékek és korlátok	Alapértelmezett—
Mező`completion_window`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 24h	Alapértelmezett—
Mező`provider`	Típus`object\|null`	KövetelményOpcionális	Értékek és korlátok	Alapértelmezett—
Mező`requests[].body.model`	Típus`string`	KövetelményOpcionális	Értékek és korlátok google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview	Alapértelmezett—
Mező`provider.only`	Típus`string[]`	KövetelményOpcionális	Értékek és korlátok google-vertex/global	Alapértelmezett—
Mező`provider.allow_fallbacks`	Típus`boolean\|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éter`content_type`	Szerződésapplication/json
Paraméter`required`	Szerződésendpoint, model, requests
Paraméter`material_types`	Szerződéstext
Paraméter`representation`	SzerződésA kérésbe ágyazott requests[]; minden elemhez custom_id és body tartozik
Paraméter`request_endpoint_profile`	Szerződés/v1/chat/completions
Paraméter`file_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éter`serialization_order`	Szerződésendpoint, model, provider (ha meg van adva), completion_window (ha meg van adva), requests utoljára
Paraméter`optional_controls`	Szerződésprovider.only, provider.allow_fallbacks, completion_window
Paraméter`schema_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.002 / 1K token Kimenet · Kimeneti tokenek $0.012 / 1K token Bemenet · Gyorsítótár olvasása — / 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, legfeljebb200 000	Díj Bemenet · Bemeneti tokenek $0.002 / 1K token Kimenet · Kimeneti tokenek $0.012 / 1K token Bemenet · Gyorsítótár olvasása — / 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 2. ársáv	Díjtáblázat—	Kontextustokenek, több mint200 000	Kontextustokenek, legfeljebbNincs felső korlát	Díj Bemenet · Bemeneti tokenek $0.004 / 1K token Kimenet · Kimeneti tokenek $0.018 / 1K token Bemenet · Gyorsítótár olvasása — / 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

curl · megőrzött tesztmintaPython HTTP · az ügyfél tényleges JSONL-adataiPython · ments el minden elkészült eredményt

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.1-pro-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.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-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.

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

curl · az eredeti művelet állapota

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.1-pro-preview:batch

Metódusútvonalak álnevei

Használja a fent látható metódusútvonalakat.

Kapcsolódó modellazonosítók

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)

Milyen bemenetek és eredmények érhetők el?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: text → text
Mely mezőket használja a kérés?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: endpoint, model, requests, completion_window, provider
Milyen korlátok érvényesek?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: requests.min_items: 1

Google: Gemini 3.1 Pro Preview (batch)