Claude Opus 5.5 jest już dostępny w SeedRouter

Text

Gemini 4 Neon

View Markdown

Natywne żądania Gemini, cztery poziomy rozumowania, długie dekodowanie z tokenami kontynuacji, narzędzia, wejście multimodalne i strumieniowanie. Zawiera limity modelu i status weryfikacji.

Używaj gemini-4-neon w natywnym formacie Gemini. Strona modelu zawiera Playground i aktualne ceny. Gemini 4 Neon plasuje się między Gemini 4 Hydrogen a Gemini 4 Carbon i używa tego samego natywnego formatu żądań generateContent; według przewodnika migracji Google przejście między modelami Gemini 4 nie wymaga zmian w schemacie żądania.

ID modelu

ID modeluOkno kontekstuDomyślny poziom wysiłku
gemini-4-neon1 048 576 tokenów, wspólnych dla wejścia, rozumowania i wyjściahigh

Używaj gemini-4-neon dla poziomu Default albo wybierz jawny poziom gemini-4-neon:GROUP_NAME zwrócony przez wykrywanie modeli. Sprawdź dostępne poziomy przed wysłaniem żądań.

Szybki przykład

curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

Model umieszcza się w URL. contents jest wymagane. Odpowiedź zawiera natywne candidates, finishReason i usageMetadata; zachowuj pełne części treści, w tym thoughtSignature, w historii rozmowy. Trudne prompty mogą być przetwarzane przez kilka minut. Google zaleca 20-minutowy limit czasu klienta. Używaj strumieniowania, aby otrzymywać wyjście w miarę jego powstawania.

Endpointy

OperacjaEndpoint
Odpowiedź JSONPOST /v1beta/models/gemini-4-neon:generateContent
Zdarzenia wysyłane przez serwerPOST /v1beta/models/gemini-4-neon:streamGenerateContent?alt=sse

Specyfikacja OpenAPI zawiera każdy zagnieżdżony schemat żądania i odpowiedzi. Pominięte pola opcjonalne używają domyślnych wartości API. Publiczne natywne API zachowuje przesłaną treść do walidacji przez Gemini. Playground sprawdza też udokumentowane ograniczenia przed wysłaniem i egzekwuje swoje ustawienia bezpieczeństwa.

Parametry żądania

URL ustala model na gemini-4-neon. Kontrakt żądania zawiera 11 pól najwyższego poziomu. Pola są opcjonalne, chyba że oznaczono je jako wymagane; pominięcie różni się od JSON null. Dowolny JSON dopuszczający null jest zachowywany tam, gdzie pozwala na to oficjalny schemat.

PoleTypWymaganeWartość domyślna i ograniczenia
contentsobject[]TakNiepusta rozmowa; każda treść ma niepuste parts
systemInstructionobjectNieCzęści wyłącznie tekstowe; tożsamość użytkownika nie jest wstawiana automatycznie
generationConfigobjectNieParametry generowania w następnej tabeli
toolsobject[]NieDeklaracje funkcji i konfiguracje wbudowanych narzędzi
toolConfigobjectNieKonfiguracja wyboru funkcji i pobierania informacji
safetySettingsobject[]NieJedno ustawienie na kategorię; bez powtarzających się kategorii
serviceTierstringNieunspecified, standard, flex, priority; zwykłe przetwarzanie to standard
continuationTokenstringNieToken zwrócony z finishReason: CONTINUATION lub MAX_TOKENS; wyślij ponownie to samo żądanie z tym tokenem, aby kontynuować długą odpowiedź
labelsobjectNieWartości tekstowe; klucze/wartości małymi literami, każde maksymalnie 63 punkty kodowe Unicode
modelstringNieOpcjonalna nazwa zasobu; URL określa rzeczywisty model
storebooleanNieOgólna preferencja przechowywania żądania; efekt w tym modelu niezweryfikowany

Jawne buforowanie kontekstu (zasoby cachedContent i cachedContents) nie jest obsługiwane w Gemini 4 Neon. Niejawne buforowanie jest domyślnie włączone dla promptów mających co najmniej 4096 tokenów.

Parametry generowania

