Gemini 4 Hydrogen

Verwende gemini-4-hydrogen mit dem nativen Gemini-Format. Die Modellseite enthält den Playground und aktuelle Preise. Gemini 4 Hydrogen verwendet dasselbe Anfrageformat wie Gemini 4 Argon; laut Googles Leitfaden muss beim Wechsel nur die Modell-ID geändert werden.

Modell-ID

Prüfe die Modellliste und deine verfügbaren Stufen, bevor du die Beispiele ausführst. Verwende die vollständige von der Abfrage zurückgegebene Aufruf-ID, wenn die Stufe Default nicht verfügbar ist.

Kurzes Beispiel

curl https://api.seedrouter.ai/v1beta/models/gemini-4-hydrogen: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":"high"},"maxOutputTokens":65536}}'

Das Modell gehört in die URL. contents ist erforderlich. Eine Antwort enthält native candidates, finishReason und usageMetadata; bewahre vollständige Inhaltsteile einschließlich thoughtSignature für den Gesprächsverlauf auf. Schwierige Prompts können mehrere Minuten benötigen. Google empfiehlt ein Client-Timeout von 20 Minuten. Nutze Streaming, um die Ausgabe zu empfangen, sobald sie verfügbar wird.

Endpunkte

Die OpenAPI-Spezifikation enthält alle verschachtelten Anfrage- und Antwortschemata. Für weggelassene optionale Felder gelten die API-Standardwerte. Die öffentliche native API bewahrt den eingereichten Body für die Validierung durch Gemini. Der Playground prüft vor dem Senden außerdem dokumentierte Einschränkungen und setzt seine Sicherheitseinstellungen durch.

Anfrageparameter

Die URL legt das Modell auf gemini-4-hydrogen fest. Der Anfragevertrag enthält 11 Felder auf oberster Ebene. Felder sind optional, sofern sie nicht als erforderlich markiert sind; Weglassen unterscheidet sich von JSON null. Beliebiges JSON, das null sein darf, bleibt dort erhalten, wo das offizielle Schema es zulässt.

Explizites Kontext-Caching (cachedContent und cachedContents-Ressourcen) wird bei Gemini 4 Hydrogen nicht unterstützt. Implizites Caching ist für Prompts mit mindestens 4.096 Token standardmäßig aktiv.

Generierungsparameter

Das OpenAPI-Dokument führt verschachtelte Typen, Enums, erforderliche Eigenschaften und dokumentierte Grenzen für jede Nachricht auf. Die Schemata beschreiben offizielle Parameter; sie sind keine SeedRouter-Zulassungsliste für Anfragen. Vom Aufrufer übergebene Felder und Werte bleiben erhalten. Ein vom Schema akzeptiertes Feld belegt keine Unterstützung für jedes Konto. minimal ist keine aufgeführte Denkstufe. Laut Google sind temperature, topP, topK und candidateCount veraltet und sollten entfernt werden; benutzerdefinierte Sampling-Werte werden ignoriert. Werden sie im nativen JSON gesendet, werden sie dennoch unverändert zur Verarbeitung durch die Gemini API weitergegeben.

Long Decode

Eine Antwort von Gemini 4 Hydrogen gibt mit Streaming bis zu 65.536 Token und ohne Streaming bis zu 65.536 Token zurück. Setze für längere Ausgaben maxOutputTokens über 65.536 und setze die Antwort selbst fort:

1. Sende die Anfrage. Endet die Antwort mit finishReason: "CONTINUATION", lies candidates[0].continuationToken aus.
2. Sende dieselbe Anfrage erneut mit diesem Wert im Feld continuationToken auf oberster Ebene. Hänge die Teilausgabe nicht an contents an; das Token enthält den Modellzustand einschließlich des Denkens.
3. Wiederhole dies, bis finishReason den Wert STOP oder MAX_TOKENS hat.

{
  "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"
}

Eine vollständig für Denken verwendete Runde kann leeren Text mit CONTINUATION zurückgeben; das ist ein normaler Fortschritt. In jeder Runde wird dein Prompt zusammen mit allem bisher Erzeugten erneut an das Modell gesendet. Deshalb werden Eingabe-Token in jeder späteren Runde erneut gezählt. SeedRouter berechnet jede Runde als eigene Anfrage. Der serverseitige background-Modus der Interactions API ist nicht Teil dieses Endpunkts.

Strukturierte Ausgabe

{
  "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"]
    }
  }
}

Die bisherigen Felder responseSchema und responseJsonSchema können nicht gemeinsam verwendet werden. Beide erfordern responseMimeType: "application/json". Das neuere Schema responseFormat.text muss ebenfalls JSON angeben. Verwende in dieser Nachricht die REST-Enum-Schreibweisen (APPLICATION_JSON und TEXT_PLAIN). Anfragen werden unverändert weitergegeben; Medien-MIME-Typen und beliebiges Funktions-JSON werden nicht umgeschrieben.

Funktionen und integrierte Werkzeuge

Verwende tools[].functionDeclarations mit einem Namen und entweder parameters oder parametersJsonSchema, nicht beiden. Die Funktionsauswahl erfolgt in toolConfig.functionCallingConfig; allowedFunctionNames erfordert ANY oder VALIDATED und deklarierte Namen.

Deine Anwendung führt zurückgegebene Funktionen aus und liefert deren Ergebnisse in der nächsten Gesprächsrunde. Bewahre jede ursprüngliche thoughtSignature, jeden Funktionsaufruf und jede Funktionsantwort auf. Runde numerische Kennungen beim Serialisieren opaker Funktionsargumente nicht.

