Google: Gemini 2.5 Pro (batch)

Gemini 2.5 Pro je Googlov stabilni model z razmišljanjem za zahtevno kodo, matematiko, STEM in analizo dolgega konteksta. Sprejema besedilo, slike, zvok, video in PDF ter vrača besedilo s podporo za orodja in strukturiran izhod. Njegov dinamični proračun sklepanja podpira 128–32,768 žetonov, razmišljanja pa ni mogoče povsem izključiti.

Ailoot Ultra · Paketna obdelava POST /v1/batches google/gemini-2.5-pro:batch

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Gemini 2.5 Pro je Googlov stabilni profil z razmišljanjem za napredno programiranje, matematiko, STEM in analizo dolgega konteksta. Razume besedilo, zvok, slike, video in celotne repozitorije kode, njegov profil Gemini API pa sprejema tudi vhod PDF. Izhod je besedilo, vključno s kodo, pisno analizo ali strukturiranim zapisom. Uporabna naloga zagotovi dokaze in zahteva rezultat, ki ga je mogoče preveriti, na primer pojasnjeno rešitev, ugotovitev o kodni zbirki ali primerjavo več dokumentov.

Pri programiranju priložite ustrezne datoteke, opaženo vedenje in pomembno spremembo ali vprašanje. Dolg kontekst lahko modelu pomaga povezati module, namesto da bi sklepal iz enega ločenega izseka. Pri raziskovanju poti skozi kodo mu naročite, naj sledi identifikatorju od vhodnega obrazca prek obdelave do shranjevanja, prepozna mesto spremembe podatkovnega dogovora in predlaga ciljno usmerjen popravek. Ohranite omejitve in zahtevajte podporne sklice. Predlagano spremembo je treba primerjati z dejansko kodo in morebitnim preverjanjem, opravljenim prek povezanih orodij.

Pri matematični ali znanstveni analizi navedite problem, predpostavke, enote in zahtevano obliko odgovora. Priložite podatke ali prikaze, od katerih je odvisen izračun. Zahtevajte podprt rezultat in preverjanja, ki omogočajo njegovo presojo, na primer robne primere ali primerjavo z izvirnimi vrednostmi. Zmožnost sklepanja modela ne odpravi dvoumnosti v opredelitvi problema. Neznana količina ali nepodprta predpostavka naj ostane vidna, namesto da bi jo nadomestili s priročno vrednostjo.

Dinamično razmišljanje je dokumentirana privzeta nastavitev. Vodnik Gemini 2.5 GenerateContent za Pro podpira izrecni proračun sklepanja od 128 do 32,768 žetonov ali -1 za prilagodljivo razmišljanje. Pri tej izdaji razmišljanja ni mogoče povsem izključiti. Te nastavitve se razlikujejo od možnosti ničelnega proračuna pri Flash in od nastavitev ravni razmišljanja Gemini 3. Proračun razmišljanja usmerja sklepanje, ne zagotavlja pa natančnega števila notranjih žetonov; tudi omejitev odgovora mora pustiti prostor za končni izdelek.

Pri multimodalnem delu z dokumenti določite strani, graf, območje slike ali dogodek v posnetku, ki naj podprejo odgovor. Praktična naloga sinteze lahko zahteva nasprotujoče si trditve iz več izvornih dokumentov, njihove podporne odlomke in razlike, pomembne za eno odločitev. Modelu naročite, naj loči navedeno dejstvo od sklepa. Pri videu ali zvoku določite, ali naj bo rezultat opis, prepis, povzetek ali primerjava. Slika in zvok sta v tem profilu dokazno gradivo za besedilni rezultat.

Stran API za ta model dokumentira klicanje funkcij, izvajanje kode, iskanje po datotekah, utemeljevanje z iskanjem, utemeljevanje s podatki Maps, kontekst URL in strukturirane izhode. Določite namene funkcij in polja parametrov ter v poznejših izmenjavah ohranite dejanske rezultate. Pri zapisu, omejenem s shemo, določite obvezna polja in način predstavitve manjkajočih informacij. Gre za izvirno multimodalno arhitekturo tipa transformer z redko mešanico ekspertov; ta zasnova modela sama po sebi ne zagotavlja izvajanja zunanjega orodja ali dokončane aplikacije poleg vrnjenega besedila ali kode.

Izvirna kartica navaja vhodni kontekst 1M in besedilni izhod 64K; preglednica API določa 1,048,576 vhodnih žetonov in 65,536 izhodnih žetonov. Navodila, izvorna vsebina in ohranjena zgodovina prispevajo k pripravi vhoda. Največji dovoljeni obseg odgovora vključuje žetone sklepanja, zato lahko premajhna omejitev prekine končni odgovor. Dokumentirana sta predpomnjenje in paketna obdelava ter možnosti Flex in Priority. Pri pripravi neodvisnih nalog z dolgim kontekstom ohranite identifikator vsakega vira in zahtevano končno obliko.

