Wprowadzenie
Czat zgodny z OpenAI dla Gemini 3.1 Pro Preview. Okno odczytu 1 000 000 tokenów, trzy poziomy nakładu rozumowania, 128 schematów narzędzi i wyjście JSON w jednym synchronicznym wywołaniu.
Gemini 3.1 Pro Preview to model czatu Google o długim kontekście, opublikowany jako pojedynczy endpoint zgodny z OpenAI. Czyta do 1 000 000 tokenów i odpowiada w maksymalnie 32 768 – mniej więcej trzydzieści do jednego, więc wchodzi cała biblia świata i pełna historia, a wraca jedna spójna tura.
Najważniejsze funkcje
Czyta półkę, pisze akapit
1 000 000 tokenów na wejściu i 32 768 na wyjściu to mniej więcej trzydzieści do jednego, a ten stosunek jest instrukcją obsługi. Dołącz biblię świata, karty postaci i każdy napisany dotąd rozdział, a potem poproś o jedną odpowiedź, która popchnie scenę do przodu. To, co wraca, jest krótkie z założenia i spójne z każdą przesłaną stroną.
Historia jedzie w komplecie, bez kompresji
Długi roleplay dryfuje głównie dlatego, że historię trzeba streścić, żeby się zmieściła. Okno 1 000 000 tokenów zwykle usuwa ten krok: wysyłaj w każdej turze oryginalny tekst, a szczegół zasiany trzydzieści rozdziałów temu wciąż stoi przed modelem, zamiast tkwić pogrzebany we własnej parafrazie.
Może się zmienić bez zapowiedzi
Cykl życia modelu w wersji preview należy do Google. Zachowanie, dostępność i cena mogą się przesunąć, a sam model może zostać wycofany. Zanim poprowadzi produkcyjny wątek, zdecyduj, na jaki model ten wątek ma spaść.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
messages | Tak | Uporządkowane tury rozmowy. Treść to ciąg znaków albo tablica części text i |
max_tokens | Nie | Ogranicza odpowiedź do 32 768, czyli jednej trzydziestej okna odczytu. Domyślnie 16 384. |
reasoning_effort | Nie | minimal, low, medium albo high. Domyślne jest medium: zejdź do low przy rutynowych turach, podnieś do high, gdy model musi zważyć historię albo wytropić sprzeczności. |
stop | Nie | Do 4 sekwencji, jako string albo tablica. Odpowiedź kończy się, gdy tylko model zapisze którąś z nich, a dopasowany tekst nie jest zwracany. od 1 znaków · od 1 elementów · do 4 elementów |
seed | Nie | Dowolna liczba całkowita. |
temperature | Nie | Od 0 do 2, domyślnie 1. Google zaleca zostawienie modeli Gemini 3 na 1,0: poniżej tej wartości generowanie potrafi wpaść w pętlę albo stracić jakość. |
top_p | Nie | Od 0,01 do 1. Zmieniaj albo to pole, albo temperature – nigdy obu w tym samym porównaniu. |
tools | Nie | Do 128 definicji funkcji na żądanie. do 128 elementów |
tool_choice | Nie | auto, none, required albo obiekt wskazujący jedną funkcję. |
response_format | Nie | Poproś o obiekt JSON i wymień każdy klucz w wiadomości systemowej. |
Cennik
Wejście $1.90 / Wyjście $11.40 za 1 mln tokenów; Prompty powyżej 200K tokenów: Wejście $3.80 / Wyjście $17.10
Powyżej 200 000 tokenów wejściowych całe żądanie jest rozliczane według stawki dla długiego kontekstu.
Zastosowania
Kontynuuj scenę w kontekście 300 000 słów
Wyślij biblię świata, mapę relacji i każdy napisany dotąd rozdział, a potem poproś o jedną turę. Nic nie było wyszukiwane ani próbkowane, więc obietnica złożona w pierwszym akcie wciąż jest widoczna, gdy model pisze trzeci.
Audyt ciągłości między rozdziałami
Umieść zasady świata i gotowe rozdziały w jednym żądaniu i zapytaj, które fragmenty im przeczą. Wraca lista sprzeczności z cytatami, a nie przepisany tekst – długi odczyt z krótką odpowiedzią, czyli dokładnie boisko domowe tego stosunku.
Jeden osąd na bardzo dużym zbiorze dokumentów
Wrzuć do jednego wywołania cały zestaw specyfikacji, kwartał zgłoszeń albo całą skrzynkę pocztową i zapytaj, co faktycznie się zmieniło. Odpowiedź o długości 32 768 tokenów w zupełności wystarcza na wniosek i stojące za nim cytaty.
Stan postaci w JSON dla twojej aplikacji
Poproś o obecną pozycję, obrażenia, relacje i znane sekrety każdej postaci jako obiekt JSON: response_format ustawiony na json_object, z każdym kluczem wymienionym w wiadomości systemowej. Twój plik zapisu pozostaje zsynchronizowany z prozą, bez ratunkowego parsera.
Wskazówki
Zasady w wiadomości systemowej, opowieść w wiadomości użytkownika
Zasady świata, żądany ton i długość tej tury umieść w wiadomości systemowej. Biblię świata, mapę relacji i historię wrzuć do jednej wiadomości użytkownika, od najstarszej części, a na końcu dopisz polecenie na tę turę.
Wysyłaj całą historię ponownie, nie streszczaj jej
Okno mieści 1 000 000 tokenów, zwykle więcej niż skończona powieść. Ponowne wysyłanie oryginalnego tekstu w każdej turze kosztuje tokeny wejściowe, ale to najtańsza ciągłość, jaką da się kupić: nic nie ginie w parafrazie.
Limity, które trzeba uwzględnić
Limit odpowiedzi to 32 768 tokenów – mniej więcej jedna trzydziesta okna odczytu – więc żądanie o cały rozdział dobija do limitu, zanim skończy, a max_tokens powyżej tej wartości nie przejdzie walidacji. Treść wiadomości to tekst i obrazy; części wideo i audio są odrzucane. To model w wersji preview: Google może zmienić jego zachowanie albo go wycofać, więc zdecyduj, co go zastąpi, zanim poprowadzi produkcyjny ruch. response_format w postaci JSON nadaje odpowiedzi kształt, ale parsowanie i walidacja zostają po stronie twojej aplikacji.
Szybki start z API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-3.1-pro-preview/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