Pole w generationConfigTypWartość domyślna i ograniczenia
maxOutputTokensintegerDomyślnie 65 536, wliczając rozumowanie. Do 1 048 576 pomniejszonych o wejście przy kontynuacji. Każda odpowiedź strumieniowa lub niestrumieniowa obsługuje do 65 536 tokenów; użyj kontynuacji dla dłuższego wyjścia
thinkingConfigobjectthinkingLevel: low, medium, high, xhigh (domyślnie high); akceptowane są zapisy wielkimi literami. includeThoughts: boolean, domyślnie false. Używaj thinkingLevel; przestarzały thinkingBudget jest mapowany na poziom z ostrzeżeniem, gdy podano go osobno, i nie może być łączony z thinkingLevel
stopSequencesstring[]Maksymalnie pięć sekwencji
responseMimeTypestringDomyślnie text/plain; wyjście według starszego schematu JSON wymaga application/json
responseSchemaobjectOficjalny dialekt schematu; wzajemnie wyklucza się z responseJsonSchema
responseJsonSchemaJSONJSON Schema; wzajemnie wyklucza się z responseSchema
responseFormatobjectKonfiguracja formatu tekstu; text.mimeType i opcjonalne text.schema. Schemat wymaga typu MIME JSON
responseModalitiesstring[]Tylko tekst: TEXT; puste oznacza tekst
mediaResolutionenumMEDIA_RESOLUTION_UNSPECIFIED, LOW, MEDIUM, HIGH z prefiksem MEDIA_RESOLUTION_
seedintegerWartość 32-bitowa ze znakiem; deterministyczne zachowanie w tym modelu niezweryfikowane
presencePenaltynumberPole ogólne; efekt/zakres w tym modelu niezweryfikowany
frequencyPenaltynumberPole ogólne; efekt/zakres w tym modelu niezweryfikowany
responseLogprobsbooleanPole ogólne; dostępność w tym modelu niezweryfikowana
logprobsinteger0–20; wymaga responseLogprobs: true; obsługa w modelu niezweryfikowana
enableEnhancedCivicAnswersbooleanPole ogólne; obsługa w modelu niezweryfikowana
enableAffectiveDialogbooleanPole ogólne; obsługa w modelu niezweryfikowana
audioTranscriptionConfigobjectPole ogólne; opcje w tym modelu niezweryfikowane
translationConfigobjectPole ogólne; opcje w tym modelu niezweryfikowane

Dokument OpenAPI wymienia zagnieżdżone typy, wartości enum, wymagane właściwości i udokumentowane granice każdego komunikatu, w tym audioMetadata, documentMetadata, spreadsheetMetadata i videoMetadata.contentLayers ze specyfikacji odkrywania v1beta. Schematy opisują oficjalne parametry; nie stanowią listy dozwolonych żądań SeedRouter. Pola i wartości dostarczone przez wywołującego są zachowywane. Akceptowanie pola przez schemat nie dowodzi jego obsługi na każdym koncie. minimal nie jest wymienionym poziomem rozumowania. Google podaje, że temperature, topP, topK i candidateCount są przestarzałe i należy je usunąć; niestandardowe wartości próbkowania mieszczące się w zakresie są ignorowane, a wartości spoza zakresu zwracają 400. Przesłane w natywnym JSON nadal przechodzą bez zmian do obsługi przez Gemini API.

Długie dekodowanie

