Google: Gemini 3 Flash Preview (batch)

Gemini 3 Flash Preview łączy rozumienie multimodalne i rozumowanie z wyjściem tekstowym. Obsługuje analizę kodu, dokumentów i materiałów wizualnych, wyniki strukturalne i przepływy pracy oparte na narzędziach, z czterema udokumentowanymi poziomami myślenia pozwalającymi wybrać głębokość analizy.

Ailoot Ultra · Batch POST /v1/batches google/gemini-3-flash-preview:batch

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

Gemini 3 Flash Preview to model rozumujący Google do rozumienia multimodalnego, programowania i zadań agentowych. Przyjmuje tekst, obrazy, wideo, audio i PDF, a zwraca tekst. Żądanie może więc łączyć pisemne instrukcje, pliki źródłowe, obserwacje wizualne i historię rozmowy wokół jednego problemu. Wynikiem może być wyjaśnienie, propozycja kodu, wyodrębnione dane lub plan oparty na tych materiałach, zamiast wygenerowanego obrazu lub odpowiedzi głosowej.

Dokładna karta modelu podaje limit wejścia 1,048,576 tokenów i limit wyjścia 65,536 tokenów. Planuj źródło i wynik osobno: długi fragment repozytorium, zbiór dokumentów lub nagranie mogą się zmieścić tylko wtedy, gdy ich przetworzona reprezentacja i instrukcje mieszczą się w budżecie wejścia, a odpowiedź nadal potrzebuje własnej przydzielonej długości. Oznacz powiązane źródła i wskaż wiążący materiał. Przy długim prompcie przewodnik deweloperski zaleca umieszczenie konkretnego pytania po danych i jawne powiązanie go z wcześniejszymi informacjami.

Myślenie jest dynamiczne, z high jako udokumentowanym ustawieniem domyślnym dla tego modelu. Obsługiwane poziomy to minimal, low, medium i high. Są to względne limity rozumowania, a nie gwarantowane liczby tokenów. Minimal nadal może obejmować pewne rozumowanie przy trudnym problemie programistycznym. Wybieraj poziom zgodnie z zadaniem: krótkie przekształcenie i problem debugowania z wieloma warunkami wymagają innego potraktowania. Stosuj bezpośrednie, jasne instrukcje zamiast wymuszać rozbudowane rytuały rozumowania w prompcie; poproś o rezultat końcowy i kontrole zapewniające jego użyteczność.

Karta producenta wymienia structured outputs, wywoływanie funkcji, wykonywanie kodu, obsługę komputera, wyszukiwanie plików, ugruntowanie przez wyszukiwanie, ugruntowanie Google Maps, kontekst URL i buforowanie. Wbudowane narzędzia można łączyć z niestandardowym wywoływaniem funkcji w udokumentowanym przepływie Gemini 3. Aplikacja definiuje funkcje, sprawdza argumenty, wykonuje zaakceptowane działania i odsyła ich wyniki. Dla asystenta kodu narzędzie odczytu pliku lub kontrolowanego uruchamiania testów może dostarczyć konkretnych dowodów dla następnego etapu. Proponowane działanie i zaobserwowany wynik narzędzia powinny pozostać rozdzielone w raporcie końcowym.

Dla programowania podaj odpowiednie pliki, język, oczekiwane zachowanie i wejście pokazujące problem. Ustal zakres zmiany i nazwij interfejs lub zachowanie, które musi zostać zachowane. Poproś o poprawioną implementację i przypadki do sprawdzenia. W analitycznym zadaniu dokumentowym zdefiniuj pytanie, wymagane pola i odwołania do źródeł. Jeśli używasz wyjścia strukturalnego, podaj schemat z jasnymi znaczeniami pól i regułami brakujących wartości. Zweryfikuj zarówno składnię, jak i to, czy każda wartość wynika z oryginalnego materiału.

W analizie multimodalnej wskaż, co ma znaczenie w każdym źródle. Zrzut ekranu może wspierać wyjaśnienie interfejsu, PDF dostarczać tabelę lub wykres, a nagranie zawierać zdarzenia mówione lub widoczne. Przewodnik deweloperski omawia ustawienia rozdzielczości mediów, ponieważ szczegółowość zmienia przetwarzaną reprezentację i zużycie tokenów. Przepływ wykonywania kodu producenta może kadrować lub przybliżać dostarczone obrazy, wykonywać obliczenia na danych wizualnych i dodawać adnotacje przed przygotowaniem odpowiedzi modelu. Czytelny drobny tekst może wymagać innego ustawienia niż szeroki opis sceny. Zachowuj odpowiednią stronę, obraz lub klip, aby można było sprawdzić obserwacje, zamiast traktować płynne podsumowanie jako dowód poprawnego odczytania każdego szczegółu.

