MiniMax M3.1 Flash

יש להשתמש במזהה המודל המדויק ⁦MiniMax-M3.1-Flash⁩. דף המודל כולל את ה-⁦Playground⁩ ואת המחירים העדכניים. מפרט ⁦OpenAPI⁩ מגדיר את השדות המקוננים בבקשות ובתגובות.

התחלה מהירה

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

בדוגמה זו מוגדרת מגבלת פלט; זו אינה ברירת המחדל של המודל. יש לשמור מפתחות בשרת שלכם. ה-⁦Playground⁩ משתמש בחשבון שאליו התחברתם, ואין צורך להדביק מפתח ⁦API⁩.

פורמטים ואימות

יש לשלוח ⁦Content-Type: application/json⁩ ו-⁦Authorization: Bearer $SEEDROUTER_API_KEY⁩. ⁦Messages⁩ מקבל גם ⁦x-api-key⁩; לקוחות ⁦SDK⁩ יכולים לכלול ⁦anthropic-version: 2023-06-01⁩. הפורמטים שומרים על גוף הבקשה ומבנה התגובה המקוריים שלהם.

פרמטרים

כל השדות הם אופציונליים, למעט שדות החובה שלעיל. השמטת שדה שונה משליחה מפורשת של ⁦null⁩: שדה מקבל ⁦null⁩ רק אם הדבר הוצהר במפרט ⁦OpenAPI⁩. שדות לא נתמכים ברמה העליונה מושמטים; ערכים לא תקינים בשדות נתמכים מחזירים שגיאה.

⁦Chat Completions⁩

⁦Messages⁩

⁦Responses⁩

ב-⁦Playground⁩ הערך של ⁦model⁩ קבוע, וכל יתר השדות זמינים: ⁦12⁩ פקדים ל-⁦Chat, 11⁩ ל-⁦Messages⁩ ו-⁦12⁩ ל-⁦Responses⁩. אובייקטים מקוננים והיסטוריית שיחה מלאה מוזנים בשדות ⁦JSON⁩. ערכים לא תקינים בשדות נתמכים חוסמים את השליחה בדפדפן.

הסקה ומגבלות

חלון ההקשר המתועד הוא ⁦1,000,000⁩ טוקנים. מגבלת הפלט היא ⁦524,288⁩ טוקנים, כולל הסקה. ⁦MiniMax⁩ ממליצה על ⁦131,072⁩ טוקני פלט למשימות מורכבות, אך אינה מגדירה ערך זה כברירת מחדל.

מצב החשיבה פעיל תמיד. המודל אינו תומך ב-⁦disabled⁩, ב-⁦none⁩ וב-⁦minimal⁩ כהגדרות חשיבה. תקציב פלט קטן עלול להיגמר לפני שמופיע טקסט התשובה. חוזה ⁦API⁩ זה אינו תומך ב-⁦service_tier⁩, בקלט אודיו ובפלט ⁦JSON⁩ מובנה.

גוף הבקשה המלא לא יכול לחרוג מ-⁦64 MB⁩. שירות המודל בודק את השימוש המדויק בהקשר ואת התוכן של מדיה מרוחקת.

תמונות ווידאו

⁦Chat⁩ משתמש בבלוקי התוכן ⁦image_url: {"url":"..."}⁩ ו-⁦video_url: {"url":"..."}⁩. ⁦Messages⁩ משתמש בבלוקי תמונה/וידאו עם אובייקט ⁦source⁩: ⁦{"type":"url","url":"..."}⁩ או ⁦{"type":"base64","media_type":"...","data":"..."}⁩. ⁦Responses⁩ משתמש ב-⁦input_image⁩ או ב-⁦input_video⁩, שערך ה-⁦URL⁩ שלהם יכול להיות מחרוזת או אובייקט אפשרויות נתמך.

⁦detail⁩ מקבל את ⁦low⁩, ⁦default⁩ ו-⁦high⁩, וברירת המחדל היא ⁦default⁩. ערך ⁦fps⁩ של וידאו נע בין ⁦0.2⁩ ל-⁦5⁩, וברירת המחדל היא ⁦1⁩. השדה האופציונלי ⁦max_long_side_pixel⁩ חייב להיות מספר שלם חיובי כאשר הוא זמין בסכמה המקוננת.

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

