Google: Gemini 3.7 Flash (batch)
Gemini 3.7 Flash spája multimodálne uvažovanie s programovaním a viackrokovou prácou agentov. Profil verzie 3.7 od Googlu kladie dôraz na vernosť dizajnovým maketám a porozumenie videu pri práci agentov, pričom ponúka úrovne uvažovania low, medium a high. Prijíma text a médiá, vracia text a má zdokumentované limity 1 048 576 vstupných a 65 536 výstupných tokenov.
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 3.7 Flash je pomenovaný profil multimodálneho uvažovania od Googlu určený na programovanie, pracovné postupy s agentmi a viackrokové vykonávanie úloh. Nadväzuje na Gemini 3.6 Flash a prináša algoritmické zmeny v uvažovaní a podporu porozumenia videu pri práci agentov. Text, obrázky, zvuk, video a PDF môžu slúžiť ako zdrojový materiál na vytvorenie textového výsledku. Užitočné výstupy zahŕňajú cielenú úpravu kódu, porovnanie dizajnovej makety s implementáciou alebo analýzu udalostí v zázname podloženú zdrojovým materiálom.
Sprievodca pre vývojárov k verzii 3.7 zdôrazňuje lepšiu zhodu s dizajnovým návrhom pri práci na desktopových a webových rozhraniach. Pri tejto úlohe dodajte maketu zamýšľaného návrhu, relevantný zdrojový materiál a pozorovateľný nesúlad. Žiadajte porovnanie konkrétnych prvkov, napríklad rozstupov, stavov komponentov, hierarchie textu alebo správania pri interakciách. Pri porovnaní dizajnu si vyžiadajte zoznam nesúladov medzi maketou panelu nastavení a jeho existujúcou implementáciou, pričom každá navrhnutá oprava sa má viazať na snímku obrazovky alebo zdrojový materiál. Výsledok má určiť potrebné zmeny bez toho, aby bez upozornenia rozširoval dizajn nad rámec dodaných požiadaviek.
Pri programátorskom pracovnom postupe uveďte cieľ, existujúce správanie, relevantné súbory a obmedzenia. Google predstavuje verziu 3.7 ako vhodnú na riešenie softvérových problémov a znižovanie počtu neúspešných cyklov agentov, ale užitočná kontrola musí aj tak overiť skutočne vykonanú úpravu a výsledok overenia. V konverzácii zachovajte postupnosť pozorovaní získaných pomocou nástrojov, aby neskorší krok nezačínal vymysleným opisom zdrojového kódu projektu. Konečný výsledok môže odlíšiť navrhnutú zmenu od zmeny potvrdenej pomocou nástrojov prepojenej aplikácie.
Zdokumentované úrovne premýšľania sú low, medium a high, pričom predvolená je medium. Úroveň low umožňuje rýchlejšie odpovede v jasne vymedzenom rozsahu, zatiaľ čo high je určená na náročné uvažovanie a rozsiahlejšiu prácu s nástrojmi. Gemini 3.7 Flash nepodporuje úroveň premýšľania minimal. Krátka analýza jedného nesúladu v rozhraní a hlbšie skúmanie viacerých súborov preto vyžadujú odlišnú voľbu miery úsilia. Pred požiadavkou na dlhšiu postupnosť uvažovania a akcií definujte konečný artefakt a podmienky, ktoré musí splniť.
Stránka tohto konkrétneho modelu uvádza volanie funkcií, vykonávanie kódu, vyhľadávanie v súboroch, podloženie odpovedí výsledkami vyhľadávania, podloženie odpovedí údajmi zo služby Maps a kontext z URL adries. Funkcia Computer Use je označená ako preview a štruktúrované výstupy umožňujú definovať záznam s výsledkom. Požiadavka na volanie funkcie predstavuje navrhovanú operáciu, ktorú má prepojená aplikácia vykonať a ktorej výsledok má vrátiť. Pri úlohe pre agenta určite nástroju jasný účel a predtým, ako požiadate model o pokračovanie, uchovajte skutočný výsledok nástroja. Pri extrakcii údajov z dokumentu definujte polia, prijateľné hodnoty a spôsob uvádzania chýbajúcich informácií.
Táto edícia podporuje porozumenie videu pri práci agentov. Dodajte relevantný záznam a určite udalosť alebo vzťah, ktorý treba preskúmať. Praktické zadanie sa môže pýtať, ktorý viditeľný úkon vysvetľuje zmenu stavu, alebo žiadať opis udalostí v poradí s dôkazmi z klipu. Obrázky a strany PDF môžu podobne podporiť vizuálne porovnanie alebo porovnanie dokumentov. Výstup zostáva textový: interpretácia, extrahované údaje, kód alebo písomné vysvetlenie. Generované video, výtvarné diela alebo reč patria do samostatných profilov modelov.
Tabuľka API od Googlu pre konkrétnu verziu 3.7 uvádza 1 048 576 vstupných tokenov a 65 536 výstupných tokenov, zatiaľ čo karta modelu od Googlu opisuje kontext až do 1M a textový výstup 64K. Pri príprave vstupu zahrňte pokyny, predchádzajúce správy v konverzácii a dodané médiá. Pri profile od tvorcu modelu sú uvedené dávkové spracovanie a ukladanie do vyrovnávacej pamäte spolu s možnosťami Flex a Priority. Pri súbore nezávislých požiadaviek zachovajte identifikátory zdrojov a jednotný formát výsledkov, aby sa každá odpoveď dala overiť podľa vlastného vstupu.
Možné obmedzenia zahŕňajú halucinácie a občasnú pomalosť alebo vypršanie časového limitu. Časová hranica znalostí je marec 2026, pričom niektoré oblasti sú obmedzené na január 2025. Keď záver závisí od novších faktov, dodajte aktuálny zdrojový materiál. Užitočným rozlišovacím znakom tejto edície je jej zdokumentované zameranie na softvérové problémy, dodržiavanie dizajnového návrhu a uvažovanie nad videom; tieto výsledky posudzujte podľa skutočnej makety, kódu alebo médií namiesto toho, aby ste pomenovaný historický profil nahrádzali novšími funkciami.
Ailoot Ultra · Dávkové spracovanie POST /v1/batches google/gemini-3.7-flash:batch
google/gemini-3.7-flash:batchÚvod
Gemini 3.7 Flash spája multimodálne uvažovanie s programovaním a viackrokovou prácou agentov. Profil verzie 3.7 od Googlu kladie dôraz na vernosť dizajnovým maketám a porozumenie videu pri práci agentov, pričom ponúka úrovne uvažovania low, medium a high. Prijíma text a médiá, vracia text a má zdokumentované limity 1 048 576 vstupných a 65 536 výstupných tokenov.
- 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é |
|---|---|---|---|---|
Poleendpoint | Typstring | PožiadavkaPovinné | Hodnoty a limity /v1/chat/completions | Predvolené— |
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/gemini-3.7-flash:batch | Predvolené— |
Polerequests | Typbatch_item[] | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 | Predvolené— |
Polerequests[].custom_id | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polerequests[].body.messages | Typmessage[] | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polecompletion_window | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 24h | Predvolené— |
Poleprovider | Typobject|null | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polerequests[].body.model | Typstring | PožiadavkaVoliteľné | Hodnoty a limity google/gemini-3.7-flash:batch, google/gemini-3.7-flash | Predvolené— |
Poleprovider.only | Typstring[] | PožiadavkaVoliteľné | Hodnoty a limity google-vertex/global | Predvolené— |
Poleprovider.allow_fallbacks | Typboolean|null | PožiadavkaVoliteľné | Hodnoty a limity false, null | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciaendpoint, model, requests |
Parametermaterial_types | Špecifikáciatext |
Parameterrepresentation | Špecifikáciapriamo vložené requests[]; každá položka obsahuje custom_id a body |
Parameterrequest_endpoint_profile | Špecifikácia/v1/chat/completions |
Parameterfile_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. |
Parameterserialization_order | Špecifikáciaendpoint, model, provider (ak je zadaný), completion_window (ak je zadaný), requests na konci |
Parameteroptional_controls | Špecifikáciaprovider.only, provider.allow_fallbacks, completion_window |
Parameterschema_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.00075 / 1K tokenov Výstup · Výstupné tokeny $0.00375 / 1K tokenov Vstup · Čítanie cache $0.000075 / 1K tokenov Vstup · Zápis do cache $0.0000833333333333334 / 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)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.00075 / 1K tokenov Výstup · Výstupné tokeny $0.00375 / 1K tokenov Vstup · Čítanie cache $0.000075 / 1K tokenov Vstup · Zápis do cache $0.0000833333333333334 / 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
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.7-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.7-flash:batch', 'google/gemini-3.7-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.7-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.
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
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 |
|---|---|
Poleresults[].custom_id | Typstring |
Poleresults[].response.body.choices[].message.content | Typstring|null |
Poleresults[].error | Typobject|null |
Poleusage | Typobject|null |
Poleid | Typstring |
Polemodel | Typstring |
Poleendpoint | Typstring |
Polestatus | Typstring |
Polerequest_counts | Typobject |
Poleresults[].id | Typstring |
Poleresults[].response.status_code | Typinteger |
Poleresults[].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-3.7-flash:batch
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Google: Gemini 3.7 Flash (batch)
- Aké vstupy a výsledky sú dostupné?
POST /v1/batches·google/gemini-3.7-flash:batch:text→text- Aké polia používa požiadavka?
POST /v1/batches·google/gemini-3.7-flash:batch:endpoint,model,requests,completion_window,provider- Aké limity platia?
POST /v1/batches·google/gemini-3.7-flash:batch:requests.min_items:1