Gemini 4 Hydrogen

השתמש ב-gemini-4-hydrogen בפורמט Gemini המקורי. עמוד המודל כולל את ה-Playground ואת המחירים העדכניים. Gemini 4 Hydrogen משתמש באותו פורמט בקשה כמו Gemini 4 Argon; לפי המדריך של Google, מעבר ביניהם דורש רק שינוי של מזהה המודל.

מזהה המודל

בדוק את רשימת המודלים ואת הרמות הזמינות לך לפני הרצת הדוגמאות. השתמש במזהה הקריאה המלא שמוחזר בגילוי כשהרמה Default אינה זמינה.

דוגמה מהירה

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}}'

המודל מצוין ב-URL. השדה contents נדרש. תשובה כוללת candidates, finishReason ו-usageMetadata בפורמט המקורי; שמור חלקי תוכן מלאים, כולל thoughtSignature, להיסטוריית השיחה. הנחיות קשות עשויות להימשך כמה דקות. Google ממליצה על זמן קצוב של 20 דקות בצד הלקוח. השתמש בהזרמה כדי לקבל פלט כשהוא נעשה זמין.

נקודות קצה

מפרט OpenAPI כולל את כל סכמות הבקשה והתשובה המקוננות. שדות אופציונליים משתמשים בברירות המחדל של ה-API כשמשמיטים אותם. ה-API הציבורי בפורמט המקורי משמר את גוף הבקשה שנשלח לצורך אימות של Gemini. ה-Playground גם בודק אילוצים מתועדים לפני השליחה ואוכף את הגדרות הבטיחות שלו.

פרמטרי בקשה

ה-URL קובע את המודל ל-gemini-4-hydrogen. חוזה הבקשה מכיל 11 שדות ברמה העליונה. שדות הם אופציונליים אלא אם סומנו כחובה; השמטה שונה מערך JSON מסוג null. JSON שרירותי המאפשר null נשמר במקומות שבהם הסכמה הרשמית מתירה זאת.

מטמון הקשר מפורש (משאבי cachedContent ו-cachedContents) אינו נתמך ב-Gemini 4 Hydrogen. מטמון מרומז מופעל כברירת מחדל להנחיות של לפחות 4,096 טוקנים.

פרמטרי יצירה

מסמך OpenAPI מפרט סוגים מקוננים, ערכי enum, מאפייני חובה וגבולות מתועדים לכל הודעה. הסכמות מתארות פרמטרים רשמיים; הן אינן רשימת שדות מורשים לבקשות SeedRouter. שדות וערכים שסיפק הקורא נשמרים. קבלת שדה בסכמה אינה הוכחה לתמיכה בכל חשבון. חשיבה ברמת minimal אינה רמה ברשימה. Google מציינת ש-temperature, topP, topK ו-candidateCount מיושנים ומומלץ להסירם; ערכי דגימה מותאמים אישית זוכים להתעלמות. אם שולחים אותם ב-JSON המקורי, הם עדיין מועברים ללא שינוי לטיפול ה-API של Gemini.

יצירה ארוכה בהמשכים

תשובת Gemini 4 Hydrogen אחת מחזירה עד 65,536 טוקנים בהזרמה ועד 65,536 טוקנים ללא הזרמה. כדי להמשיך מעבר לכך, הגדר maxOutputTokens מעל 65,536 והמשך את התשובה בעצמך:

1. שלח את הבקשה. אם התשובה מסתיימת ב-finishReason: "CONTINUATION", קרא את candidates[0].continuationToken.
2. שלח שוב את אותה בקשה עם הערך הזה בשדה continuationToken שברמה העליונה. אל תוסיף את הפלט החלקי ל-contents; הטוקן נושא את מצב המודל, כולל החשיבה שלו.
3. חזור על כך עד ש-finishReason יהיה STOP או 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"
}

סבב בקשה שמוקדש כולו לחשיבה יכול להחזיר טקסט ריק עם CONTINUATION; זו התקדמות תקינה. כל סבב שולח חזרה למודל את ההנחיה שלך יחד עם כל מה שנוצר עד כה, ולכן טוקני הקלט נספרים שוב בכל סבב מאוחר יותר. SeedRouter מחייב כל סבב כבקשה נפרדת. מצב background בצד השרת של Interactions API אינו חלק מנקודת הקצה הזו.

פלט מובנה

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

אי אפשר להשתמש יחד בשדות הוותיקים responseSchema ו-responseJsonSchema. שניהם דורשים responseMimeType: "application/json". גם הסכמה החדשה יותר responseFormat.text חייבת לציין JSON. השתמש בכתיב ערכי enum של REST (APPLICATION_JSON ו-TEXT_PLAIN) בהודעה הזו. הבקשות מועברות ללא שינוי; סוגי MIME של מדיה ו-JSON שרירותי של פונקציות אינם נכתבים מחדש.

פונקציות וכלים מובנים

השתמש ב-tools[].functionDeclarations עם שם ועם parameters או parametersJsonSchema, אך לא שניהם. בחירת הפונקציות נמצאת ב-toolConfig.functionCallingConfig; השדה allowedFunctionNames דורש ANY או VALIDATED ושמות שהוצהרו.

היישום שלך מבצע את הפונקציות שהוחזרו ומספק את תוצאותיהן בסבב השיחה הבא. שמור כל thoughtSignature מקורי, קריאה לפונקציה ותשובת פונקציה. אל תעגל מזהים מספריים בעת סריאליזציה של ארגומנטים אטומים לפונקציות.

