Gemini 3.8 Flash

השתמש ב-gemini-3.8-flash בפורמט המקורי של Gemini. עמוד המודל כולל את ה-Playground והמחירים העדכניים; מדריך השוואת המודלים משווה את ההגדרות המתועדות לאלה של Gemini 3.1 Pro.

מזהה המודל

דוגמה מהירה

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

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

נקודות קצה

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

פרמטרי בקשה

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

פרמטרי יצירה

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

פלט מובנה

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

אי אפשר להשתמש יחד בשדות הישנים 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 context כיכולות של המודל. תיעוד המודל מציין תמיכה ב-File Search. משאבי מטמון וחיפוש קבצים קיימים דורשים גישה באמצעות פרטי האימות שמשרתים את הבקשה. Computer Use מופיע בתצוגה מקדימה. תצורת MCP מקורית מופיעה בסכמה הכללית, אך זמינותה עבור המודל הזה לא הוכחה. Google Maps דורש קלט ופלט בטקסט בלבד; בדוק את מגבלות ה-API הרשמיות לפני שילוב Maps עם מדיה. ה-Playground אינו מבצע את הפונקציות המותאמות אישית שלך.

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

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

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

השתמש ב-JSON בפורמט המקורי למדיה מוטמעת, או בהפניה נגישה לקובץ עבור מדיה גדולה יותר. המגבלות המדויקות על פורמט הקובץ, משך המדיה וכמות המדיה לבקשה עדיין כפופות לתיעוד המדיה הרשמי ולאימות חי.

הגדרות הבטיחות משתמשות בפורמט המקורי הרשמי. אי־שליחתן משאירה את ברירות המחדל של ה-Gemini API בתוקף; הגדרות שנשלחו במפורש מועברות ללא שינוי.

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

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

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

המשך של פלט ארוך יותר לא הוכח עבור Gemini 3.8 Flash. אל תבנה לולאת המשך רק מפני שסכמת התשובה הכללית כוללת שדה טוקן.

שימוש ותמחור

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

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

Flex ו-Priority הן רמות עיבוד נפרדות. Flex משתמש במחצית מתעריפי הקלט, הפלט והקלט מהמטמון של Standard; Priority משתמש בתעריפים האלה כפול 1.8. תעריפי ההיכרות שפרסמה Google מסתיימים ב-31 בדצמבר 2026; בדוק תמיד את טבלת SeedRouter העדכנית במקום להניח מה יהיה התעריף בעתיד. תוצאה שמדווחת כ-Standard אינה אמורה לשאת תוספת Priority. אם תשובה שהתבקשה ברמת Priority אינה מוכיחה את הרמה בפועל, השילוב הזה משתמש בתעריפי הטוקנים של Standard. חיובי כלים ואחסון מטמון מפורש נפרדים מתמחור טוקני היצירה; אין הבטחה למכסת כלים משותפת ללא תשלום. בקשות שנכשלו אינן מחויבות.

קבוצות חשבון מרובות

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

X-SeedRouter-Group: googlellm

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

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

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

מצב האימות

הפקדים והתיעוד פועלים לפי הפורמט המקורי הרשמי. אימות הפרמטרים הוא באחריות ה-Gemini API. בדיקות תעבורה וחיוב לא מקוונות אינן מוכיחות זמינות בייצור. יצירה חיה, שתי קבוצות החשבון, הבנת מדיה, משאבי מטמון, כלים מובנים ורמות עיבוד עדיין דורשים אימות בתשלום מקצה לקצה. אין כאן טענה להשוואת איכות או זמן אחזור שנמדדו מול Gemini 3.1 Pro.

מקורות

• מפרט המודל של Google
• שינויים ב-Gemini 3.8
• מדריך GenerateContent REST
• פלט מובנה
• חשיבה
• תמחור