Google: Gemini 3 Flash Preview (batch)

Gemini 3 Flash Preview kombinuje multimodální porozumění a uvažování s textovým výstupem. Podporuje analýzu kódu, dokumentů a vizuálních podkladů, strukturované výsledky a pracovní postupy orientované na nástroje se čtyřmi dokumentovanými úrovněmi přemýšlení pro volbu hloubky analýzy.

Ailoot Ultra · Dávka POST /v1/batches google/gemini-3-flash-preview:batch

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Gemini 3 Flash Preview je model uvažování od Googlu pro multimodální porozumění, programování a agentní úlohy. Přijímá text, obrázky, video, zvuk a PDF a vrací text. Požadavek tak může propojit písemné instrukce, zdrojové soubory, vizuální pozorování a historii konverzace kolem jednoho problému. Výsledkem může být vysvětlení, návrh kódu, extrahovaná data nebo plán podložený těmito materiály, nikoli vygenerovaný obrázek nebo mluvená odpověď.

Přesná karta modelu uvádí vstupní limit 1,048,576 tokenů a výstupní limit 65,536 tokenů. Zdroj a výsledek plánujte odděleně: dlouhý úryvek repozitáře, kolekce dokumentů nebo nahrávka se vejdou pouze tehdy, pokud se jejich zpracovaná reprezentace a instrukce vejdou do vstupního rozpočtu, a odpověď stále potřebuje vlastní přidělenou délku. Související zdroje označte a určete, které materiály jsou autoritativní. U dlouhého promptu vývojářský průvodce doporučuje umístit konkrétní otázku za data a výslovně ji navázat na předchozí informace.

Přemýšlení je dynamické a dokumentovanou výchozí hodnotou pro tento model je high. Podporované úrovně jsou minimal, low, medium a high. Jde o relativní rozsahy uvažování, nikoli o zaručené počty tokenů. Minimal může u obtížného programátorského problému stále zahrnovat určité uvažování. Úroveň vybírejte podle úlohy: krátká transformace a ladicí problém s více podmínkami potřebují odlišné zacházení. Používejte přímé, jasné instrukce namísto vynucování složitých rituálů uvažování v promptu; požadujte konečný výstup a kontroly, které jej učiní použitelným.

Karta výrobce uvádí strukturované výstupy, volání funkcí, spouštění kódu, ovládání počítače, vyhledávání v souborech, ukotvení ve vyhledávání, ukotvení v Google Maps, URL context a ukládání do mezipaměti. V dokumentovaném postupu Gemini 3 lze vestavěné nástroje kombinovat s voláním vlastních funkcí. Aplikace definuje funkce, kontroluje jejich argumenty, provádí přijaté akce a zasílá zpět jejich výsledky. U asistenta pro kód může nástroj pro čtení souboru nebo řízený spouštěč testů dodat konkrétní podklady pro další krok. Navrhovaná akce a pozorovaný výsledek nástroje by měly v závěrečné zprávě zůstat oddělené.

Pro programování poskytněte příslušné soubory, jazyk, očekávané chování a vstup, který problém demonstruje. Stanovte rozsah změny a pojmenujte rozhraní nebo chování, které musí zůstat zachováno. Požadujte upravenou implementaci a případy, které se mají ověřit. U analytické dokumentové úlohy definujte otázku, povinná pole a odkazy na zdroje. Pokud používáte strukturovaný výstup, poskytněte schéma s jasným významem polí a pravidly pro chybějící hodnoty. Validujte jeho syntaxi i to, zda každá hodnota vyplývá z původního materiálu.

U multimodální analýzy určete, co je podstatné v každém zdroji. Snímek obrazovky může podpořit vysvětlení rozhraní, PDF může dodat tabulku nebo graf a nahrávka může poskytnout mluvené či viditelné události. Vývojářský průvodce rozebírá ovládání rozlišení médií, protože detail mění zpracovanou reprezentaci a spotřebu tokenů. Pracovní postup výrobce pro spouštění kódu může ořezat či přiblížit dodané obrázky, provádět výpočty z vizuálních dat a přidávat anotace před přípravou odpovědi modelem. Čitelnost drobného textu může vyžadovat jiné nastavení než široký popis scény. Příslušnou stránku, obrázek nebo klip uchovávejte dostupné, aby bylo možné pozorování ověřit, místo abyste plynulé shrnutí považovali za důkaz správného přečtení každého detailu.

