Google: Gemini 3.5 Flash (batch)
Gemini 3.5 Flash kombinerar multimodal förståelse med resonemang för programmering och agentuppgifter i flera steg. Den tar emot text, bilder, video, ljud och PDF och producerar text, med strukturerad utdata, verktyg och en indatagräns på 1,048,576 token i den dokumenterade profilen.
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.5 Flash är Googles multimodala Flash-modellprofil för uthålligt programmeringsarbete och agentbaserat arbete. Dess dokumenterade indata är text, bilder, video, ljud och PDF, med text som utdata. Modellens uppgiftsfokus omfattar iterativ programmering, utforskning av alternativa lösningar och längre sekvenser av instruktioner och verktygsanvändning. Utgåvan 3.5 erbjuder dokumenterade reglage för tänkande, multimodala indata och verktygsflöden.
En programmeringsuppgift kan kombinera ett skriftligt krav, relevanta källfiler och en skärmbild av det avsedda resultatet. Ange det observerade beteendet, det förväntade beteendet och de begränsningar som måste bevaras. En illustrativ uppdragsbeskrivning är: ”Jämför skärmbilden med komponenttexten, identifiera avvikelsen i formulärflödet och föreslå en avgränsad korrigering. Förklara vilka detaljer i källmaterialet som motiverar ändringen.” För en dokumentuppgift ska du tillhandahålla relevanta sidor och begära en jämförelse med uttryckliga krav, med källhänvisningar för varje iakttagelse.
Utgåvan dokumenterar tänkandenivåerna minimal, low, medium och high. Medium är standard, vilket är en ändring från standardnivån high i Gemini 3 Flash Preview. Minimal passar enkla svar och okomplicerade verktygsbeslut utan att garantera att resonemang är helt avstängt; low riktar sig till uppgifter som kräver färre steg; high ger djupare resonemang för svåra problem inom matematik, programmering och agentarbete. Google rekommenderar thinking_level för att styra arbetsinsatsen och att behålla standardinställningarna för sampling i stället för att försöka tvinga fram resonemang genom att ändra temperature, top-p eller top-k.
Ett utmärkande beteende är att resonemangskontexten bevaras över en uppgift med flera samtalsturer. Googles Interactions-flöde för med sig den kontexten automatiskt; GenerateContent-flödet kräver hela den oförändrade samtalshistoriken, inklusive thought signatures. Det stödjer ett fortlöpande felsöknings- eller refaktoreringsuppdrag där tidigare resonemang ligger till grund för nästa steg. Bevara samtalets faktiska struktur i stället för att omvandla varje uppföljning till en fristående prompt, och håll den slutliga efterfrågade artefakten tydlig medan arbetet fortskrider.
Den dokumenterade verktygsuppsättningen omfattar Google Search, förankring med Google Maps, File Search, Code Execution, URL Context och standardmässig Function Calling, medan kombinerad verktygsanvändning och Computer Use anges som förhandsfunktioner. Structured Outputs kan ge en definierad datapost. Ge funktioner ett tydligt syfte och definierade parametrar: modellen väljer en funktion, medan den anslutna applikationen utför åtgärden och returnerar resultatet. Google kräver att funktionsresultat matchar föregående anrop i identitet, namn och antal; multimodala resultat ska ligga i funktionssvaret.
Den exakta API-modelltabellen anger högst 1,048,576 indatatoken och högst 65,536 utdatatoken. Samtalshistorik och tillhandahållna medier bidrar till indatabudgeten. Cachelagring och batchbearbetning dokumenteras för profilen, med ytterligare alternativ för Flex- och Priority-bearbetning i Googles tabell. Dessa gränser och förmågor beskriver tillverkarens utgåva; de innebär inte att ett svar måste fylla hela utdatafönstret eller att varje verktyg behövs för en uppgift.
Profilen genererar text snarare än bilder eller ljud och använder inte Live API. Dess utvecklarguide utesluter också bildsegmentering. För en visuell fråga ska du begära en beskrivning, extraktion eller tolkning av det tillhandahållna materialet; för en talinspelning ska du begära ett textresultat. När svaret beror på nyare information kan det dokumenterade flödet för sökförankring tillföra källor utöver träningskunskapen. Ange om extern information behövs och vilka belägg det slutliga svaret ska behålla.
För ett användbart längre uppdrag ska du definiera slutresultatet och kriteriet för slutförande före det första steget. En supportanalys kan begära en tabell över observerade problem, stödjande textpassager och ett svarsförslag; en programmeringsuppgift kan kräva den avgränsade ändringen och relevant valideringsresultat. Bifoga den källkontext som är viktig, specificera tillåtna verktygsåtgärder och begär ett uttryckligt slutligt svar som skiljer slutfört arbete från frågor som fortfarande kräver information. Det omsätter modellens uthålliga arbetsflöde i en konkret text-, kod- eller strukturerad artefakt.
Ailoot Ultra · Batchkörning POST /v1/batches google/gemini-3.5-flash:batch
google/gemini-3.5-flash:batchStart
Gemini 3.5 Flash kombinerar multimodal förståelse med resonemang för programmering och agentuppgifter i flera steg. Den tar emot text, bilder, video, ljud och PDF och producerar text, med strukturerad utdata, verktyg och en indatagräns på 1,048,576 token i den dokumenterade profilen.
- 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ältendpoint | Typstring | KravObligatoriskt | Värden & gränser /v1/chat/completions | Standard— |
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser google/gemini-3.5-flash:batch | Standard— |
Fältrequests | Typbatch_item[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 | Standard— |
Fältrequests[].custom_id | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältrequests[].body.messages | Typmessage[] | KravObligatoriskt | Värden & gränser | Standard— |
Fältcompletion_window | Typstring | KravValfritt | Värden & gränser 24h | Standard— |
Fältprovider | Typobject|null | KravValfritt | Värden & gränser | Standard— |
Fältrequests[].body.model | Typstring | KravValfritt | Värden & gränser google/gemini-3.5-flash:batch, google/gemini-3.5-flash | Standard— |
Fältprovider.only | Typstring[] | KravValfritt | Värden & gränser google-vertex/global | Standard— |
Fältprovider.allow_fallbacks | Typboolean|null | KravValfritt | Värden & gränser false, null | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalendpoint, model, requests |
Parametermaterial_types | Avtaltext |
Parameterrepresentation | AvtalInbäddade requests[]; varje objekt har custom_id och body |
Parameterrequest_endpoint_profile | Avtal/v1/chat/completions |
Parameterfile_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. |
Parameterserialization_order | Avtalendpoint, model, provider (om angivet), completion_window (om angivet), requests sist |
Parameteroptional_controls | Avtalprovider.only, provider.allow_fallbacks, completion_window |
Parameterschema_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.0015 / 1K token Utdata · Utdatatoken $0.009 / 1K token Indata · Cacheläsning $0.00015 / 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 medIngen övre gräns | Avgift Indata · Indatatoken $0.0015 / 1K token Utdata · Utdatatoken $0.009 / 1K token Indata · Cacheläsning $0.00015 / 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
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.
Ta emot och spara resultat
Ailoot Ultra · Batchkörning
JSON i inbäddade results[].response.body
GET /v1/batches/{operation_id}
Kontrollera jobbstatus
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ältresults[].custom_id | Typstring |
Fältresults[].response.body.choices[].message.content | Typstring|null |
Fältresults[].error | Typobject|null |
Fältusage | Typobject|null |
Fältid | Typstring |
Fältmodel | Typstring |
Fältendpoint | Typstring |
Fältstatus | Typstring |
Fältrequest_counts | Typobject |
Fältresults[].id | Typstring |
Fältresults[].response.status_code | Typinteger |
Fältresults[].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.5-flash:batch
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Google: Gemini 3.5 Flash (batch)
- Vilka indata och resultat finns?
POST /v1/batches·google/gemini-3.5-flash:batch:text→text- Vilka fält använder begäran?
POST /v1/batches·google/gemini-3.5-flash:batch:endpoint,model,requests,completion_window,provider- Vilka gränser gäller?
POST /v1/batches·google/gemini-3.5-flash:batch:requests.min_items:1