Text
Grok 4.7
השתמש ב-Grok 4.7 עם בקשות מקוריות של Chat Completions, Responses או Messages. פרמטרים, הזרמה, שימוש ומגבלות היכולות הנוכחיות.
השתמש ב-grok-4.7 באחד משלושת הפורמטים שלהלן. האימות משתמש במפתח ה-API שלך ב-SeedRouter. דף המודל כולל Playground ומחירי טוקנים עדכניים; מדריך המחירים מסביר קלט מהמטמון וחשיבה.
התחלה מהירה
curl https://api.seedrouter.ai/v1/responses \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.7","input":"What is 2 + 2?","reasoning":{"effort":"low"},"max_output_tokens":64,"store":false}'תגובת ה-JSON כוללת פריטי output ו-usage. כשאתה בונה את היסטוריית השיחה, שמור את כל פריטי הפלט, כולל פריטי חשיבה וכלים.
פורמטים של בקשות
| פורמט | נקודת קצה | שדות חובה |
|---|---|---|
| Responses | POST /v1/responses | model, input |
| Chat Completions | POST /v1/chat/completions | model, messages |
| Messages | POST /v1/messages | model, messages, max_tokens |
השתמש ב-Content-Type: application/json וב-Authorization: Bearer $SEEDROUTER_API_KEY. לקוחות Messages יכולים לשלוח גם anthropic-version: 2023-06-01.
פרמטרים ומגבלות
מפרט OpenAPI מכיל את הסכמות המקוננות המלאות של הבקשות והתגובות. הטבלאות הבאות מפרטות את כל שדות הבקשה הנתמכים ברמה העליונה. שדות לא מוכרים ופרמטרים שהמודל מתעלם מהם לפי ההגדרה הרשמית יושמטו. פרמטר נתמך עם ערך לא תקין נשאר לא תקין.
שדות אופציונליים שמאפשרים null מקבלים null מפורש; השמטת שדה משתמשת בברירת המחדל שלו ב-API. ה-Playground מסתיר את user ומקבע את model ל-grok-4.7. לקוחות API עדיין יכולים לשלוח user.
- הקשר: 500,000 טוקנים, כולל השיחה והפלט.
- רמת חשיבה:
low,medium,high,xhigh; ברירת המחדל היאhigh. - ברירת המחדל של
max_completion_tokensושלmax_output_tokensהיא 128,000 טוקני פלט גלויים. טוקני חשיבה וקריאות לפונקציות אינם נכללים במגבלת הפלט הגלוי הזו. זהו ערך ברירת מחדל, לא הצהרה על יכולת הפלט המרבית. - מגבלות הפלט חייבות להיות מספרים שלמים חיוביים. ה-API אוכף גם את תקרת הבטיחות הקיימת למספרים שלמים, 1,073,741,823; מגבלת קיבולת ההקשר עדיין חלה.
temperature: מ-0 עד 2, ברירת מחדל 1.top_p: גדול מ-0 ולכל היותר 1, ברירת מחדל 1. ב-Responses,min_p: מ-0 עד 1;top_k: מספר שלם של לפחות 1.- עד 350 הגדרות כלים.
stream_optionsדורשstream: true. - לא ניתן לשלב
instructionsעםprevious_response_id. סיכומי החשיבה תמיד מפורטים.
פרמטרים של Responses
| שדה | סוג | כלל |
|---|---|---|
include | מערך או null | מערך של שדות נוספים שיש לכלול בתגובה. |
input (חובה) | אובייקט או צורה חלופית נתמכת | מחרוזת טקסט או מערך מלא של פריטי קלט. |
instructions | מחרוזת או null | הוראות מערכת; לא ניתן לשלב עם previous_response_id. |
max_output_tokens | מספר שלם או null | מגבלת פלט גלוי; ברירת מחדל 128,000. |
max_turns | מספר שלם או null | מספר הסבבים המרבי של הסוכן, כמספר שלם. |
min_p | מספר או null | מספר מ-0 עד 1. |
model (חובה) | מחרוזת | קבוע ל-grok-4.7. |
parallel_tool_calls | ערך בוליאני או null | ערך בוליאני; ברירת מחדל true. |
previous_response_id | מחרוזת או null | מזהה תגובה כמחרוזת; המשך לפי מזהה אינו זמין כרגע. |
prompt_cache_key | מחרוזת או null | מפתח מטמון כמחרוזת. |
reasoning | אובייקט | הגדרות חשיבה; רמת ברירת המחדל היא high. |
reasoning_effort | מחרוזת או null | low, medium, high, xhigh; ברירת מחדל high. |
safety_identifier | מחרוזת או null | מזהה בטיחות אופציונלי שמספק הגורם הקורא. |
search_parameters | אובייקט | הגדרות חיפוש. |
service_tier | מחרוזת | auto, default, priority, fast; priority ו-fast מכפילים את תעריפי הטוקנים. |
store | ערך בוליאני או null | ערך בוליאני; ברירת מחדל true. פעולות על תגובות שמורות אינן זמינות כרגע. |
stream | ערך בוליאני או null | ערך בוליאני; ברירת מחדל false. |
temperature | מספר או null | מספר מ-0 עד 2; ברירת מחדל 1. |
text | אובייקט | הגדרות תגובת הטקסט, כולל format. |
tool_choice | אובייקט או צורה חלופית נתמכת | אוטומטי, מושבת, חובה או כלי נבחר; התחביר תלוי בפורמט. |
tools | מערך או null | הגדרות כלים; לכל היותר 350. |
top_k | מספר שלם או null | מספר שלם; Responses דורש לפחות 1. |
top_p | מספר או null | מספר גדול מ-0 ולכל היותר 1; ברירת מחדל 1. |
user | מחרוזת או null | מזהה אופציונלי שמספק הגורם הקורא; מוסתר ב-Playground. |
פרמטרים של Chat Completions
| שדה | סוג | כלל |
|---|---|---|
deferred | ערך בוליאני או null | ערך בוליאני; ברירת מחדל false. השלמה מושהית אינה זמינה כרגע. |
max_completion_tokens | מספר שלם או null | מגבלת פלט גלוי; ברירת מחדל 128,000. |
max_tokens | מספר שלם או null | מגבלה חיובית לפלט גלוי. חובה ב-Messages. |
messages (חובה) | מערך | הודעות השיחה בפורמט הזה. |
model (חובה) | מחרוזת | קבוע ל-grok-4.7. |
n | מספר שלם או null | מספר שלם של לפחות 1; ברירת מחדל 1. |
parallel_tool_calls | ערך בוליאני או null | ערך בוליאני; ברירת מחדל true. |
prompt_cache_key | מחרוזת או null | מפתח מטמון כמחרוזת. |
reasoning_effort | מחרוזת או null | low, medium, high, xhigh; ברירת מחדל high. |
response_format | אובייקט או צורה חלופית נתמכת | טקסט, אובייקט JSON או פלט לפי סכמת JSON. |
safety_identifier | מחרוזת או null | מזהה בטיחות אופציונלי שמספק הגורם הקורא. |
search_parameters | אובייקט | הגדרות חיפוש. |
seed | מספר שלם או null | ערך אתחול שלם לדגימה. |
service_tier | מחרוזת | auto, default, priority, fast; priority ו-fast מכפילים את תעריפי הטוקנים. |
stream | ערך בוליאני או null | ערך בוליאני; ברירת מחדל false. |
stream_options | אובייקט | אפשרויות הזרמה; דורש stream: true. |
temperature | מספר או null | מספר מ-0 עד 2; ברירת מחדל 1. |
tool_choice | אובייקט או צורה חלופית נתמכת | אוטומטי, מושבת, חובה או כלי נבחר; התחביר תלוי בפורמט. |
tools | מערך או null | הגדרות כלים; לכל היותר 350. |
top_p | מספר או null | מספר גדול מ-0 ולכל היותר 1; ברירת מחדל 1. |
user | מחרוזת או null | מזהה אופציונלי שמספק הגורם הקורא; מוסתר ב-Playground. |
web_search_options | אובייקט | אפשרויות חיפוש לתאימות. |
פרמטרים של Messages
| שדה | סוג | כלל |
|---|---|---|
max_tokens (חובה) | מספר שלם | מגבלה חיובית לפלט גלוי. חובה ב-Messages. |
messages (חובה) | מערך | הודעות השיחה בפורמט הזה. |
metadata | אובייקט | אובייקט המטא-נתונים של Messages. |
model (חובה) | מחרוזת | קבוע ל-grok-4.7. |
stop_sequences | מערך או null | מערך של מחרוזות עצירה. |
stream | ערך בוליאני או null | ערך בוליאני; ברירת מחדל false. |
system | אובייקט או צורה חלופית נתמכת | מחרוזת מערכת או בלוקי תוכן. |
temperature | מספר או null | מספר מ-0 עד 2; ברירת מחדל 1. |
tool_choice | אובייקט או צורה חלופית נתמכת | אוטומטי, מושבת, חובה או כלי נבחר; התחביר תלוי בפורמט. |
tools | מערך או null | הגדרות כלים; לכל היותר 350. |
top_k | מספר שלם או null | מספר שלם; Responses דורש לפחות 1. |
top_p | מספר או null | מספר גדול מ-0 ולכל היותר 1; ברירת מחדל 1. |
הזרמה
הגדר את stream ל-true. Chat שולח מקטעי השלמה; Responses שולח אירועי תגובה בעלי שם; Messages שולח אירועי הודעה ובלוקי תוכן. קרא את אירוע השימוש הסופי לצד תוספות הטקסט. קריאות לכלים וחשיבה עשויות להופיע כפריטי פלט נפרדים; בשמירת ההיסטוריה, אל תצמצם את הזרם לטקסט הגלוי בלבד.
{
"model": "grok-4.7",
"input": "Explain a mutex in one sentence.",
"reasoning": { "effort": "low" },
"max_output_tokens": 128,
"store": false,
"stream": true
}כלים ופלט מובנה
השתמש בהגדרת הכלי המתאימה לפורמט שבחרת. Chat משתמש ב-response_format; Responses משתמש ב-text.format. פונקציות, חיפוש ברשת, חיפוש ב-X, מפרש קוד וקריאות MCP נבדקו עם המודל הזה. Shell מחזיר קריאה לביצוע בצד הלקוח; הוא אינו מריץ פקודה במחשב שלך באופן אוטומטי. הסכמה המלאה מתארת גם סוגי כלים אחרים; עצם קיומו של פריט בסכמה אינו מוכיח ששירות חיצוני מסוים הוגדר.
{
"model": "grok-4.7",
"input": "Use the code interpreter once to compute 13*17. Return the number.",
"tools": [{ "type": "code_interpreter" }],
"tool_choice": "required",
"max_turns": 1,
"reasoning": { "effort": "low" },
"max_output_tokens": 32,
"store": false
}השימוש בכלים מחויב בנפרד מהטוקנים. חיפוש ברשת ומפרש קוד משתמשים במספר הקריאות. חיפוש ב-X משתמש במספר הפוסטים והפרופילים שאוחזרו, כולל פריטים שאוחזרו שוב; מספר קריאות החיפוש ב-X אינו יחידת החיוב שלו. בדוק את usage.server_side_tool_usage_details ואת רישומי השימוש בחשבון שלך.
שימוש ומחירים
המחירים תלויים באורך הקלט הכולל. מתחת ל-200,000 טוקני קלט, השתמש במדרגה הרגילה. ב-200,000 טוקנים ומעלה, השתמש במדרגת ההקשר הארוך לכל הבקשה; קלט מהמטמון נכלל בבחירת המדרגה. service_tier: "priority" ו-"fast" מכפילים את תעריפי הטוקנים בשתי המדרגות. auto ו-default בוחרים בשירות הרגיל. חיובי הכלים מחושבים בנפרד ואינם מוכפלים על ידי מכפיל הטוקנים הזה.
| פורמט | חישוב הקלט | חישוב הפלט |
|---|---|---|
| Responses | input_tokens כולל את input_tokens_details.cached_tokens | output_tokens כולל חשיבה; אל תוסיף שוב את פירוט החשיבה |
| Chat | prompt_tokens כולל את prompt_tokens_details.cached_tokens | xAI מדווח על completion_tokens הגלויים בנפרד; סך הפלט לחיוב הוא total_tokens - prompt_tokens, כולל חשיבה |
| Messages | input_tokens אינו כולל את cache_read_input_tokens; הוסף את שדות המטמון כדי לקבל את סך הקלט | output_tokens הוא סך הפלט |
תגובות ציבוריות כוללות מוני שימוש, לא שדות של עלות כספית. רישומי השימוש מציגים את החיוב הסופי. בקשות שנכשלו אינן מחויבות.
היסטוריית שיחה ומגבלות נוכחיות
כדי להמשיך ללא שמירת מצב, שלח את הקלט הקודם, כל פריטי הפלט שהוחזרו והודעת המשתמש הבאה בתור input חדש. ב-Chat או Messages, שלח את היסטוריית ההודעות המלאה בפורמט המתאים. שמור ללא שינוי פריטי חשיבה מוצפנים ופריטי כלים, כאשר הם מוחזרים.
השירות הנוכחי אינו יכול להמשיך באמצעות previous_response_id, לאחזר או למחוק תגובה שמורה, להציג רשימת פריטי קלט שמורים או להחזיר השלמות Chat מושהות. store: true עשוי להתקבל בזמן היצירה, אך אין בכך הוכחה לתמיכה בשמירה או באחזור של תגובות. שדות אלה נשארים בחוזה הרשמי וב-Playground; המגבלה אינה מחליפה את הגדרת ההתנהגות המקורית שלהם.
קבצים מצורפים לא פעלו עם קלט הטקסט המוטמע וכתובות ה-URL של PDF שנבדקו. בקשות ליצירת תמונות החזירו טקסט ללא תמונות, וחיפוש הכלים לא השלים גילוי בצד השרת. יכולות אלה לא אומתו כזמינות. חיפוש Collections דורש גם משאב collection תקין ולא אומת.
Chat מתעלם מ-frequency_penalty, presence_penalty, logit_bias, stop, logprobs ו-top_logprobs. Responses מתעלם מ-background, context_management, metadata, truncation, logprobs ו-top_logprobs. הם אינם מועברים ואינם מוצעים כבקרות פעילות.
שגיאות
בקשה לא תקינה מחזירה שגיאה במקום תשובה שהושלמה. בדוק את ערכי השדות ואת מדריך השגיאות הציבורי. בקשות שמחזירות שגיאה אינן מחויבות.