Google מציינת Search, Maps, ביצוע קוד, הקשר URL, File Search ו-Computer Use עבור המודל הזה. משאבי File Search דורשים גישה באמצעות פרטי ההזדהות המשמשים את הבקשה. הגדרות MCP בפורמט המקורי מופיעות בסכמה הכללית, אך זמינותן למודל הזה לא הוכחה. בדוק את ההגבלות הרשמיות של כל כלי לפני שילובו עם מדיה. בשימוש בעיגון במקורות, Google סופרת הוראות פנימיות לכלים והצהרות פונקציות כטוקני קלט. ה-Playground אינו מבצע את הפונקציות המותאמות אישית שלך.

קלט רב־אופני ובטיחות

פריט contents[].parts[] מכיל מטען תוכן אחד בדיוק: טקסט, מדיה מוטמעת, הפניה לקובץ, קריאה או תשובה לפונקציה, או חלק ביצוע. הוא עשוי לשאת גם חתימה או מטא־נתונים של מדיה. הקלט תומך בטקסט, בתמונות, באודיו, בווידאו ובקובצי PDF; הפלט הוא טקסט בלבד. למודל אין יצירת תמונות או אודיו ואין Live API.

לבתים מוטמעים, השתמש ב-inlineData.mimeType וב-data בקידוד base64. להפניות לקבצים, השתמש ב-fileData.mimeType וב-fileUri. URL תקין תחבירית אינו הוכחה לכך שהמודל יכול לאחזר אותו. מטא־נתוני וידאו יכולים לציין היסטי התחלה וסיום ו-fps חיובי שאינו עולה על 24. הבנת וידאו סוכנית נבחרת לכל חלק באמצעות mediaProcessing: "AGENTIC" לצד fileData או inlineData של הווידאו; עיבוד סטטי הוא ברירת המחדל. videoMetadata מכיל רק startOffset, endOffset ו-fps.

הגדרות הבטיחות משתמשות בפורמט המקורי הרשמי ומועברות דרך ה-API ללא שינוי. ב-Playground, יש להגדיר את כל ארבע הקטגוריות ל-BLOCK_MEDIUM_AND_ABOVE או לרמה מחמירה יותר; ספים נמוכים יותר זמינים רק דרך ה-API.

תשובות JSON והזרמה

generateContent מחזיר JSON בפורמט המקורי. streamGenerateContent?alt=sse פולט JSON בפורמט המקורי באירועי data: של SSE. שדות חשובים כוללים candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId ו-usageMetadata.

שמור תוכן מלא בפורמט המקורי בהיסטוריית השיחה. סיכומי חשיבה אינם זהים לחתימות חשיבה. ניתוק אינו מוכיח שהיצירה נכשלה או הושלמה; בדוק את התוצאה החלקית ואת רישום החשבון לפני שליחת בקשה נוספת. נתוני השימוש בהזרמה מצטברים, לכן השתמש במונים האחרונים במקום לסכם כל מקטע.

שימוש ותמחור

promptTokenCount כולל קלט מהמטמון. cachedContentTokenCount מחויב בתעריף קלט מהמטמון, במקום לחייבו שוב כקלט שאינו מהמטמון. פלט לחיוב כולל candidatesTokenCount בתוספת thoughtsTokenCount. ברירת המחדל של Hydrogen היא חשיבה ברמת high. הגדר את הרמה במפורש בהשוואת השימוש שלו למודל אחר.

למודל הזה אין מדרגת מחיר לפי אורך ההקשר. מחירי SeedRouter העדכניים משתמשים בתעריפי טוקנים של Standard; הנחות Flex ותוספות Priority לא הוגדרו לאינטגרציה הזו. התמיכה ברמות העיבוד האלה עדיין דורשת אימות. עיגון באמצעות Google Search יכול להוסיף חיובים לכל שאילתה מעבר לשימוש בטוקנים; בדוק את תמחור הכלי לפני הפעלתו. בקשות שנכשלו אינן מחויבות. ראה את טבלת המחירים העדכנית.

קבוצות חשבון

רמת Default משתמשת במזהה המודל העירום gemini-4-hydrogen. רמות נוספות משתמשות ב-gemini-4-hydrogen:GROUP_NAME ב-URL. ה-Playground בוחר רמה זמינה; ה-API מקבל גם כותרת מפורשת:

X-SeedRouter-Group: GROUP_NAME

הקבוצה שנבחרה קובעת את המחיר ואת הקיבולת הזמינה; בחירה מפורשת אינה עוברת בשקט לקבוצה אחרת. השמט את הכותרת או השתמש ב-auto כדי לשמור את התנהגות ברירת המחדל של מפתח ה-API.

בדוק את הקבוצות הזמינות למפתח ה-API שלך בלי ליצור תשובה:

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

מצב אימות

התיעוד הרשמי נבדק ב-13 בנובמבר 2026. באותו תאריך עברו שלוש בדיקות בתשלום דרך SeedRouter, כל אחת בניסיון יחיד: JSON מובנה עם חשיבה low, ‏SSE עם חשיבה xhigh וקריאה לפונקציה שהוצהרה עם חשיבה low. טוקני הקלט, הפלט והחשיבה שדווחו תאמו לחיובים שנרשמו בתעריפים המפורסמים. הבנת מדיה, עיגון במקורות, Computer Use, המשך/פענוח ארוך, שדות כלליים אחרים ורמות עיבוד נותרים לא מאומתים. הבדיקות האלה אינן קובעות איכות או השהיה השוואתיות.

מקורות

• מפרט המודל של Google
• מה חדש ב-Gemini 4 Hydrogen
• יצירה ארוכה בהמשכים עם generateContent
• חשיבה
• תמחור
• תיעוד GenerateContent REST