Gemini 4 Carbon

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

מזהה המודל

דוגמה מהירה

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

המודל מצוין ב-URL. השדה contents נדרש. תשובה כוללת את השדות המקוריים candidates, finishReason ו-usageMetadata; שמור את חלקי התוכן במלואם, כולל thoughtSignature, בהיסטוריית השיחה. הנחיות קשות עשויות להימשך כמה דקות. בקשה ללא הזרמה שנמשכת יותר מכ-100 שניות עלולה להסתיים ב-⁦HTTP 524⁩ לפני שהתשובה מגיעה, לכן השתמש ב-streamGenerateContent למשימות ארוכות; הדוגמאות גם מגדירות פסק זמן של 15 דקות בצד הלקוח, כפי ש-Google ממליצה.

נקודות קצה

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

פרמטרי בקשה

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

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

פרמטרי יצירה

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

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

תשובת ⁦Gemini 4 Carbon⁩ יחידה מחזירה עד 65,536 טוקנים בהזרמה ועד 32,768 טוקנים ללא הזרמה. כדי להמשיך מעבר לכך, הגדר 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": 32768,
    "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 Maps⁩ דורש קלט בטקסט בלבד; בדוק את מגבלות ה-API הרשמיות לפני שילוב Maps עם מדיה. בעת עיגון, 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. ⁦Gemini 4 Carbon⁩ משקיע יותר טוקני חשיבה בכל סבב מאשר ⁦Gemini 4 Argon⁩, ולכן יש לצפות לצריכת פלט גבוהה יותר עבור אותה הנחיה.

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

קבוצות חשבון

בחר קבוצה זמינה ב-Playground, או השתמש בכותרת ה-API האופציונלית עם שם הקבוצה המדויק:

X-SeedRouter-Group: GROUP_NAME

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

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

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

מצב האימות

הפקדים והתיעוד פועלים לפי הפורמט המקורי הרשמי. אימות הפרמטרים הוא באחריות ה-⁦Gemini API⁩. בבקשות ייצור ב-11 בנובמבר 2026 (ניסיון אחד לכל מקרה) נצפו התוצאות הבאות:

רמות העיבוד, mediaProcessing: "AGENTIC" וטוקני המשך דורשים בדיקת המשך אחרי שהגרסה הנוכחית תגיע לייצור. אין כאן טענה להשוואת איכות או זמן אחזור שנמדדו מול ⁦Gemini 4 Argon⁩.

מקורות

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