Google führt Search, Maps, Codeausführung, URL-Kontext, File Search und Computer Use für dieses Modell auf. File Search-Ressourcen erfordern Zugriff mit den für die Anfrage verwendeten Zugangsdaten. Native MCP-Konfiguration steht im allgemeinen Schema, ihre Verfügbarkeit für dieses Modell ist jedoch nicht belegt. Prüfe die offiziellen Einschränkungen jedes Werkzeugs, bevor du es mit Medien kombinierst. Beim Grounding zählt Google interne Werkzeuganweisungen und Funktionsdeklarationen als Eingabe-Token. Der Playground führt deine benutzerdefinierten Funktionen nicht aus.

Multimodale Eingabe und Sicherheit

Ein contents[].parts[]-Element enthält genau eine Nutzlast: Text, Inline-Medien, einen Dateiverweis, einen Funktionsaufruf/eine Funktionsantwort oder einen Ausführungsteil. Es kann außerdem eine Signatur oder Medienmetadaten enthalten. Die Eingabe unterstützt Text, Bilder, Audio, Video und PDFs; die Ausgabe besteht ausschließlich aus Text. Das Modell bietet weder Bild- noch Audiogenerierung und keine Live API.

Verwende für Inline-Bytes inlineData.mimeType und Base64-data. Verwende für Dateiverweise fileData.mimeType und fileUri. Eine syntaktisch gültige URL belegt nicht, dass das Modell sie abrufen kann. Videometadaten können Start-/End-Offsets und eine positive fps von höchstens 24 angeben. Agentisches Videoverständnis wird pro Teil mit mediaProcessing: "AGENTIC" neben fileData oder inlineData des Videos ausgewählt; standardmäßig gilt statische Verarbeitung. videoMetadata enthält nur startOffset, endOffset und fps.

Sicherheitseinstellungen verwenden das offizielle native Format und werden unverändert durch die API weitergegeben. Im Playground müssen alle vier Kategorien auf BLOCK_MEDIUM_AND_ABOVE oder strenger eingestellt sein; niedrigere Schwellenwerte sind nur über die API verfügbar.

JSON-Antworten und Streaming

generateContent gibt natives JSON zurück. streamGenerateContent?alt=sse gibt natives JSON in SSE-data:-Ereignissen aus. Wichtige Felder sind candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId und usageMetadata.

Bewahre vollständige native Inhalte im Gesprächsverlauf auf. Denkzusammenfassungen sind nicht dasselbe wie Denksignaturen. Ein Verbindungsabbruch belegt weder ein Scheitern noch einen Abschluss der Generierung; prüfe das Teilergebnis und den Kontoeintrag, bevor du eine weitere Anfrage sendest. Die Streaming-Nutzung ist kumulativ. Verwende daher die neuesten Zähler, statt jeden Chunk zu summieren.

Nutzung und Preise

promptTokenCount enthält zwischengespeicherte Eingabe. cachedContentTokenCount wird zum Tarif für zwischengespeicherte Eingabe berechnet und nicht erneut als ungespeicherte Eingabe. Die abrechenbare Ausgabe umfasst candidatesTokenCount plus thoughtsTokenCount. Hydrogen verwendet standardmäßig die Denkstufe high. Lege die Stufe ausdrücklich fest, wenn du seine Nutzung mit einem anderen Modell vergleichst.

Für dieses Modell gibt es keine Preisstufe nach Kontextlänge. Aktuelle SeedRouter-Preise verwenden Standard-Token-Tarife; Flex-Rabatte und Priority-Zuschläge sind für diese Integration nicht konfiguriert. Die Unterstützung dieser Verarbeitungsstufen muss noch überprüft werden. Google Search-Grounding kann zusätzlich zur Token-Nutzung Kosten pro Suchanfrage verursachen; prüfe die Werkzeugpreise vor dem Aktivieren. Fehlgeschlagene Anfragen werden nicht berechnet. Siehe die aktuelle Preistabelle.

Kontogruppen

Die Stufe Default verwendet die reine Modell-ID gemini-4-hydrogen. Zusätzliche Stufen verwenden gemini-4-hydrogen:GROUP_NAME in der URL. Der Playground wählt eine verfügbare Stufe; die API akzeptiert außerdem einen ausdrücklichen Header:

X-SeedRouter-Group: GROUP_NAME

Die gewählte Gruppe bestimmt den Preis und die verfügbare Kapazität; eine ausdrückliche Auswahl wechselt nicht stillschweigend zu einer anderen Gruppe. Lasse den Header weg oder verwende auto, um das Standardverhalten des API-Schlüssels beizubehalten.

Prüfe die verfügbaren Gruppen deines API-Schlüssels, ohne eine Antwort zu generieren:

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

Prüfstatus

Die offizielle Dokumentation wurde am 13. November 2026 geprüft. An diesem Datum bestanden drei bezahlte Prüfungen mit jeweils einem Versuch über SeedRouter: strukturiertes JSON mit low-Denken, SSE mit xhigh-Denken und der Aufruf einer deklarierten Funktion mit low-Denken. Die gemeldeten Eingabe-, Ausgabe- und Denktokens stimmten zu den veröffentlichten Tarifen mit den erfassten Gebühren überein. Medienverständnis, Grounding, Computer Use, Fortsetzung/Long Decode, andere allgemeine Felder und Verarbeitungstiers bleiben ungeprüft. Diese Prüfungen belegen weder vergleichende Qualität noch Latenz.

Referenzen

• Google-Modellspezifikation
• Neues in Gemini 4 Hydrogen
• Long Decode mit generateContent
• Denken
• Preise
• GenerateContent-REST-Referenz