Text
Gemini 4 Argon
בקשות Gemini בפורמט המקורי, קלט רב־אופני, חשיבה, כלים, הזרמה והמשך. כולל גבולות האימות העדכניים.
השתמש ב-gemini-4-argon בפורמט המקורי של Gemini. עמוד המודל כולל את ה-Playground והמחירים העדכניים; מדריך ההשקה מסביר את הזמינות.
מזהה המודל
| מזהה המודל | חלון הקשר | עומק חשיבה ברירת מחדל |
|---|---|---|
gemini-4-argon | 1,048,576 טוקנים | medium |
דוגמה מהירה
curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon: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":256}}'המודל מצוין ב-URL. השדה contents נדרש. תשובה כוללת את השדות המקוריים candidates, finishReason ו-usageMetadata; שמור את חלקי התוכן במלואם, כולל thoughtSignature, בהיסטוריית השיחה.
נקודות קצה
| פעולה | נקודת קצה |
|---|---|
| תשובת JSON | POST /v1beta/models/gemini-4-argon:generateContent |
| אירועים הנשלחים מהשרת | POST /v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse |
מפרט OpenAPI כולל את כל הסכמות המקוננות של בקשות ותשובות. שדות אופציונליים שהושמטו משתמשים בברירות המחדל של ה-API. שדות לא מוכרים ושדות שאינם נתמכים רשמית מושמטים; ערכים לא תקינים בשדות נתמכים עדיין גורמים לשגיאות.
פרמטרים
| שם | סוג | חובה | ברירת מחדל | הערות |
|---|---|---|---|---|
contents | object[] | כן | — | מערך השיחה הנדרש; parts מכיל טקסט, מדיה ותוצאות כלים |
systemInstruction | object | לא | — | הוראת מערכת בטקסט בלבד |
generationConfig | object | לא | — | תקציב פלט, חשיבה, פלט מובנה, עצירה והגדרות מדיה |
tools | object[] | לא | — | הגדרות פונקציות וכלים מובנים |
toolConfig | object | לא | — | בחירת פונקציות, הגדרות אחזור וחלקי כלים של השרת |
safetySettings | object[] | לא | — | זוגות ייחודיים של קטגוריה וסף |
continuationToken | string | לא | — | טוקן המשך אטום מהמועמד האחרון, שיש לשמר כפי שהוא |
serviceTier | enum | לא | standard | unspecified, standard, flex, priority; ברירת המחדל היא standard |
labels | object | לא | — | מפתחות וערכי תוויות באותיות קטנות, עד 63 תווי Unicode לכל אחד |
store | boolean | לא | — | העדפה לרישום הבקשה; אינה מאפשרת אחזור שיחות שמורות |
model | string | לא | — | שם משאב אופציונלי בגוף הבקשה; ה-URL קובע את המודל |
generationConfig כולל את maxOutputTokens, thinkingConfig, stopSequences, responseFormat, השדות הישנים responseMimeType/responseSchema/responseJsonSchema, וכן responseModalities, mediaResolution, seed, presencePenalty, frequencyPenalty, responseLogprobs, logprobs, enableEnhancedCivicAnswers, enableAffectiveDialog, translationConfig ו-audioTranscriptionConfig. שדות כלליים שההתנהגות שלהם במודל הזה לא אושרה עדיין כפופים לאימות יכולות.
- רמות חשיבה:
low,medium,high; ברירת המחדל היאmedium. אי אפשר לכבות את החשיבה.includeThoughtsמבקש סיכומים. הפרמטר המיושןthinkingBudgetמתקבל כשלעצמו, אבל אי אפשר לשלב אותו עםthinkingLevel. - קלט, חשיבה ופלט חולקים 1,048,576 טוקנים.
maxOutputTokensכולל חשיבה; יתרת ההקשר עשויה לצמצם את התקציב בפועל. - ב-REST המקורי, התקרה וברירת המחדל לפלט הן 32,768 טוקנים לבקשה, או 65,536 בהזרמה. פלט ארוך יותר משתמש בהמשך. התיעוד הרשמי סותר את עצמו בנוגע לבקשות ראשונות ללא הזרמה מעל 32,768; השילוב הזה אינו כופה את המספר כמגבלה על כלל היצירה.
- לכל היותר חמישה
stopSequences. הטווח שלlogprobsהוא 0 עד 20, ונדרשresponseLogprobs: true. responseSchemaו-responseJsonSchemaאינם ניתנים לשימוש יחד, ושניהם דורשיםresponseMimeType: "application/json". בקשות חדשות יכולות להשתמש ב-responseFormat.textהמוצג בהמשך.responseModalitiesיכול להכיל רקTEXT. Temperature, top-p, top-k ומספר המועמדים אינם פקדים פעילים ב-Argon. אין תמיכה ב-cachedContentמפורש, ביצירת תמונות וביצירת דיבור.
פלט מובנה וכלים
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 256,
"responseFormat": {
"text": {
"mimeType": "APPLICATION_JSON",
"schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
}
}
}
}פונקציות משתמשות ב-tools[].functionDeclarations. הפרמטר allowedFunctionNames דורש מצב ANY או VALIDATED ושמות שהוצהרו. שמור על הסדר המקורי של קריאות לפונקציות, תשובות וחתימות. Google Search, Maps, הרצת קוד, URL context, File Search ו-Computer Use הן יכולות רשמיות; יש לאמת את הגישה למשאבים, החיובים וההתנהגות עבור הפעולה הרצויה. ה-Playground אינו מריץ כלים מקומית.
מדיה ובטיחות
parts בפורמט המקורי מקבל טקסט, תמונות, אודיו, וידאו ו-PDF דרך inlineData או fileData. כל חלק מכיל סוג מטען נתונים אחד, ויכול לכלול גם חתימות חשיבה ומטא־נתונים של מדיה. mediaResolution גלובלי ורזולוציה לכל חלק הם הגדרות נפרדות. וידאו תומך בעיבוד STATIC ו-AGENTIC; הערך של videoMetadata.fps חייב להיות גדול מאפס ולא יותר מ-24.
ה-Playground מקבל בקשת JSON בגודל של עד 12 MiB. זו מגבלת תעבורה של היישום, ולא מגבלת המדיה של המודל. למדיה גדולה, השתמש בהפניות לקבצים שהחשבון שלך תומך בהן. למשאבי קבצים ולמדיה שמאוחזרת מבחוץ יש מגבלות רשמיות שונות; הזמינות שלהם כאן עדיין לא אומתה.
הגדרות הבטיחות ב-API הציבורי פועלות לפי החוזה המקורי. ה-Playground דורש חסימה ברמה בינונית ומעלה בארבע קטגוריות הבטיחות העיקריות; ספים נמוכים יותר זמינים רק ב-API, עם חריגה למנהלי מערכת.
הזרמה והמשך
קרא אירועי JSON בפורמט המקורי מזרם ה-SSE. שמור את כל החלקים, כולל מטא־נתונים של כלים וחשיבה. מוני השימוש בתוך זרם אחד הם מצטברים: השתמש באובייקט השימוש האחרון במקום לחבר כל אירוע.
כאשר מועמד מחזיר continuationToken, שמור אותו בדיוק כפי שהוא. עבור CONTINUATION, שלח מחדש את contents, הוראת המערכת, הכלים והגדרות היצירה המקוריים, עם הטוקן האחרון ברמה העליונה. אל תוסיף פלט חלקי ל-contents. עבור MAX_TOKENS, הגדל את תקציב הפלט לפני החידוש. ה-Playground מכין בקשת המשך לבדיקה ושולח אותה רק לאחר לחיצה נוספת על כפתור השליחה.
כל המשך הוא בקשה נפרדת עם שימוש וחיוב משלה. שמור נקודות ביקורת אם אתה מממש חיבור מחדש; לעולם אל תניח שזרם שהתנתק הושלם. התשובה המקורית נשמרת ב-Playground כדי לאפשר בדיקה של כל השדות.
שימוש ומצב האימות העדכני
שימוש הקלט כולל קלט מהמטמון; הפלט המחויב כולל טוקנים של המועמדים ושל החשיבה. בדוק את התעריפים העדכניים בעמוד המודל ואת רישומי השימוש בחשבון שלך. בקשות שנכשלו אינן מחויבות.
בדיקות מקומיות ב-14 באוקטובר 2026 אימתו הזרמת טקסט, JSON מובנה, קריאות חתומות לפונקציות עם החזרת תוצאות, הרצת קוד, Google Search ו-URL context, הבנת תמונות, וידאו ו-PDF, פלט חשיבה ורצפי עצירה. האודיו התקבל, אך חלק מהדגימה תומלל באופן שגוי.
logprobs נדחה במפורש. בקשות עם maxOutputTokens: 32769 נכשלו גם בבדיקות JSON וגם בבדיקות SSE. התקבלו תשובות גם עבור continuationToken תקין וגם עבור טוקן לא תקין, ולכן המשך תקין לא אומת. אפשרויות רמת השירות ו-seed התקבלו בלי הוכחה להשפעה שלהם. Maps, File Search, Computer Use, agentic video והפניות לקבצים חיצוניים עדיין לא נבדקו.
הבדיקות המוגבלות האלה אינן מאמתות את כל צירופי הפרמטרים או זמינות בסביבת ייצור. השתמש בפורמט המקורי לקבלת החוזה המלא; תאימות OpenAI היא תת־קבוצה נפרדת ואינה מספקת long decode.
מקורות
בחירה אופציונלית של קבוצת LLM
יש להתחבר ל־Playground של המודל הזה כדי לבדוק אילו קבוצות זמינות. האפשרויות תלויות בהרשאות החשבון שלך ובמודל שנבחר. Playground משתמש בסשן ההתחברות שלך; אין צורך לספק מפתח API.
קריאות API ממשיכות להשתמש במפתח ה־API ובמזהה המודל שלך. כדי לבחור קבוצה, יש לשלוח את שמה המדויק בכותרת הבקשה האופציונלית X-SeedRouter-Group. יש להחליף את GROUP_NAME בהמשך בשם שמופיע ב־Playground. אפשר להשמיט את הכותרת או להשתמש ב־auto כדי לשמור על התנהגות ברירת המחדל של המפתח.
X-SeedRouter-Group: GROUP_NAMEמפתח API עם הגבלות עשוי לאפשר פחות קבוצות מאשר Playground. בקשות מחויבות לפי מחירי הקבוצה שנבחרה, ואינן עוברות לקבוצה אחרת אם היא אינה זמינה. האפשרות הזו תומכת בקריאות LLM דרך HTTP, כולל SSE; היא אינה חלה על קריאות WebSocket, תמונות או וידאו.
כדי לבדוק אילו קבוצות זמינות למפתח API מסוים בלי לייצר תשובת מודל, יש להשתמש בנקודת הקצה הזו לקריאה בלבד. data[].id הוא הערך שיש להזין בכותרת; ratio הוא מכפיל המחיר של החשבון עבור הקבוצה הזו. הרשומה auto משקפת את האומדן הנוכחי של בחירת ברירת המחדל; המכפיל שלה הוא null כשאין קבוצה זמינה לברירת המחדל. זמינות הקבוצה נבדקת שוב בעת הקריאה למודל.
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-argon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"