Stan rozmowy i narzędzi należy zachowywać w wybranym interfejsie. Gemini 3 używa sygnatur myśli do przenoszenia kontekstu rozumowania między wywołaniami; przewodnik deweloperski odróżnia zarządzaną historię stanową od ręcznie zarządzanej historii bezstanowej. Zachowuj wymagany kontekst przy kontynuowaniu zadania narzędziowego lub poprawianiu wyniku. Google zaleca również zachowanie domyślnej temperature 1.0 zamiast przenoszenia receptury niskiej temperatury, która może powodować pętle lub pogorszone zachowanie w złożonych zadaniach. Są to praktyki integracyjne producenta, a nie nowe twierdzenia o transporcie konkretnej aplikacji.

Model tekstowy nie deklaruje generowania obrazów lub audio ani Live API. Przewodnik odróżnia także rozumienie wizualne od segmentacji obrazów na poziomie pikseli, która nie jest obsługiwaną możliwością Gemini 3 Flash. Dobieraj odpowiedni wynik końcowy do rzeczywistego zadania: obserwacje powiązane ze źródłami, rekord strukturalny, zmianę kodu lub decyzję z podanymi założeniami. Sprawdzaj rachunki, weryfikuj kod w zamierzonym środowisku i kontroluj zwrócone informacje narzędziowe. Gdy liczą się najnowsze fakty, używaj skonfigurowanych źródeł ugruntowania lub dostarczonych aktualnych danych zamiast zakładać, że wiedza modelu jest aktualizowaną na żywo bazą danych.

Ailoot Ultra · Batch POST /v1/batches google/gemini-3-flash-preview:batch

google/gemini-3-flash-preview:batch

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

Start

Akceptowane dane wejściowe: Tekst
Wyniki: Tekst

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Batch POST /v1/batches

Wejście: text
Wyjście: text
Format wyjściowy: JSON bezpośrednio w results[].response.body

Pole	Typ	Wymaganie	Wartości i limity	Domyślnie
Pole`endpoint`	Typ`string`	WymaganieWymagane	Wartości i limity /v1/chat/completions	Domyślnie—
Pole`model`	Typ`string`	WymaganieWymagane	Wartości i limity google/gemini-3-flash-preview:batch	Domyślnie—
Pole`requests`	Typ`batch_item[]`	WymaganieWymagane	Wartości i limity Minimalna liczba elementów: 1	Domyślnie—
Pole`requests[].custom_id`	Typ`string`	WymaganieWymagane	Wartości i limity	Domyślnie—
Pole`requests[].body.messages`	Typ`message[]`	WymaganieWymagane	Wartości i limity	Domyślnie—
Pole`completion_window`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 24h	Domyślnie—
Pole`provider`	Typ`object\|null`	WymaganieOpcjonalne	Wartości i limity	Domyślnie—
Pole`requests[].body.model`	Typ`string`	WymaganieOpcjonalne	Wartości i limity google/gemini-3-flash-preview:batch, google/gemini-3-flash-preview	Domyślnie—
Pole`provider.only`	Typ`string[]`	WymaganieOpcjonalne	Wartości i limity google-vertex/global	Domyślnie—
Pole`provider.allow_fallbacks`	Typ`boolean\|null`	WymaganieOpcjonalne	Wartości i limity false, null	Domyślnie—

Parametry i cykl życia metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktendpoint, model, requests
Parametr`material_types`	Kontrakttext
Parametr`representation`	Kontraktrequests[] bezpośrednio w żądaniu; każdy element zawiera custom_id i body
Parametr`request_endpoint_profile`	Kontrakt/v1/chat/completions
Parametr`file_material`	KontraktWywołujący może lokalnie wczytać rzeczywisty plik JSONL w kodowaniu UTF-8 do requests[]. Nie używa się przeznaczenia przesyłanego pliku, input_file_id ani odwołania do pliku. Brak materiałów klienta lub ich pusta zawartość zatrzymują przygotowanie przed POST.
Parametr`serialization_order`	Kontraktendpoint, model, provider (jeśli podano), completion_window (jeśli podano), requests na końcu
Parametr`optional_controls`	Kontraktprovider.only, provider.allow_fallbacks, completion_window
Parametr`schema_scope`	KontraktTreści żądań tekstowych Chat Completions w udokumentowanej strukturze Batch z danymi bezpośrednio w żądaniu.

Cykl życia: asynchronous

GET /v1/batches/{operation_id} · Rzeczywista wartość response.id zwrócona przy pierwotnym utworzeniu; ten sam użytkownik, klucz i grupa

Cennik

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki: Nie określono Gdy wybrany jest tryb szybki
Tryb flex: Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania: Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Wycena jawnej pamięci podręcznej: Niewłączone Gdy zażądano jawnej pamięci podręcznej

