Gemini 3.8 Flash

Używaj gemini-3.8-flash w natywnym formacie Gemini. Strona modelu zawiera Playground i aktualne ceny; przewodnik porównujący modele porównuje udokumentowane ustawienia z Gemini 3.1 Pro.

ID modelu

Krótki przykład

curl https://api.seedrouter.ai/v1beta/models/gemini-3.8-flash:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":1024}}'

Model należy podać w URL. contents jest wymagane. Odpowiedź zawiera natywne candidates, finishReason i usageMetadata; zachowuj kompletne części treści, w tym thoughtSignature, w historii rozmowy.

Punkty końcowe

Specyfikacja OpenAPI zawiera wszystkie zagnieżdżone schematy żądań i odpowiedzi. Pominięte pola opcjonalne korzystają z wartości domyślnych API. SeedRouter przekazuje wysłaną treść bez filtrowania nieznanych pól, usuwania nieobsługiwanych pól ani weryfikacji wartości parametrów modelu. O przyjęciu żądania decyduje Gemini API.

Parametry żądania

URL ustala model na gemini-3.8-flash. Kontrakt żądania zawiera 12 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 wartości null zostaje zachowany tam, gdzie pozwala na to oficjalny schemat.

Parametry generowania

Dokument OpenAPI opisuje zagnieżdżone typy, wartości enum, wymagane właściwości i udokumentowane granice każdej wiadomości. Schematy opisują oficjalne parametry; nie stanowią listy pól dozwolonych w żądaniach SeedRouter. Pola i wartości podane przez wywołującego są zachowywane. Przyjęcie pola przez schemat nie dowodzi jego obsługi przez każdy model lub konto. Rozumowanie minimal nie jest obsługiwane. Temperatura, topP, topK i candidateCount nie są oficjalnymi ustawieniami tego modelu. Jeśli zostaną wysłane w natywnym JSON, nadal przechodzą bez zmian do obsługi przez Gemini API. Kończ rozmowę treścią użytkownika; oficjalne API nie obsługuje ostatniej tury ze wstępnie wypełnioną odpowiedzią modelu. Tury użytkownika zawierające wyłącznie odpowiedź funkcji pozostają poprawne.

Ustrukturyzowane odpowiedzi

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 1024,
    "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. Używaj w tej wiadomości zapisu 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żyj tools[].functionDeclarations z nazwą i albo parameters, albo parametersJsonSchema, nie z oboma. Schematy odpowiedzi podlegają tej samej zasadzie wzajemnego wykluczania. Wybór funkcji znajduje się w toolConfig.functionCallingConfig; allowedFunctionNames wymaga ANY lub VALIDATED oraz zadeklarowanych nazw.

Model obsługuje wywoływanie funkcji. Aplikacja wykonuje zwrócone funkcje i dostarcza ich wyniki w następnej turze rozmowy. Zachowaj każdy oryginalny thoughtSignature, wywołanie funkcji i odpowiedź funkcji. Nie zaokrąglaj identyfikatorów liczbowych podczas serializacji argumentów funkcji o niejawnej strukturze.

Google wymienia Search, Maps, wykonywanie kodu i kontekst adresu URL jako możliwości modelu. Dokumentacja modelu potwierdza obsługę File Search. Istniejące zasoby pamięci podręcznej i wyszukiwania plików wymagają dostępu z użyciem danych uwierzytelniających obsługujących żądanie. Computer Use jest wymienione jako wersja testowa. Natywna konfiguracja MCP występuje w schemacie ogólnym, ale jej dostępność dla tego modelu nie została potwierdzona. Google Maps wymaga wyłącznie tekstowego wejścia i wyjścia; przed połączeniem Maps z multimediami sprawdź oficjalne ograniczenia API. Playground nie wykonuje twoich niestandardowych funkcji.

Wejście multimodalne i bezpieczeństwo

Element contents[].parts[] zawiera dokładnie jeden ładunek danych: tekst, multimedia inline, odwołanie do pliku, wywołanie/odpowiedź funkcji lub część wykonania. Może też zawierać podpis lub metadane multimediów. Wejście obsługuje tekst, obrazy, dźwięk, wideo i pliki PDF; wyjście jest wyłącznie tekstowe.

