Google: Gemini 3.1 Pro Preview (batch)

Gemini 3.1 Pro Preview är Googles multimodala resonemangsmodell för komplexa programvaru-, algoritm- och kunskapsuppgifter. Den tar emot text, bilder, ljud, video och PDF och returnerar text eller kod, med verktyg och strukturerade utdata. Resonemangsnivåerna Low, medium och high styr insatsen; high är det dokumenterade standardvalet.

Ailoot Ultra · Batchkörning POST /v1/batches google/gemini-3.1-pro-preview:batch

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

Gemini 3.1 Pro Preview är Googles resonemangsinriktade textmodell för komplexa uppgifter som kräver programvaruutveckling, algoritmutveckling eller syntes av multimodalt underlag. Den bygger vidare på Gemini 3 Pro med tonvikt på exakt verktygsanvändning, effektivare resonemang och tillförlitlig exekvering i flera steg. Text, bilder, ljud, video och PDF kan bidra till ett skriftligt svar, en kodartefakt eller ett strukturerat resultat.

För ett krävande programmeringsuppdrag ska du ange målet, relevant material ur kodarkivet, observerat beteende och de begränsningar som ska behållas. Hela kodarkiv kan tillföra kontext för uppdraget. Vid granskning av ett kodkontrakt kan du be modellen jämföra hur två moduler hanterar ett gemensamt datakontrakt, identifiera avvikelsen och föreslå en avgränsad korrigering med stödjande kodhänvisningar. Ett användbart resultat skiljer analys, föreslagen ändring och belägg från eventuell validering som den anslutna applikationen har utfört.

Lanseringsmaterialet visar kodbaserade visuella förklaringar och interaktiva projekt, inklusive animerad SVG-utdata från en textbeskrivning. Det är kodartefakter snarare än generering av rasterbilder. En tydlig uppdragsbeskrivning kan definiera vad som ska förklaras, hur visualiseringen ska bete sig och vilka data den ska återge. Granska den resulterande koden och renderingen mot kraven. För en uppgift med datasyntes ska du tillhandahålla de faktiska källorna och begära en samlad vy som bevarar de samband och förbehåll som finns i dem.

De dokumenterade tänkandenivåerna är low, medium och high, med high som standard för 3.1 Pro Preview. Tänkande kan inte stängas av helt i den här Pro-profilen. Välj en lägre arbetsinsats för ett avgränsat svar och mer resonemang för svårt arbete i flera steg, samtidigt som tillräckligt utdatautrymme lämnas för den slutliga artefakten. Ett lågt utdatatak kan avbryta resonemanget innan ett användbart slutligt svar visas. Guiden för tänkande skiljer en sammanfattning av resonemang från hela den interna processen och förklarar varför samtalets kontext med thought signatures är viktig.

Den exakta Preview-tabellen listar funktionsanrop, kodexekvering, sökförankring, Maps-förankring, URL-kontext och strukturerad utdata. Den avgränsar File Search till AI Studio. Ange funktionernas syften och parameterdefinitioner och fortsätt från det faktiska returnerade resultatet. Den separata profilen Custom Tools Preview är optimerad för att prioritera anpassade verktyg och bash; den är en separat namngiven endpoint hos tillverkaren, så den specialiseringen ska inte i tysthet behandlas som en egenskap hos varje 3.1 Pro-förfrågan. Välj ett schema för strukturerade resultat när uppgiften behöver definierade poster i stället för fri löptext.

För multimodal analys ska du identifiera relevant sida, bildmaterial, inspelningsintervall eller videohändelse. Vid dokumentanalys kan du jämföra ett diagram med dess skriftliga specifikation och returnera varje avvikelse med en stödjande textpassage. En talad källa kan bidra med en transkription eller en tolkning i text. Bevara källhänvisningar för slutsatser som behöver kontrolleras och skilj det som är synligt eller uttryckligen angivet från det som är härlett. Profilens utdata förblir text, inklusive kod; inbyggd bild- eller talgenerering ingår inte i dess exakta kapacitetstabell.