Jedna odpowiedź Gemini 4 Neon zwraca do 65 536 tokenów przy strumieniowaniu i do 65 536 tokenów bez strumieniowania. Aby uzyskać więcej, ustaw maxOutputTokens powyżej 65 536 i samodzielnie kontynuuj odpowiedź:

  1. Wyślij żądanie. Jeśli odpowiedź kończy się finishReason: "CONTINUATION", odczytaj candidates[0].continuationToken.
  2. Wyślij ponownie to samo żądanie z tą wartością w polu najwyższego poziomu continuationToken. Nie dopisuj częściowego wyjścia do contents; token przenosi stan modelu, w tym jego rozumowanie.
  3. Powtarzaj, aż finishReason będzie równe STOP lub MAX_TOKENS. Jeśli wywołanie osiągnie MAX_TOKENS i zwróci continuationToken, możesz wznowić je wyłącznie przez zwiększenie maxOutputTokens; powtórzenie tego samego limitu zwraca 400 INVALID_ARGUMENT.
{
  "contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

Runda żądania poświęcona w całości rozumowaniu może zwrócić pusty tekst z CONTINUATION; to normalny postęp. Każda runda ponownie wysyła do modelu Twój prompt i wszystko wygenerowane do tej pory, więc tokeny wejścia są liczone ponownie w każdej późniejszej rundzie (przy czym powtarzające się prefiksy kwalifikują się do niejawnego buforowania). SeedRouter rozlicza każdą rundę jako osobne żądanie. Tryb background po stronie serwera w Interactions API nie jest częścią tego endpointu.

Ustrukturyzowane wyjście

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 65536,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Starszych pól responseSchema i responseJsonSchema nie można używać razem. Oba wymagają responseMimeType: "application/json". Nowszy schemat responseFormat.text również musi wskazywać JSON. W tym komunikacie używaj zapisów enum REST (APPLICATION_JSON i TEXT_PLAIN). Żądania przechodzą bez zmian; typy MIME multimediów i dowolny JSON funkcji nie są przepisywane.

Funkcje i wbudowane narzędzia

Używaj tools[].functionDeclarations z nazwą oraz albo parameters, albo parametersJsonSchema, nie oboma naraz. Wybór funkcji znajduje się w toolConfig.functionCallingConfig; allowedFunctionNames wymaga ANY lub VALIDATED oraz zadeklarowanych nazw. Nie proś modelu przez instrukcje systemowe o generowanie wywołań narzędzi w formacie surowego tekstu JSON bez zadeklarowanych narzędzi, ponieważ może to zwrócić MALFORMED_FUNCTION_CALL.

Twoja aplikacja wykonuje zwrócone funkcje i dostarcza ich wyniki w następnej turze rozmowy. Zachowuj każdy oryginalny thoughtSignature, wywołanie funkcji i odpowiedź funkcji. Nie kopiuj podpisu rozumowania między równoległymi częściami functionCall i nie zaokrąglaj identyfikatorów liczbowych podczas serializacji nieprzezroczystych argumentów funkcji.

Google wymienia Search, Maps, wykonywanie kodu, kontekst URL, File Search i Computer Use dla Gemini 4 Neon. Zasoby File Search wymagają dostępu przy użyciu poświadczeń obsługujących żądanie. Natywna konfiguracja MCP pojawia się w ogólnym schemacie, ale jej dostępność w tym modelu nie została ustalona. Sprawdź oficjalne ograniczenia każdego narzędzia przed połączeniem go z multimediami. Przy ugruntowaniu odpowiedzi Google liczy wewnętrzne instrukcje narzędzi i deklaracje funkcji jako tokeny wejścia. Playground nie wykonuje Twoich niestandardowych funkcji.

Wejście multimodalne i bezpieczeństwo

Element contents[].parts[] zawiera dokładnie jeden ładunek: tekst, multimedia osadzone bezpośrednio, odwołanie do pliku, wywołanie/odpowiedź funkcji lub część wykonania. Może też zawierać podpis lub metadane multimediów (videoMetadata, audioMetadata, documentMetadata, spreadsheetMetadata, mediaResolution, mediaProcessing). Wejście obsługuje tekst, obrazy, dźwięk, wideo i pliki PDF; wyjście jest wyłącznie tekstowe. Model nie generuje obrazów ani dźwięku i nie ma Live API.

Dla bajtów osadzonych bezpośrednio używaj inlineData.mimeType i data w base64. Dla odwołań do plików używaj fileData.mimeType i fileUri. Poprawny składniowo URL nie dowodzi, że model może pobrać zasób. Metadane wideo mogą określać startOffset, endOffset, dodatnią wartość fps nie większą niż 24 oraz contentLayers. Agentowe rozumienie wideo wybiera się dla każdej części przez mediaProcessing: "AGENTIC" obok fileData lub inlineData wideo; domyślne jest przetwarzanie statyczne.

Ustawienia bezpieczeństwa używają oficjalnego natywnego formatu i przechodzą przez API bez zmian. W Playground wszystkie cztery kategorie muszą być ustawione na BLOCK_MEDIUM_AND_ABOVE lub bardziej restrykcyjnie; niższe progi są dostępne wyłącznie przez API.

Odpowiedzi JSON i strumieniowanie

generateContent zwraca natywny JSON. streamGenerateContent?alt=sse emituje natywny JSON w zdarzeniach SSE data:. Ważne pola to candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId i usageMetadata.

Zachowuj pełną natywną treść w historii rozmowy. Podsumowania rozumowania nie są tym samym co podpisy rozumowania. Rozłączenie nie dowodzi, że generowanie nie powiodło się lub zostało ukończone; sprawdź częściowy wynik i zapis na koncie przed wysłaniem kolejnego żądania. Zużycie w strumieniu jest narastające, więc używaj najnowszych liczników zamiast sumować każdy fragment.

Zużycie i ceny

promptTokenCount obejmuje wejście z pamięci podręcznej. cachedContentTokenCount jest rozliczane według stawki za wejście z pamięci podręcznej, zamiast być ponownie rozliczane jako wejście niebuforowane. Płatne wyjście obejmuje candidatesTokenCount oraz thoughtsTokenCount. Gemini 4 Neon domyślnie używa poziomu rozumowania high. Ustawiaj poziom jawnie, porównując jego zużycie z innym modelem.

Ten model nie ma progu cenowego zależnego od długości kontekstu. Aktualne ceny SeedRouter używają stawek za tokeny Standard; zniżki Flex i dopłaty Priority nie zostały skonfigurowane dla tej integracji. Obsługa tych poziomów przetwarzania nadal wymaga weryfikacji. Ugruntowanie przez Google Search może dodawać opłaty za zapytania poza zużyciem tokenów; sprawdź ceny narzędzi przed włączeniem tej funkcji. Nieudane żądania nie są płatne. Zobacz aktualny cennik.

Grupy konta

Poziom Default używa identyfikatora modelu gemini-4-neon bez sufiksu. Dodatkowe poziomy używają gemini-4-neon:GROUP_NAME w URL. Playground wybiera dostępny poziom; API akceptuje też jawny nagłówek:

X-SeedRouter-Group: GROUP_NAME

Wybrana grupa określa cenę i dostępną przepustowość; jawny wybór nie powoduje cichego przełączenia do innej grupy. Pomiń nagłówek lub użyj auto, aby zachować domyślne zachowanie klucza API.

Sprawdź grupy dostępne dla Twojego klucza API bez generowania odpowiedzi:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-neon" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

Status weryfikacji

Oficjalną dokumentację i wersję odkrywania REST 20261119 sprawdzono 20 listopada 2026 r. Tego dnia wykrywanie modeli tylko do odczytu (GET /v1/models), wykrywanie grup (GET /api/seedrouter/llm/groups?model=gemini-4-neon) i publiczny cennik (GET /v1/pricing) potwierdziły zarówno poziom Default gemini-4-neon, jak i jawny poziom gemini-4-neon:googlellm-vertext. Trzy płatne wywołania testowe o pojedynczej próbie przez api.seedrouter.ai również zakończyły się kodem HTTP 200: generowanie JSON z poziomem rozumowania low w Default (54 tokeny promptu, 28 wyjścia, 39 tokenów rozumowania), strumieniowanie SSE z poziomem rozumowania xhigh w Default (50 tokenów promptu, 13 wyjścia, 207 tokenów rozumowania) oraz zadeklarowane functionCall z poziomem rozumowania low na gemini-4-neon:googlellm-vertext (95 tokenów promptu, 22 wyjścia, 49 tokenów rozumowania, ze zwróconym thoughtSignature). Przepuszczanie natywnego ciała żądania i lista dozwolonych pól odpowiedzi wymagają wdrożenia zaktualizowanej kompilacji backendu. Rozumienie multimediów, ugruntowanie w źródłach, Computer Use, kontynuacja/długie dekodowanie, pozostałe pola ogólne i poziomy przetwarzania pozostają niezweryfikowane, a te kontrole nie ustalają porównawczej jakości ani opóźnień.

Źródła