Dla bajtów inline 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ć zawartość. Metadane wideo mogą określać przesunięcia początku/końca i dodatnie fps nie większe niż 24. Globalna rozdzielczość multimediów i rozdzielczość poszczególnych części to odrębne ustawienia. Agentic Video jest obsługiwane przez videoMetadata.processingMode: "AGENTIC".

Dla multimediów inline użyj natywnego JSON, a dla większych multimediów dostępnego odwołania do pliku. Dokładne limity formatu plików, czasu trwania i multimediów na żądanie nadal podlegają oficjalnej dokumentacji multimediów i weryfikacji online.

Ustawienia bezpieczeństwa korzystają z oficjalnego formatu natywnego. Pominięcie pozostawia domyślne ustawienia Gemini API; ustawienia podane jawnie przechodzą bez zmian.

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, 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 niepowodzenia ani ukończenia generowania; przed wysłaniem kolejnego żądania sprawdź częściowy wynik i zapis na koncie. Zużycie w strumieniu jest skumulowane, więc używaj najnowszych liczników zamiast sumować każdy fragment.

Kontynuacja dłuższego wyjścia nie została potwierdzona dla Gemini 3.8 Flash. Nie buduj pętli kontynuacji tylko dlatego, że ogólny schemat odpowiedzi zawiera pole tokenu.

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, a nie ponownie jako zwykłe wejście. Płatne wyjście obejmuje candidatesTokenCount oraz thoughtsTokenCount. Zgłoszone tokeny promptu używane przez narzędzia również wliczają się do wejścia.

Model nie ma zmiany stawki za długi kontekst przy 200 000 tokenów. Dostępne grupy konta używają tego samego wyrażenia cenowego modelu i własnego bieżącego mnożnika. Zobacz aktualną tabelę cen.

Flex i Priority to odrębne poziomy przetwarzania. Flex stosuje połowę stawek Standard za wejście, wyjście i wejście z pamięci podręcznej; Priority stosuje 1,8-krotność tych stawek. Opublikowane promocyjne stawki Google obowiązują do 31 grudnia 2026 r.; zawsze sprawdzaj bieżącą tabelę SeedRouter, zamiast zakładać przyszłą stawkę. Wynik zgłoszony jako Standard nie może powodować dopłaty Priority. Jeśli odpowiedź zażądana jako Priority nie potwierdza rzeczywistego poziomu, ta integracja używa stawek Standard za tokeny. Opłaty za narzędzia i jawne przechowywanie pamięci podręcznej są odrębne od cen tokenów generowania; nie obiecujemy wspólnego bezpłatnego limitu narzędzi. Nieudane żądania nie są płatne.

Wiele grup konta

Model korzysta z googlellm i googlellm-vertext, zachowując ich istniejące uprawnienia konta i ceny. Zachowaj dokładną pisownię każdej nazwy grupy. Wybierz dostępną grupę w Playground lub użyj opcjonalnego nagłówka API:

X-SeedRouter-Group: googlellm

Użyj googlellm-vertext, aby wybrać drugą grupę. Wybrana grupa określa cenę i dostępną przepustowość; jawny wybór nie przełącza się po cichu na inną grupę. Pomiń nagłówek lub użyj auto, aby zachować domyślne działanie klucza API.

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

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

Status weryfikacji

Ustawienia i dokumentacja są zgodne z oficjalnym formatem natywnym. Weryfikacja parametrów należy do Gemini API. Testy transportu i rozliczeń offline nie potwierdzają dostępności produkcyjnej. Generowanie online, obie grupy konta, rozumienie multimediów, zasoby w pamięci podręcznej, wbudowane narzędzia i poziomy przetwarzania nadal wymagają płatnej weryfikacji całego przepływu. Nie przedstawiamy zmierzonego porównania jakości ani opóźnień z Gemini 3.1 Pro.

Źródła

• Specyfikacja modelu Google
• Zmiany w Gemini 3.8
• Dokumentacja REST GenerateContent
• Ustrukturyzowane odpowiedzi
• Rozumowanie
• Ceny