Det ursprungliga kortet för 3.1 Pro anger upp till 1M kontext och 64K textutdata, och den exakta Preview-API-tabellen anger 1,048,576 indatatoken och 65,536 utdatatoken. Räkna in instruktioner, samtalshistorik och medier i indatabudgeten. Cachelagring och batchbearbetning dokumenteras, och alternativ för Flex och Priority listas också för tillverkarens profil. För flera oberoende objekt ska den föreskrivna utdataformen definieras och varje källidentifierare behållas i stället för att orelaterade belägg kombineras i ett enda ospårbart svar.

Den namngivna Preview-utgåvan är fortfarande separat från Pros Custom Tools-profil och senare Flash- eller Pro-utgåvor. Dess styrkor gäller komplexa resonemang, programmering och syntes av underlag; den slutliga artefakten behöver fortfarande kontrolleras mot källan och de faktiska verktygsresultaten. Bevara olöst tvetydighet när den tillhandahållna informationen inte stödjer en bestämd slutsats. En användbar leverans är det underbyggda svar, den kod eller den post som uppgiften efterfrågade, med tillräckliga belägg för att bedöma dess praktiska begränsningar.

Ailoot Ultra · Batchkörning 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

Start

Godkända indata: Text
Resultat: Text

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Batchkörning POST /v1/batches

Indatatyper: text
Utdatatyper: text
Utdataformat: JSON i inbäddade results[].response.body

Fält	Typ	Krav	Värden & gränser	Standard
Fält`endpoint`	Typ`string`	KravObligatoriskt	Värden & gränser /v1/chat/completions	Standard—
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser google/gemini-3.1-pro-preview:batch	Standard—
Fält`requests`	Typ`batch_item[]`	KravObligatoriskt	Värden & gränser Minsta antal objekt: 1	Standard—
Fält`requests[].custom_id`	Typ`string`	KravObligatoriskt	Värden & gränser	Standard—
Fält`requests[].body.messages`	Typ`message[]`	KravObligatoriskt	Värden & gränser	Standard—
Fält`completion_window`	Typ`string`	KravValfritt	Värden & gränser 24h	Standard—
Fält`provider`	Typ`object\|null`	KravValfritt	Värden & gränser	Standard—
Fält`requests[].body.model`	Typ`string`	KravValfritt	Värden & gränser google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview	Standard—
Fält`provider.only`	Typ`string[]`	KravValfritt	Värden & gränser google-vertex/global	Standard—
Fält`provider.allow_fallbacks`	Typ`boolean\|null`	KravValfritt	Värden & gränser false, null	Standard—

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalendpoint, model, requests
Parameter`material_types`	Avtaltext
Parameter`representation`	AvtalInbäddade requests[]; varje objekt har custom_id och body
Parameter`request_endpoint_profile`	Avtal/v1/chat/completions
Parameter`file_material`	AvtalDen anropande klienten kan läsa in faktiska UTF-8 JSONL-data lokalt i requests[]. Inget uppladdningssyfte, input_file_id eller någon filreferens används. Om kundmaterial saknas eller är tomt avbryts förberedelserna före POST.
Parameter`serialization_order`	Avtalendpoint, model, provider (om angivet), completion_window (om angivet), requests sist
Parameter`optional_controls`	Avtalprovider.only, provider.allow_fallbacks, completion_window
Parameter`schema_scope`	AvtalFörfrågningskroppar för Text Chat Completions i det dokumenterade inbäddade Batch-formatet.

Livscykel: asynchronous

GET /v1/batches/{operation_id} · Det faktiska response.id från det ursprungliga skapandesvaret; samma användare/nyckel/grupp

Priser

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Prissättning för explicit cache: Inte aktiverat När explicit cache begärs

Ailoot-priser

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

Konfiguration	Prislista	Kontexttoken, fler än	Kontexttoken, upp till och med	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Kontexttoken, fler än—	Kontexttoken, upp till och medIngen övre gräns	Avgift Indata · Indatatoken $0.002 / 1K token Utdata · Utdatatoken $0.012 / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token
KonfigurationNivå 1 för förfrågans längd	Prislista—	Kontexttoken, fler än0	Kontexttoken, upp till och med200 000	Avgift Indata · Indatatoken $0.002 / 1K token Utdata · Utdatatoken $0.012 / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token
KonfigurationNivå 2 för förfrågans längd	Prislista—	Kontexttoken, fler än200 000	Kontexttoken, upp till och medIngen övre gräns	Avgift Indata · Indatatoken $0.004 / 1K token Utdata · Utdatatoken $0.018 / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