Stawki Ailoot

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

Konfiguracja	Tabela stawek	Tokeny kontekstu, więcej niż	Tokeny kontekstu, do podanej wartości włącznie	Opłata
KonfiguracjaPodstawowe stawki za tokeny	Tabela stawekStawka podstawowa	Tokeny kontekstu, więcej niż—	Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy	Opłata Wejście · Tokeny wejściowe $0.0005 / 1K tokenów Wyjście · Tokeny wyjściowe $0.003 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów
KonfiguracjaPrzedział długości żądania 1	Tabela stawek—	Tokeny kontekstu, więcej niż0	Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy	Opłata Wejście · Tokeny wejściowe $0.0005 / 1K tokenów Wyjście · Tokeny wyjściowe $0.003 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Batch

curl · zachowany zestaw danych testowychPython HTTP · rzeczywisty JSONL klientaPython · zapisz każdy ukończony wynik

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.

Odbieranie i zapisywanie wyników

Ailoot Ultra · Batch

JSON bezpośrednio w results[].response.body

GET /v1/batches/{operation_id}

Sprawdź status zadania

curl · status pierwotnej operacji

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

Zachowaj wszystkie ukończone wyniki

Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.

Zachowaj pełny pierwotny JSON stanu, każdy wynik i custom_id oraz pełną treść odpowiedzi lub błędu. Zapisz ukończone wyniki z results[] jako JSONL bez filtrowania.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj pierwotny identyfikator operacji. Odpowiedź 503 result_pending_check zawiera X-Should-Retry:false; nigdy nie wysyłaj ponownie pierwotnego żądania Batch, którego wynik jest nieznany.

Pola odpowiedzi

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

Błędy i dalsze kroki

Odpowiedź	Warunek	Następny krok
Odpowiedź400 · `invalid_request_error`	WarunekNieprawidłowa udokumentowana struktura z danymi bezpośrednio w żądaniu, zduplikowane klucze, problem z tożsamością elementu lub konflikt ze skonfigurowanymi możliwościami modelu.	Następny krokPopraw wskazane pola przed wysłaniem jakiegokolwiek nowego żądania.
Odpowiedź401 · `authentication_error`	WarunekNieprawidłowy klucz API.	Następny krokUżyj autoryzowanego klucza Ailoot.
Odpowiedź403 · `permission_error`	WarunekGrupa Batch jest niedostępna.	Następny krokSprawdź uprawnienia klucza i grupy.
Odpowiedź422 · `invalid_request_error`	WarunekBatch korzysta z rozliczania z salda; utworzenie w ramach subskrypcji jest odrzucane.	Następny krokUżyj autoryzowanej grupy rozliczanej z salda.
Odpowiedź422 · `price_unavailable`	WarunekNie można wycenić danych wejściowych Batch.	Następny krokZachowaj odpowiedź; użyj danych wejściowych udokumentowanych dla tej rodziny API.
Odpowiedź402 · `billing_error`	WarunekRezerwa dla Batch jest niedostępna.	Następny krokRozwiąż problem dopuszczenia żądania przed wysłaniem nowego.
Odpowiedź503 · `price_unavailable`	WarunekCena metody Batch lub stawki natywne są niedostępne.	Następny krokZachowaj odpowiedź; nie zastępuj cen innymi.
Odpowiedź503 · `api_error`	WarunekDokładna trasa dostawcy jest niedostępna.	Następny krokZachowaj odpowiedź na potrzeby naprawy trasy.
Odpowiedź503 · `result_pending_check`	WarunekPierwotny wynik wymaga sprawdzenia; X-Should-Retry:false.	Następny krokZachowaj pierwotny operation_id/id i odczytuj stan operacji; nigdy nie powtarzaj pierwotnego POST.
Odpowiedź404 · `not_found`	WarunekOperacja sprawdzania stanu Batch nie istnieje lub należy do innej tożsamości.	Następny krokUżyj dokładnego pierwotnego id oraz tego samego użytkownika, klucza i grupy.

Aliasy

Aliasy modelu

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

Aliasy ścieżek metod

Użyj ścieżek metod podanych powyżej.

Powiązane ID modeli

google/gemini-3-flash-preview:batch

FAQ · Google: Gemini 3 Flash Preview (batch)

Jakie dane wejściowe i wyniki są dostępne?: POST /v1/batches · google/gemini-3-flash-preview:batch: text → text
Jakich pól używa żądanie?: POST /v1/batches · google/gemini-3-flash-preview:batch: endpoint, model, requests, completion_window, provider
Jakie limity obowiązują?: POST /v1/batches · google/gemini-3-flash-preview:batch: requests.min_items: 1

Google: Gemini 3 Flash Preview (batch)