Identifikator stabilne različice se razlikuje od izdaj Experimental in Preview, ki sta ločeno obravnavani v skupni kartici modela Pro. Njunih rezultatov, značilnih za posamezno različico, ne pripisujte temu profilu zgolj zato, ker imajo izdaje v imenu Pro. Kartica navaja možne halucinacije in omejitve pri razumevanju vzročnosti, zahtevnem sklepanju in protidejstvenem sklepanju ter mejni datum znanja januar 2025. Kadar je pomembno, priložite aktualne dokaze in preglejte sklice na vire, izračune ter predlagane spremembe. Uporaben izhod je podprt besedilni ali kodni izdelek, ki ga zahteva naloga.

Ailoot Ultra · Paketna obdelava POST /v1/batches google/gemini-2.5-pro:batch

google/gemini-2.5-pro:batch

Google /google/gemini-2.5-pro:batch

Začetek

Dovoljeni vhodi: Besedilo
Rezultati: Besedilo

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Paketna obdelava POST /v1/batches

Vhod: text
Izhod: text
Izhodni format: Neposredno vključeni podatki JSON v results[].response.body

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`endpoint`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve /v1/chat/completions	Privzeto—
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve google/gemini-2.5-pro:batch	Privzeto—
Polje`requests`	Vrsta`batch_item[]`	ZahtevaObvezno	Vrednosti in omejitve Najmanjše število elementov: 1	Privzeto—
Polje`requests[].custom_id`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve	Privzeto—
Polje`requests[].body.messages`	Vrsta`message[]`	ZahtevaObvezno	Vrednosti in omejitve	Privzeto—
Polje`completion_window`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 24h	Privzeto—
Polje`provider`	Vrsta`object\|null`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—
Polje`requests[].body.model`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve google/gemini-2.5-pro:batch, google/gemini-2.5-pro	Privzeto—
Polje`provider.only`	Vrsta`string[]`	ZahtevaIzbirno	Vrednosti in omejitve google-vertex/global	Privzeto—
Polje`provider.allow_fallbacks`	Vrsta`boolean\|null`	ZahtevaIzbirno	Vrednosti in omejitve false, null	Privzeto—

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijaendpoint, model, requests
Parameter`material_types`	Specifikacijatext
Parameter`representation`	SpecifikacijaNeposredno vključene zahteve v requests[]; vsak element ima custom_id in body
Parameter`request_endpoint_profile`	Specifikacija/v1/chat/completions
Parameter`file_material`	SpecifikacijaKlicatelj lahko dejansko datoteko JSONL v kodiranju UTF-8 lokalno prebere v requests[]. Namen nalaganja, input_file_id ali sklic na datoteko se ne uporablja. Če gradivo stranke manjka ali je prazno, se priprava ustavi pred POST.
Parameter`serialization_order`	Specifikacijaendpoint, model, provider (če je podan), completion_window (če je podan), requests na koncu
Parameter`optional_controls`	Specifikacijaprovider.only, provider.allow_fallbacks, completion_window
Parameter`schema_scope`	SpecifikacijaTelesa besedilnih zahtev Chat Completions v dokumentiranem ovoju za paketno obdelavo, ki zahteve vsebuje neposredno.

Življenjski cikel: asynchronous

GET /v1/batches/{operation_id} · Dejanski response.id iz izvirnega odgovora na zahtevo za ustvarjanje; isti uporabnik, isti ključ in ista skupina

Cenik

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Cene izrecnega predpomnjenja: Ni omogočeno Ko je zahtevano eksplicitno predpomnjenje

Cene Ailoot

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Žetonov konteksta več kot	Žetonov konteksta do vključno	Strošek
NastavitevOsnovne cene za žetone	Cenovna lestvicaOsnovna cena	Žetonov konteksta več kot—	Žetonov konteksta do vključnoBrez zgornje meje	Strošek Vhod · Vhodni žetoni $0.00125 / 1K žetonov Izhod · Izhodni žetoni $0.01 / 1K žetonov Vhod · Branje predpomnilnika $0.00025 / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov
NastavitevRazred 1 glede na dolžino zahteve	Cenovna lestvica—	Žetonov konteksta več kot0	Žetonov konteksta do vključno200.000	Strošek Vhod · Vhodni žetoni $0.00125 / 1K žetonov Izhod · Izhodni žetoni $0.01 / 1K žetonov Vhod · Branje predpomnilnika $0.00025 / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov
NastavitevRazred 2 glede na dolžino zahteve	Cenovna lestvica—	Žetonov konteksta več kot200.000	Žetonov konteksta do vključnoBrez zgornje meje	Strošek Vhod · Vhodni žetoni $0.0025 / 1K žetonov Izhod · Izhodni žetoni $0.015 / 1K žetonov Vhod · Branje predpomnilnika $0.0005 / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Paketna obdelava

