Gemini 4 Carbon

Używaj gemini-4-carbon w natywnym formacie Gemini. Strona modelu zawiera Playground i aktualne ceny. Gemini 4 Carbon używa tego samego formatu żądań co Gemini 4 Argon; według przewodnika Google przejście między nimi wymaga tylko zmiany ID modelu.

ID modelu

Krótki przykład

curl https://api.seedrouter.ai/v1beta/models/gemini-4-carbon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"medium"},"maxOutputTokens":32768}}'

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. Trudne prompty mogą wymagać kilku minut. Żądanie bez strumieniowania trwające dłużej niż około 100 sekund może zakończyć się HTTP 524 przed nadejściem odpowiedzi, dlatego używaj streamGenerateContent przy długich zadaniach; przykłady ustawiają też limit czasu klienta na 15 minut, zgodnie z zaleceniem Google.

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-4-carbon. 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 wartości null zostaje zachowany tam, gdzie pozwala na to oficjalny schemat.

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

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 na każdym koncie. minimal nie jest wymienionym poziomem rozumowania. Google podaje, że temperature, topP i topK są ignorowane przez ten model; candidateCount nie jest oficjalnym ustawieniem. 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; tury użytkownika zawierające wyłącznie odpowiedź funkcji pozostają poprawne.

Długie odpowiedzi z kontynuacją

Jedna odpowiedź Gemini 4 Carbon zwraca do 65 536 tokenów przy strumieniowaniu i do 32 768 tokenów bez strumieniowania. Aby wygenerować 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 dołączaj częściowego wyjścia do contents; token przenosi stan modelu, w tym jego rozumowanie.
3. Powtarzaj, aż finishReason przyjmie wartość STOP lub MAX_TOKENS.

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

Część odpowiedzi poświęcona wyłącznie rozumowaniu może zwrócić pusty tekst z CONTINUATION; to normalny postęp. Przy każdej części twój prompt i wszystko, co wygenerowano dotychczas, jest ponownie wysyłane do modelu, więc tokeny wejściowe są naliczane ponownie w każdej kolejnej części. SeedRouter rozlicza każdą część jako osobne żądanie. Tryb background po stronie serwera w Interactions API nie należy do tego endpointu.

Ustrukturyzowane odpowiedzi

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 32768,
    "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. Wybór funkcji znajduje się w toolConfig.functionCallingConfig; allowedFunctionNames wymaga ANY lub VALIDATED oraz zadeklarowanych nazw.

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, kontekst adresu URL, File Search i Computer Use dla tego modelu. Zasoby File Search wymagają dostępu z użyciem danych uwierzytelniających obsługujących żądanie. 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; przed połączeniem Maps z multimediami sprawdź oficjalne ograniczenia API. Przy groundingu Google liczy wewnętrzne instrukcje narzędzi i deklaracje funkcji jako tokeny wejściowe. 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. Model nie generuje obrazów ani dźwięku i nie ma Live API.

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. Rozumienie wideo przez agenta wybiera się dla każdej części za pomocą mediaProcessing: "AGENTIC" obok fileData lub inlineData wideo; domyślne jest przetwarzanie statyczne. videoMetadata zawiera tylko startOffset, endOffset i fps.

Ustawienia bezpieczeństwa korzystają z oficjalnego formatu natywnego i przechodzą przez API bez zmian. W Playground wszystkie cztery kategorie muszą być ustawione na BLOCK_MEDIUM_AND_ABOVE lub bardziej rygorystycznie; niższe progi są dostępne tylko 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 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.

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. Gemini 4 Carbon zużywa więcej tokenów rozumowania na turę niż Gemini 4 Argon, więc przy tym samym prompcie spodziewaj się większego zużycia wyjścia.

Model nie ma zmiany ceny zależnej od długości kontekstu. Flex i Priority to odrębne poziomy przetwarzania. Wynik zgłoszony jako Standard nie może powodować dopłaty Priority; jeśli odpowiedź zażądana jako Priority nie potwierdza rzeczywistego poziomu, stosowane są stawki Standard za tokeny. Grounding Google Search i Maps jest rozliczany za zapytanie, oddzielnie od tokenów generowania. Nieudane żądania nie są płatne. Zobacz aktualną tabelę cen.

Grupy konta

Wybierz dostępną grupę w Playground lub użyj opcjonalnego nagłówka API z dokładną nazwą grupy:

X-SeedRouter-Group: GROUP_NAME

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-4-carbon" \
  -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. W żądaniach produkcyjnych 11 listopada 2026 r. (po jednej próbie) zaobserwowano:

Poziomy przetwarzania, mediaProcessing: "AGENTIC" i tokeny kontynuacji wymagają ponownego sprawdzenia po wdrożeniu obecnego wydania na produkcję. Nie przedstawiamy zmierzonego porównania jakości ani opóźnień z Gemini 4 Argon.

Źródła

• Specyfikacja modelu Google
• Zmiany w Gemini 4 Carbon
• Długie odpowiedzi z kontynuacją przez generateContent
• Rozumowanie
• Ceny
• Dokumentacja REST GenerateContent