MiniMax H3 Max Turbo

MiniMax H3 Max Turbo יוצר סרטונים קצרים מטקסט או מתמונות פריימים. השתמש במזהה המודל minimax-h3-max-turbo, שמור את מזהה המשימה שהוחזר ובדוק את המשימה עד שהווידאו מוכן. דף זה מתאר את ממשק מערך ה-content המקורי שמוצע ב-SeedRouter.

מזהי מודל

ראה את דף המודל למחירים הנוכחיים.

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

נקודת קצה

POST https://api.seedrouter.ai/v1/videos/generations

התשובה היא משימה ({"id": "task_...", "status": "processing"}), לא הווידאו המוכן. תשאל את GET /v1/tasks/{task_id} לקבלת התוצאה. שמור מפתחות API בקוד בצד השרת.

פרמטרים

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

פריטי content

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

מצבים

הפריטים ב-content קובעים את המצב; לא שולחים שדה mode.

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

תמונות פריימים

השתמש בכתובות HTTP(S) ציבוריות ללא פרטי התחברות משובצים. Base64 ומזהי mm_file:// אינם מתקבלים. התמונות יכולות להיות JPG, JPEG, PNG, WebP, HEIC או HEIF, עד 30 MB לכל תמונה, כל צלע 256–5760 פיקסלים ויחס רוחב/גובה בין 0.4 ל-2.5. הקלט נבדק לפני היצירה. לשני פריימים השתמש בקומפוזיציות וביחסי גובה-רוחב תואמים.

מסנן תוכן

content_filter הוא true אם לא הוגדר אחרת. כשהמסנן פועל, הבקשה, כולל הטקסט והמדיה, נבדקת לפני היצירה. בקשה שסומנה כבעייתית נכשלת עם קוד 60001 ואינה מחויבת. הגדר content_filter כ-false כדי לדלג על הבדיקה; ב-Playground באתר הוא תמיד פועל.

ממדי תמחור

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

cost = reported output seconds × output-second rate for the resolution

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

סכמת פלט

השליחה מחזירה את המשימה:

{"id": "task_...", "model": "minimax-h3-max-turbo", "status": "processing", "created_at": 1789689600}

קבלת המשימה

GET https://api.seedrouter.ai/v1/tasks/{task_id}

בדוק בכל 10–20 שניות עד ש-status הוא completed או failed. פסק זמן ברשת בזמן התשאול אינו אומר שהיצירה נכשלה: שמור את מזהה המשימה וחזור לבדוק אותה. אל תיצור משימה נוספת כדי לבדוק התקדמות.

משימה שהושלמה

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio הוא יחס הגובה-רוחב שבו נוצר הקליפ, כולל היחס שנבחר עבור adaptive. המשימה מכילה רזולוציה, יחס ומשך בפועל כשאלה מדווחים. ה-JSON לעיל מדגים את מבנה התשובה; הוא אינו תוצאת יצירה שנמדדה.

שגיאות

בקשות שנדחו לפני יצירת משימה מחזירות שגיאת HTTP עם אובייקט error ואינן מחויבות. משימה שנכשלת אחרי קבלה מחזירה HTTP 200 כשבודקים אותה, עם status: "failed" ואובייקט error.

ראה קטלוג שגיאות משותף לקודים, לסטטוסים של HTTP ולהנחיות לניסיון חוזר.

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

טיפים

• תאר בכל שוט נושא, פעולה, תנועת מצלמה ומערך תאורה אחד.
• השתמש ב-480P לטיוטה וב-768P לפרטים נוספים בפלט. כל יצירה חדשה היא בקשה נפרדת בתשלום.
• ספק פריים ראשון כדי לקבוע את קומפוזיציית הפתיחה; הוסף פריים אחרון רק כשאתה מספק גם את הראשון.
• השתמש ב-extra.prompt_expansion_mode לבחירת disabled, balanced או quality; השמטה שומרת על balanced.
• בדוק את כל הקליפ ואת האודיו לפני פרסום. פרומפט אינו מבטיח גאומטריית מוצר או כיתוב מדויקים.

קישורים קשורים

• Playground ומחירים של MiniMax H3 Max Turbo
• הורדת OpenAPI
• Markdown להעתקה

היקף החוזה

הממשק משתמש בפורמט הבקשה של מערך content מבית MiniMax, עם מזהי מודל של SeedRouter, משימות אסינכרוניות, תמונות ככתובות URL בלבד ומסירת תוצאה מאוחסנת. התראות callback וביטול אינם זמינים. content_filter הוא בדיקת קלט של SeedRouter, לא פרמטר של MiniMax.

לממשק הנפרד שמאוחסן ב-fal יש שדות ומגבלות שונים; הגדרות 1080P, משכי זמן לא שלמים, אודיו יעד וייחוסים מסודרים שלו אינן חלות כאן. הממשק הזה אינו מקבל הגדרות seed או סימן מים. ראה את מדריך ההשוואה להבדלים ולקישורי מקורות.