Gemini 3.1 Pro

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

מזהה המודל

דוגמה מהירה

curl https://api.seedrouter.ai/v1beta/models/gemini-3.1-pro-preview: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.1-pro-preview. חוזה הבקשה מכיל 12 שדות ברמה העליונה. השדות אופציונליים אלא אם סומנו כחובה; אי־שליחת שדה שונה מערך JSON של null. JSON שרירותי שיכול להיות null נשמר היכן שהסכמה הרשמית מאפשרת זאת.

פרמטרי יצירה

מסמך OpenAPI מפרט סוגים מקוננים, ערכי enum, מאפייני חובה וגבולות מתועדים לכל הודעה. הסכמות מתארות פרמטרים רשמיים; הן אינן רשימת שדות מורשים לבקשות SeedRouter. שדות וערכים שהקורא מספק נשמרים. קבלת שדה בסכמה אינה הוכחה לתמיכה בכל מודל או חשבון. מודל זה אינו תומך בחשיבת minimal ובעיבוד Agentic Video.

פלט מובנה

{
  "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 ושמות שהוצהרו.

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

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

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

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

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

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

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

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

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

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

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

שימוש ותמחור

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

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

Flex ו-Priority הן רמות עיבוד נפרדות. Flex אינו מפחית את תעריפי הקלט מהמטמון לחצי. תוצאה שמדווחת כ-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.1-pro-preview"   -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

מצב האימות

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

מקורות

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