Google: Gemini 2.5 Pro (batch)

Gemini 2.5 Pro je stabilný model spoločnosti Google s uvažovaním na zložitý kód, matematiku, STEM a analýzu dlhého kontextu. Prijíma text, obrázky, zvuk, video a PDF a vracia text s podporou nástrojov a štruktúrovaného výstupu. Jeho dynamický rozpočet uvažovania podporuje 128–32 768 tokenov a nemožno ho úplne vypnúť.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-2.5-pro:batch

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Gemini 2.5 Pro je stabilný profil spoločnosti Google s uvažovaním na pokročilé programovanie, matematiku, STEM a analýzu dlhého kontextu. Dokáže porozumieť textu, zvuku, obrázkom, videu aj celým repozitárom kódu a jeho profil Gemini API prijíma aj vstup PDF. Výstupom je text vrátane kódu, písomnej analýzy alebo štruktúrovaného záznamu. Užitočné zadanie poskytuje dôkazy a žiada výsledok, ktorý sa dá skontrolovať, napríklad vysvetlené riešenie, zistenie z kódovej základne alebo porovnanie viacerých dokumentov.

Pri programovaní poskytnite relevantné súbory, pozorované správanie a podstatnú zmenu alebo otázku. Dlhý kontext môže modelu pomôcť prepájať moduly namiesto uvažovania z jedného izolovaného úryvku. Pri skúmaní cesty kódom ho požiadajte, aby sledoval identifikátor od vstupného formulára cez spracovanie až po uloženie, identifikoval miesto zmeny kontraktu a navrhol cielenú opravu. Zachovajte obmedzenia a žiadajte podporné odkazy. Navrhovanú revíziu treba porovnať so skutočným kódom a s overením vykonaným prostredníctvom pripojených nástrojov.

Pri matematickej alebo vedeckej analýze uveďte problém, predpoklady, jednotky a požadovanú podobu odpovede. Poskytnite dáta alebo obrázky, od ktorých výpočet závisí. Žiadajte podložený výsledok a kontroly umožňujúce jeho posúdenie, napríklad hraničné prípady alebo porovnanie s pôvodnými hodnotami. Schopnosť modelu uvažovať neodstraňuje nejednoznačnosť zadania. Neznámu veličinu alebo nepodložený predpoklad ponechajte viditeľný namiesto nahradenia pohodlnou hodnotou.

Dokumentovaným predvoleným nastavením je dynamické uvažovanie. Príručka Gemini 2.5 GenerateContent podporuje pre Pro výslovný rozpočet uvažovania od 128 do 32 768 tokenov alebo -1 pre adaptívne uvažovanie. V tejto edícii nemožno uvažovanie úplne vypnúť. Toto ovládanie sa líši od možnosti nulového rozpočtu pri Flash aj od nastavení úrovní uvažovania Gemini 3. Rozpočet usmerňuje uvažovanie, ale nezaručuje presný počet vnútorných tokenov, a limit odpovede musí ponechať priestor aj pre konečný artefakt.

Pri multimodálnej práci s dokumentmi identifikujte stránky, graf, oblasť obrázka alebo udalosť v nahrávke, ktoré majú podporiť odpoveď. Praktická úloha syntézy môže žiadať konkurenčné tvrdenia z viacerých zdrojových dokumentov, ich podporné pasáže a rozdiely podstatné pre jedno rozhodnutie. Požiadajte model, aby odlišoval výslovne uvedený fakt od odvodenia. Pri videu alebo zvuku definujte, či má byť výsledkom opis, prepis, zhrnutie alebo porovnanie. Obraz a zvuk sú v tomto profile dôkazmi pre textový výsledok.

Stránka konkrétneho API dokumentuje volanie funkcií, vykonávanie kódu, vyhľadávanie v súboroch, ukotvenie vo vyhľadávaní, ukotvenie v Maps, kontext URL a štruktúrované výstupy. Definujte účel funkcií a polia parametrov a v ďalších ťahoch zachovajte skutočné výsledky. Pri zázname obmedzenom schémou určte povinné polia a spôsob reprezentácie chýbajúcich informácií. Natívna architektúra je multimodálny riedky transformátor typu mixture-of-experts; tento návrh modelu sám osebe neposkytuje externé vykonanie nástroja ani hotovú aplikáciu nad rámec vráteného textu či kódu.