Stav konverzace a nástrojů musí být ve vybraném rozhraní zachován. Gemini 3 používá podpisy myšlenek k přenášení kontextu uvažování mezi voláními; vývojářský průvodce rozlišuje spravovanou stavovou historii a ručně spravovanou bezstavovou historii. Při pokračování úlohy s nástroji nebo revizi výsledku zachovejte potřebný kontext. Google také doporučuje ponechat výchozí temperature 1.0 namísto přebírání postupu s nízkou hodnotou temperature, který může u složitých úloh způsobit smyčky nebo zhoršené chování. Jde o integrační postupy výrobce, nikoli o nová tvrzení o přenosové vrstvě konkrétní aplikace.

Textový model neuvádí generování obrázků nebo zvuku ani Live API. Průvodce také odlišuje vizuální porozumění od segmentace obrázků na úrovni pixelů, která není podporovanou schopností Gemini 3 Flash. Používejte vhodný závěrečný výsledek pro skutečnou úlohu: pozorování propojená se zdroji, strukturovaný záznam, změnu kódu nebo rozhodnutí s uvedenými předpoklady. Zkontrolujte aritmetiku, ověřte kód v zamýšleném prostředí a přezkoumejte vrácené informace z nástrojů. Pokud záleží na aktuálních faktech, použijte nakonfigurované zdroje ukotvení nebo dodaná aktuální data namísto předpokladu, že znalosti modelu představují živou databázi.

Ailoot Ultra · Dávka POST /v1/batches google/gemini-3-flash-preview:batch

google/gemini-3-flash-preview:batch

Google /google/gemini-3-flash-preview:batch

Úvod

Přijímané vstupy: Text
Výsledky: Text

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Dávka POST /v1/batches

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

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`endpoint`	Typ`string`	PožadavekPovinné	Hodnoty a limity /v1/chat/completions	Výchozí—
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity google/gemini-3-flash-preview:batch	Výchozí—
Pole`requests`	Typ`batch_item[]`	PožadavekPovinné	Hodnoty a limity Minimální počet položek: 1	Výchozí—
Pole`requests[].custom_id`	Typ`string`	PožadavekPovinné	Hodnoty a limity	Výchozí—
Pole`requests[].body.messages`	Typ`message[]`	PožadavekPovinné	Hodnoty a limity	Výchozí—
Pole`completion_window`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 24h	Výchozí—
Pole`provider`	Typ`object\|null`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`requests[].body.model`	Typ`string`	PožadavekVolitelné	Hodnoty a limity google/gemini-3-flash-preview:batch, google/gemini-3-flash-preview	Výchozí—
Pole`provider.only`	Typ`string[]`	PožadavekVolitelné	Hodnoty a limity google-vertex/global	Výchozí—
Pole`provider.allow_fallbacks`	Typ`boolean\|null`	PožadavekVolitelné	Hodnoty a limity false, null	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktendpoint, model, requests
Parametr`material_types`	Kontrakttext
Parametr`representation`	Kontraktvložené requests[]; každá položka obsahuje custom_id a body
Parametr`request_endpoint_profile`	Kontrakt/v1/chat/completions
Parametr`file_material`	KontraktVolající může lokálně načíst skutečný soubor JSONL v kódování UTF-8 do requests[]. Nepoužívá se účel nahrání, input_file_id ani odkaz na soubor. Chybějící nebo prázdné podklady zákazníka zastaví přípravu před POST.
Parametr`serialization_order`	Kontraktendpoint, model, provider (je-li uveden), completion_window (je-li uvedeno), requests nakonec
Parametr`optional_controls`	Kontraktprovider.only, provider.allow_fallbacks, completion_window
Parametr`schema_scope`	KontraktTěla požadavků Text Chat Completions v dokumentované obálce pro vložené dávkové požadavky Batch.

Životní cyklus: asynchronous

GET /v1/batches/{operation_id} · skutečné response.id z původní odpovědi na vytvoření; stejný uživatel, klíč a skupina

Tarify

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Ceny explicitní mezipaměti: Není zapnuto Při požadavku na explicitní mezipaměť