curl · ohranjeni referenčni primerPython HTTP · dejanski podatki stranke v JSONLPython · shranite vsak dokončan rezultat

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

Prejmi in shrani rezultate

Ailoot Ultra · Paketna obdelava

Neposredno vključeni podatki JSON v results[].response.body

GET /v1/batches/{operation_id}

Preveri stanje opravila

curl · stanje izvirne operacije

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

Ohrani vse dokončane rezultate

Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.

Shranite celoten izvirni JSON s stanjem, vsak rezultat/custom_id in celotno telo odgovora ali napake. Dokončane rezultate iz results[] shranite kot JSONL brez filtriranja.

Če je treba preveriti izvirni odgovor

Shranite izvirni ID operacije. Odgovor 503 result_pending_check vsebuje X-Should-Retry:false; izvirnega paketa z neznanim izidom nikoli ne pošiljajte znova.

Polja odgovora

Polje	Vrsta
Polje`results[].custom_id`	Vrstastring
Polje`results[].response.body.choices[].message.content`	Vrstastring\|null
Polje`results[].error`	Vrstaobject\|null
Polje`usage`	Vrstaobject\|null
Polje`id`	Vrstastring
Polje`model`	Vrstastring
Polje`endpoint`	Vrstastring
Polje`status`	Vrstastring
Polje`request_counts`	Vrstaobject
Polje`results[].id`	Vrstastring
Polje`results[].response.status_code`	Vrstainteger
Polje`results[].response.request_id`	Vrstastring

Napake in naslednji koraki

Odgovor	Pogoj	Naslednji korak
Odgovor400 · `invalid_request_error`	PogojNeveljaven dokumentirani ovoj z neposredno vključenimi zahtevami, podvojeni ključi, neveljavna identiteta elementa ali neskladje z nastavljenimi zmogljivostmi modela.	Naslednji korakPred vsakim novim pošiljanjem popravite navedena polja.
Odgovor401 · `authentication_error`	PogojNeveljaven ključ API.	Naslednji korakUporabite odobreni ključ Ailoot.
Odgovor403 · `permission_error`	PogojSkupina za paketno obdelavo ni na voljo.	Naslednji korakPreverite pravice ključa/skupine.
Odgovor422 · `invalid_request_error`	PogojPaketna obdelava uporablja obračunavanje iz dobroimetja; ustvarjanje v okviru naročnine se zavrne.	Naslednji korakUporabite odobreno skupino z obračunavanjem iz dobroimetja.
Odgovor422 · `price_unavailable`	PogojZa vhodne podatke paketa ni mogoče izračunati predračuna.	Naslednji korakShranite odgovor; uporabite dokumentirani vhod za to družino metod.
Odgovor402 · `billing_error`	PogojRezervacija sredstev za paketno obdelavo ni na voljo.	Naslednji korakPred novo zahtevo uredite pogoje za njen sprejem.
Odgovor503 · `price_unavailable`	PogojCena metode paketne obdelave oziroma izvorne tarife niso na voljo.	Naslednji korakShranite odgovor; cen ne nadomeščajte z drugimi.
Odgovor503 · `api_error`	PogojTočno določena pot do dobavitelja ni na voljo.	Naslednji korakShranite odgovor za odpravo napake v usmerjanju.
Odgovor503 · `result_pending_check`	PogojIzvirni rezultat je treba preveriti; X-Should-Retry:false.	Naslednji korakShranite izvirni operation_id/id in preberite njegovo stanje; izvirnega POST nikoli ne ponovite.
Odgovor404 · `not_found`	PogojOperacija za preverjanje stanja paketa ne obstaja ali pripada drugi identiteti.	Naslednji korakUporabite natančen izvirni id ter istega uporabnika, isti ključ in isto skupino.

Druga imena

Druga imena modelov

Ailoot Ultra google/gemini-2.5-pro:batch

Druga imena poti metod

Uporabite zgoraj navedene poti metod.

Povezani ID-ji za klic

google/gemini-2.5-pro:batch

FAQ · Google: Gemini 2.5 Pro (batch)

Kateri vhodi in rezultati so na voljo?: POST /v1/batches · google/gemini-2.5-pro:batch: text → text
Katera polja uporablja zahteva?: POST /v1/batches · google/gemini-2.5-pro:batch: endpoint, model, requests, completion_window, provider
Katere omejitve veljajo?: POST /v1/batches · google/gemini-2.5-pro:batch: requests.min_items: 1

Google: Gemini 2.5 Pro (batch)