Oficiálna karta uvádza vstupný kontext 1M a textový výstup 64K; tabuľka API uvádza 1 048 576 vstupných a 65 536 výstupných tokenov. Pokyny, zdrojový obsah a zachovaná história sa podieľajú na príprave vstupu. Maximálny limit odpovede zahŕňa tokeny uvažovania, preto príliš malý limit môže prerušiť konečnú odpoveď. Dokumentované sú ukladanie do vyrovnávacej pamäte a dávkové spracovanie spolu s možnosťami Flex a Priority. Pri príprave nezávislých úloh s dlhým kontextom zachovajte identifikátor každého zdroja a požadovanú konečnú podobu.

Stabilný identifikátor sa líši od edícií Experimental a Preview, ktoré spoločná karta modelu Pro rozoberá samostatne. Nepriraďujte ich výsledky špecifické pre danú verziu tomuto profilu iba preto, že zdieľajú názov Pro. Karta uvádza možné halucinácie a obmedzenia v chápaní príčinnosti, zložitej dedukcii a kontrafaktuálnom uvažovaní s hranicou znalostí v januári 2025. Keď je to podstatné, poskytnite aktuálne dôkazy a skontrolujte odkazy na zdroje, výpočty a navrhované úpravy. Užitočným výstupom je podložený textový alebo kódový artefakt požadovaný úlohou.

Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-2.5-pro:batch

google/gemini-2.5-pro:batch

Google /google/gemini-2.5-pro:batch

Úvod

Povolené vstupy: Text
Výsledky: Text

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Dávkové spracovanie POST /v1/batches

Vstup: text
Výstup: text
Výstupný formát: JSON priamo vložený v results[].response.body

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`endpoint`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity /v1/chat/completions	Predvolené—
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity google/gemini-2.5-pro:batch	Predvolené—
Pole`requests`	Typ`batch_item[]`	PožiadavkaPovinné	Hodnoty a limity Minimálny počet položiek: 1	Predvolené—
Pole`requests[].custom_id`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity	Predvolené—
Pole`requests[].body.messages`	Typ`message[]`	PožiadavkaPovinné	Hodnoty a limity	Predvolené—
Pole`completion_window`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 24h	Predvolené—
Pole`provider`	Typ`object\|null`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—
Pole`requests[].body.model`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity google/gemini-2.5-pro:batch, google/gemini-2.5-pro	Predvolené—
Pole`provider.only`	Typ`string[]`	PožiadavkaVoliteľné	Hodnoty a limity google-vertex/global	Predvolené—
Pole`provider.allow_fallbacks`	Typ`boolean\|null`	PožiadavkaVoliteľné	Hodnoty a limity false, null	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciaendpoint, model, requests
Parameter`material_types`	Špecifikáciatext
Parameter`representation`	Špecifikáciapriamo vložené requests[]; každá položka obsahuje custom_id a body
Parameter`request_endpoint_profile`	Špecifikácia/v1/chat/completions
Parameter`file_material`	ŠpecifikáciaVolajúci môže lokálne načítať skutočný súbor UTF-8 JSONL do requests[]. Nepoužíva sa účel nahrávania, input_file_id ani odkaz na súbor. Chýbajúce alebo prázdne podklady zákazníka zastavia prípravu pred POST.
Parameter`serialization_order`	Špecifikáciaendpoint, model, provider (ak je zadaný), completion_window (ak je zadaný), requests na konci
Parameter`optional_controls`	Špecifikáciaprovider.only, provider.allow_fallbacks, completion_window
Parameter`schema_scope`	ŠpecifikáciaTelá textových požiadaviek Chat Completions v zdokumentovanom obale dávky s priamo vloženými požiadavkami.

Životný cyklus: asynchronous

GET /v1/batches/{operation_id} · skutočná hodnota response.id z pôvodnej odpovede na vytvorenie; rovnaký používateľ/kľúč/skupina

Cenník

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Ceny explicitnej cache: Nie je zapnuté Keď sa požaduje explicitná cache