Sazby Ailoot

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Tokeny kontextu, více než	Tokeny kontextu, do uvedené hodnoty včetně	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Tokeny kontextu, více než—	Tokeny kontextu, do uvedené hodnoty včetněBez horní meze	Poplatek Vstup · Vstupní tokeny $0.0005 / 1K tokenů Výstup · Výstupní tokeny $0.003 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů
KonfiguracePásmo délky požadavku 1	Tabulka sazeb—	Tokeny kontextu, více než0	Tokeny kontextu, do uvedené hodnoty včetněBez horní meze	Poplatek Vstup · Vstupní tokeny $0.0005 / 1K tokenů Výstup · Výstupní tokeny $0.003 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · Dávka

curl · uložená testovací dataPython HTTP · skutečná data zákazníka ve formátu JSONLPython · uložte každý dokončený výsledek

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

Přijímání a ukládání výsledků

Ailoot Ultra · Dávka

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

GET /v1/batches/{operation_id}

Ověřit stav úlohy

curl · stav původní operace

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

Uchovejte všechny dokončené výsledky

Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.

Uchovejte úplný původní JSON se stavem, každý výsledek a custom_id a úplné tělo odpovědi nebo chyby. Dokončené results[] uložte jako JSONL bez filtrování.

Pokud je nutné ověřit původní odpověď

Uchovejte původní ID operace. Odpověď 503 result_pending_check obsahuje X-Should-Retry:false; původní dávku s neznámým výsledkem nikdy znovu neodesílejte.

Pole odpovědi

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 další kroky

Odpověď	Podmínka	Další krok
Odpověď400 · `invalid_request_error`	PodmínkaNeplatná dokumentovaná obálka vložených požadavků, duplicitní klíče, nesprávná identita položky nebo rozpor s nastavenými schopnostmi modelu.	Další krokPřed jakýmkoli novým odesláním opravte označená pole.
Odpověď401 · `authentication_error`	PodmínkaNeplatný klíč API.	Další krokPoužijte autorizovaný klíč Ailoot.
Odpověď403 · `permission_error`	PodmínkaSkupina pro dávkové požadavky není dostupná.	Další krokZkontrolujte oprávnění klíče a skupiny.
Odpověď422 · `invalid_request_error`	PodmínkaDávkové požadavky se účtují ze zůstatku; vytvoření v rámci předplatného se odmítá.	Další krokPoužijte autorizovanou skupinu s účtováním ze zůstatku.
Odpověď422 · `price_unavailable`	PodmínkaPro vstup dávky nelze vypočítat cenovou nabídku.	Další krokUchovejte odpověď; použijte dokumentovaný vstup pro danou rodinu API.
Odpověď402 · `billing_error`	PodmínkaRezerva pro dávku není dostupná.	Další krokPřed novým požadavkem vyřešte podmínky přijetí.
Odpověď503 · `price_unavailable`	PodmínkaCena dávkové metody nebo nativní sazby nejsou dostupné.	Další krokUchovejte odpověď; nenahrazujte ceny jinými.
Odpověď503 · `api_error`	PodmínkaPřesná trasa dodavatele není dostupná.	Další krokUchovejte odpověď pro opravu směrování.
Odpověď503 · `result_pending_check`	PodmínkaPůvodní výsledek vyžaduje kontrolu; X-Should-Retry:false.	Další krokUchovejte původní operation_id/id a načítejte jeho stav; původní POST nikdy neopakujte.
Odpověď404 · `not_found`	PodmínkaOperace pro kontrolu stavu dávky neexistuje nebo patří jiné identitě.	Další krokPoužijte přesné původní id a stejného uživatele, klíč a skupinu.

Aliasy

Aliasy modelu

Ailoot Ultra google/gemini-3-flash-preview:batch

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

google/gemini-3-flash-preview:batch

FAQ · Google: Gemini 3 Flash Preview (batch)

Jaké vstupy a výsledky jsou dostupné?: POST /v1/batches · google/gemini-3-flash-preview:batch: text → text
Jaká pole požadavek používá?: POST /v1/batches · google/gemini-3-flash-preview:batch: endpoint, model, requests, completion_window, provider
Jaké limity platí?: POST /v1/batches · google/gemini-3-flash-preview:batch: requests.min_items: 1

Google: Gemini 3 Flash Preview (batch)