Google: Gemini 3.1 Pro Preview (batch)

Gemini 3.1 Pro Preview to multimodalny model rozumujący Google do złożonych zadań programistycznych, algorytmicznych i pracy z wiedzą. Przyjmuje tekst, obrazy, dźwięk, wideo i PDF, a zwraca tekst lub kod, z narzędziami i uporządkowanym wyjściem. Nakład określają poziomy low, medium i high; udokumentowany domyślny poziom to high.

Ailoot Ultra · Batch POST /v1/batches google/gemini-3.1-pro-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.1 Pro Preview to model tekstowy Google nastawiony na rozumowanie do złożonych zadań wymagających inżynierii oprogramowania, opracowania algorytmów lub syntezy dowodów multimodalnych. Rozwija Gemini 3 Pro, kładąc nacisk na precyzyjne użycie narzędzi, efektywniejsze rozumowanie i niezawodne wykonanie wieloetapowe. Tekst, obrazy, audio, wideo i PDF mogą składać się na pisemną odpowiedź, rezultat w postaci kodu lub wynik strukturalny.

W wymagającym zleceniu programistycznym podaj cel, odpowiednie materiały z repozytorium, zaobserwowane zachowanie i ograniczenia do zachowania. Całe repozytoria kodu mogą dostarczać kontekstu dla zadania. Przy przeglądzie kontraktu kodu poproś model o porównanie obsługi wspólnego kontraktu danych przez dwa moduły, wskazanie niezgodności i zaproponowanie konkretnej poprawki z potwierdzającymi odwołaniami do kodu. Przydatne wyjście odróżnia analizę, proponowaną zmianę i dowody od wszelkiej walidacji wykonanej przez połączoną aplikację.

Materiały premierowe pokazują oparte na kodzie wyjaśnienia wizualne i projekty interaktywne, w tym animowane wyjście SVG na podstawie opisu tekstowego. Są to artefakty kodowe, a nie generowanie obrazów rastrowych. Jasny opis może określać, co ma zostać wyjaśnione, jak wizualizacja powinna się zachowywać i jakie dane reprezentować. Sprawdź uzyskany kod i renderowanie względem tych wymagań. W zadaniu syntezy danych podaj rzeczywiste źródła i poproś o jeden widok zachowujący zawarte w nich relacje i zastrzeżenia.

Udokumentowane poziomy myślenia to low, medium i high, z domyślnym high dla 3.1 Pro Preview. Myślenia nie można całkowicie wyłączyć w tym profilu Pro. Wybierz niższy wysiłek dla odpowiedzi o ograniczonym zakresie i więcej rozumowania dla trudnej pracy wieloetapowej, pozostawiając wystarczający limit wyjścia na rezultat końcowy. Mały limit wyjścia może przerwać rozumowanie, zanim pojawi się użyteczna odpowiedź końcowa. Przewodnik myślenia oddziela podsumowanie rozumowania od pełnego procesu wewnętrznego i wyjaśnia znaczenie kontekstu sygnatur myśli rozmowy.

Dokładna tabela Preview wymienia wywoływanie funkcji, wykonywanie kodu, ugruntowanie przez wyszukiwanie, ugruntowanie Maps, kontekst URL i structured outputs. Ogranicza File Search do AI Studio. Podaj cele funkcji i definicje parametrów, a następnie kontynuuj na podstawie rzeczywiście zwróconego wyniku. Osobny profil Custom Tools Preview jest zoptymalizowany pod kątem pierwszeństwa niestandardowych narzędzi i bash; jest to odrębny nazwany endpoint producenta, więc tej specjalizacji nie należy milcząco traktować jako właściwości każdego żądania 3.1 Pro. Wybierz schemat wyniku strukturalnego, gdy zadanie wymaga zdefiniowanych rekordów zamiast nieograniczonego tekstu.

W analizie multimodalnej wskaż odpowiednią stronę, materiał wizualny, przedział nagrania lub zdarzenie wideo. Przy analizie dokumentu porównaj diagram z jego pisemną specyfikacją i zwróć każdą rozbieżność z potwierdzającym fragmentem. Źródło mówione może dostarczyć transkryptu lub interpretacji tekstowej. Zachowuj odwołania do źródeł dla wniosków wymagających sprawdzenia i oddzielaj to, co widoczne lub stwierdzone, od tego, co wywnioskowane. Wyjście tego profilu pozostaje tekstem, w tym kodem; natywne generowanie obrazów lub mowy nie jest częścią dokładnej tabeli jego możliwości.

Natywna karta 3.1 Pro określa kontekst do 1M i wyjście tekstowe 64K, a dokładna tabela Preview API podaje 1,048,576 tokenów wejściowych i 65,536 tokenów wyjściowych. Uwzględnij instrukcje, historię rozmowy i media w budżecie wejścia. Udokumentowano buforowanie i przetwarzanie wsadowe, a opcje Flex i Priority także wymieniono dla profilu producenta. Przy kilku niezależnych pozycjach zdefiniuj wymagane wyjście i zachowaj identyfikator każdego źródła, zamiast łączyć niezwiązane dowody w jedną odpowiedź bez możliwości ich prześledzenia.

Nazwana edycja Preview pozostaje odrębna od profilu Custom Tools Pro oraz późniejszych wydań Flash lub Pro. Jej mocne strony dotyczą złożonego rozumowania, programowania i syntezy dowodów; rezultat końcowy nadal wymaga sprawdzenia względem źródła i rzeczywistych wyników narzędzi. Zachowuj nierozstrzygniętą niejednoznaczność, gdy dostarczone informacje nie wspierają jednoznacznego wniosku. Przydatny rezultat to poparta odpowiedź, kod lub rekord wymagany w zadaniu, z wystarczającymi dowodami do oceny jego praktycznych ograniczeń.

Ailoot Ultra · Batch POST /v1/batches google/gemini-3.1-pro-preview:batch

google/gemini-3.1-pro-preview:batch

Google /google/gemini-3.1-pro-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.1-pro-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.1-pro-preview:batch, google/gemini-3.1-pro-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.002 / 1K tokenów Wyjście · Tokeny wyjściowe $0.012 / 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łącznie200 000	Opłata Wejście · Tokeny wejściowe $0.002 / 1K tokenów Wyjście · Tokeny wyjściowe $0.012 / 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 2	Tabela stawek—	Tokeny kontekstu, więcej niż200 000	Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy	Opłata Wejście · Tokeny wejściowe $0.004 / 1K tokenów Wyjście · Tokeny wyjściowe $0.018 / 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.1-pro-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.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-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.1-pro-preview:batch

Aliasy ścieżek metod

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

Powiązane ID modeli

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)

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

Google: Gemini 3.1 Pro Preview (batch)