Sadzby Ailoot

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Počet tokenov kontextu väčší než	Tokeny kontextu, najviac (vrátane hranice)	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Počet tokenov kontextu väčší než—	Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.00125 / 1K tokenov Výstup · Výstupné tokeny $0.01 / 1K tokenov Vstup · Čítanie cache $0.00025 / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 1	Sadzobník—	Počet tokenov kontextu väčší než0	Tokeny kontextu, najviac (vrátane hranice)200 000	Poplatok Vstup · Vstupné tokeny $0.00125 / 1K tokenov Výstup · Výstupné tokeny $0.01 / 1K tokenov Vstup · Čítanie cache $0.00025 / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 2	Sadzobník—	Počet tokenov kontextu väčší než200 000	Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice	Poplatok Vstup · Vstupné tokeny $0.0025 / 1K tokenov Výstup · Výstupné tokeny $0.015 / 1K tokenov Vstup · Čítanie cache $0.0005 / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Dávkové spracovanie

curl · uložená vzorová požiadavkaPython HTTP · skutočné údaje zákazníka vo formáte JSONLPython · uložte každý hotový výsledok

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.

Prijať a uložiť výsledky

Ailoot Ultra · Dávkové spracovanie

JSON priamo vložený v results[].response.body

GET /v1/batches/{operation_id}

Skontrolovať stav úlohy

curl · stav pôvodnej operácie

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

Uchovať všetky dokončené výsledky

Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.

Uchovajte úplný pôvodný stav vo formáte JSON, každý výsledok/custom_id a úplné telo odpovede alebo chyby. Dokončené results[] uložte ako JSONL bez filtrovania.

Ak treba overiť pôvodnú odpoveď

Uchovajte pôvodné ID operácie. Odpoveď 503 result_pending_check obsahuje X-Should-Retry:false; pôvodnú dávku s neznámym výsledkom nikdy znova neodosielajte.

Polia odpovede

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

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNeplatný zdokumentovaný obal s priamo vloženými požiadavkami, duplicitné kľúče alebo konflikt identity položky či nastavených schopností modelu.	Ďalší krokPred akýmkoľvek novým odoslaním opravte označené polia.
Odpoveď401 · `authentication_error`	PodmienkaNeplatný kľúč API.	Ďalší krokPoužite kľúč Ailoot, ktorý ste oprávnení používať.
Odpoveď403 · `permission_error`	PodmienkaSkupina pre dávkové spracovanie nie je dostupná.	Ďalší krokSkontrolujte oprávnenie kľúča/skupiny.
Odpoveď422 · `invalid_request_error`	PodmienkaDávkové spracovanie sa účtuje zo zostatku; vytvorenie cez predplatné sa odmieta.	Ďalší krokPoužite skupinu s účtovaním zo zostatku, ktorú ste oprávnení používať.
Odpoveď422 · `price_unavailable`	PodmienkaPre vstup dávky nemožno vypočítať cenovú ponuku.	Ďalší krokUchovajte odpoveď; použite zdokumentovaný vstup pre danú rodinu metód.
Odpoveď402 · `billing_error`	PodmienkaRezerva pre dávkové spracovanie nie je dostupná.	Ďalší krokPred novou požiadavkou vyriešte podmienky prijatia.
Odpoveď503 · `price_unavailable`	PodmienkaCena metódy dávkového spracovania alebo natívne sadzby nie sú dostupné.	Ďalší krokUchovajte odpoveď; nenahrádzajte ceny inými.
Odpoveď503 · `api_error`	PodmienkaPresná trasa k dodávateľovi nie je dostupná.	Ďalší krokUchovajte odpoveď na účely opravy smerovania.
Odpoveď503 · `result_pending_check`	PodmienkaPôvodný výsledok je potrebné skontrolovať; X-Should-Retry:false.	Ďalší krokUchovajte pôvodné operation_id/id a čítajte jeho stav; pôvodný POST nikdy neopakujte.
Odpoveď404 · `not_found`	PodmienkaOperácia na zisťovanie stavu dávky neexistuje alebo patrí inej identite.	Ďalší krokPoužite presné pôvodné id a rovnakého používateľa/kľúč/skupinu.

Aliasy

Aliasy modelov

Ailoot Ultra google/gemini-2.5-pro:batch

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

google/gemini-2.5-pro:batch

FAQ · Google: Gemini 2.5 Pro (batch)

Aké vstupy a výsledky sú dostupné?: POST /v1/batches · google/gemini-2.5-pro:batch: text → text
Aké polia používa požiadavka?: POST /v1/batches · google/gemini-2.5-pro:batch: endpoint, model, requests, completion_window, provider
Aké limity platia?: POST /v1/batches · google/gemini-2.5-pro:batch: requests.min_items: 1

Google: Gemini 2.5 Pro (batch)