Ailoot Ultra · Batchkörning

curl · bevarat referensexempelPython HTTP · kundens faktiska JSONLPython · spara varje färdigt resultat

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.

Ta emot och spara resultat

Ailoot Ultra · Batchkörning

JSON i inbäddade results[].response.body

GET /v1/batches/{operation_id}

Kontrollera jobbstatus

curl · status för ursprunglig åtgärd

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

Behåll alla färdiga resultat

Behåll varje fullständigt returnerat svar, fil och innehållsdel.

Spara hela det ursprungliga statusobjektet i JSON, varje resultat/custom_id och hela svars- eller felkroppen. Spara slutförda results[] som JSONL utan filtrering.

Om det ursprungliga svaret behöver kontrolleras

Behåll det ursprungliga operations-ID:t. Vid 503 result_pending_check gäller X-Should-Retry:false; skicka aldrig om en ursprunglig batch med okänt utfall.

Svarsfält

Fält	Typ
Fält`results[].custom_id`	Typstring
Fält`results[].response.body.choices[].message.content`	Typstring\|null
Fält`results[].error`	Typobject\|null
Fält`usage`	Typobject\|null
Fält`id`	Typstring
Fält`model`	Typstring
Fält`endpoint`	Typstring
Fält`status`	Typstring
Fält`request_counts`	Typobject
Fält`results[].id`	Typstring
Fält`results[].response.status_code`	Typinteger
Fält`results[].response.request_id`	Typstring

Fel och nästa steg

Svar	Villkor	Nästa steg
Svar400 · `invalid_request_error`	VillkorFörfrågan har ett ogiltigt inbäddat format enligt dokumentationen, duplicerade nycklar eller en felaktig objektidentitet, eller står i konflikt med modellens konfigurerade funktioner.	Nästa stegRätta de angivna fälten innan du skickar en ny förfrågan.
Svar401 · `authentication_error`	VillkorOgiltig API-nyckel.	Nästa stegAnvänd den behöriga Ailoot-nyckeln.
Svar403 · `permission_error`	VillkorGrupp för batchkörning är inte tillgänglig.	Nästa stegKontrollera nyckelns/gruppens behörighet.
Svar422 · `invalid_request_error`	VillkorBatchkörning debiteras från saldot; skapande via abonnemang avvisas.	Nästa stegAnvänd den behöriga gruppen med saldodebitering.
Svar422 · `price_unavailable`	VillkorKostnaden för batchindata kan inte beräknas i förväg.	Nästa stegSpara svaret; använd det dokumenterade indataformatet för API-familjen.
Svar402 · `billing_error`	VillkorReservation för batchkörning är inte tillgänglig.	Nästa stegSe till att villkoren för att godta förfrågan är uppfyllda innan du skickar en ny.
Svar503 · `price_unavailable`	VillkorPriset för batchmetoden eller de inbyggda priserna är inte tillgängliga.	Nästa stegSpara svaret; ersätt inte priserna med andra.
Svar503 · `api_error`	VillkorDen exakta leverantörsrutten är inte tillgänglig.	Nästa stegSpara svaret för att kunna reparera routningen.
Svar503 · `result_pending_check`	VillkorDet ursprungliga resultatet behöver kontrolleras; X-Should-Retry:false.	Nästa stegBehåll det ursprungliga värdet för operation_id/id och läs av operationens status; upprepa aldrig det ursprungliga POST-anropet.
Svar404 · `not_found`	VillkorOperationen för batchstatus saknas eller tillhör en annan identitet.	Nästa stegAnvänd exakt det ursprungliga id-värdet och samma användare/nyckel/grupp.

Alias

Modellalias

Ailoot Ultra google/gemini-3.1-pro-preview:batch

Alias för metodsökvägar

Använd metodsökvägarna som visas ovan.

Relaterade anropar-ID:n

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)

Vilka indata och resultat finns?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: text → text
Vilka fält använder begäran?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: endpoint, model, requests, completion_window, provider
Vilka gränser gäller?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: requests.min_items: 1

Google: Gemini 3.1 Pro Preview (batch)