יש להחליף את כתובת ה-⁦URL⁩ לדוגמה בכתובת של קובץ נגיש משלכם. קלט מוטמע משתמש בסוג ⁦MIME⁩ מתאים של ⁦base64⁩; עבור ⁦MOV⁩ יש להשתמש ב-⁦video/mov⁩. הפניות וידאו קיימות מסוג ⁦mm_file://⁩ מועברות ללא שינוי, אך השירות אינו מספק ⁦API⁩ להעלאת קבצים דרך ⁦Files⁩. ההפניה עדיין צריכה להיות נגישה לחשבון שמעבד את הבקשה.

כלים והיסטוריית שיחה

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

בהמשך שיחת ⁦Chat⁩ יש לשמור את הודעת ⁦assistant⁩ המלאה, כולל ⁦reasoning_content⁩ ו-⁦tool_calls⁩; הודעות כלי דורשות ⁦tool_call_id⁩. ב-⁦Messages⁩ יש לשמור בלוקי חשיבה, חתימות ובלוקי ⁦tool_use⁩ ו-⁦tool_result⁩. ב-⁦Responses⁩ יש לצרף את כל פריטי הפלט שהוחזרו לפני קלט המשתמש הבא.

אין לצמצם את ההיסטוריות האלה לטקסט התשובות בלבד. סכמות פרמטרים שרירותיות של פונקציות ושדות הסקה המועברים בחזרה נשמרים. התיעוד הרשמי של ⁦Chat⁩ אינו מגדיר פרמטר ⁦tool_choice⁩ למודל זה.

סטרימינג ושדות תגובה

יש להגדיר ⁦stream: true⁩ כדי לקבל אירועים שנשלחים מהשרת. ⁦Chat⁩ שולח ⁦choices[].delta⁩ ומסתיים ב-⁦[DONE]⁩; יש לבקש ⁦stream_options: {"include_usage":true}⁩ כדי לקבל נתוני שימוש. ⁦Messages⁩ שולח אירועים בעלי שם, כגון ⁦message_start⁩, עדכוני בלוקי תוכן ו-⁦message_stop⁩. ⁦Responses⁩ שולח אירועים כגון ⁦response.output_text.delta⁩ ו-⁦response.completed⁩.

ללא סטרימינג, ⁦Chat⁩ מחזיר ⁦choices[].message⁩, ⁦finish_reason⁩ ו-⁦usage⁩. ⁦Messages⁩ מחזיר בלוקי תוכן, ⁦stop_reason⁩ ונתוני שימוש. ⁦Responses⁩ מחזיר פריטי ⁦output⁩, סטטוס ונתוני שימוש. יש לשמור את התגובה המלאה אם היישום זקוק למידע נוסף מעבר לתשובה המוצגת.

שימוש ומחירים עדכניים

טבלת המחירים העדכניים מציגה את שתי מדרגות הקלט. קלט כולל של עד ⁦512,000⁩ טוקנים נכלל במדרגה הראשונה; מעל ⁦512,000⁩ חלה המדרגה השנייה. המדרגה שנבחרה קובעת את מחיר הבקשה כולה, כולל הפלט והמטמון.

טוקנים של קריאה מהמטמון וכתיבה למטמון אינם מחויבים שוב כקלט רגיל. המטמון האוטומטי בודק קידומות חוזרות מתאימות באורך של לפחות ⁦512⁩ טוקנים; לא מובטח שימוש חוזר במטמון. אין צורך בסמן מטמון מפורש.

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

שגיאות

במקרה של שגיאה, יש לבדוק את השדה הלא תקין ואת תיעוד השגיאות הציבורי. אותו מזהה מודל תומך בשלוש נקודות הקצה לטקסט שלעיל; הוא אינו מיועד לנקודת קצה של ⁦embeddings⁩ או ⁦Gemini⁩.

מקורות רשמיים

• הפעלת מודלי ⁦MiniMax⁩
• תיעוד ⁦Chat Completions⁩
• תיעוד ⁦Messages⁩
• תיעוד ⁦Responses⁩
• המשך לאחר קריאה לפונקציה
• שמירה אוטומטית של פרומפטים במטמון