MiniMax H3 Max

צור קליפים של 5–15 שניות עם סאונד ב-480P או ב-768P עם MiniMax H3 Max: מטקסט, מפריים ראשון ואחרון או מחומרי ייחוס, בפורמט הבקשה הרשמי של MiniMax, עם מסירה כמשימה.

MiniMax H3 Max הוא גרסת היצירה המהירה של MiniMax H3. בקשה אחת יוצרת תמונה וסאונד יחד: קליפ של 5–15 שניות ב-480P או ב-768P עם דיאלוג, צלילי סביבה ואפקטים. גוף הבקשה משתמש בפורמט הרשמי של MiniMax עם מזהה המודל minimax-h3-max. שלח אותו, שמור את מזהה המשימה שהוחזר וקבל את הווידאו המוכן מתוך המשימה. פריימים וייחוסים נשלחים ככתובות URL.

מזהי מודל

מזהה מודל	קלטים	רזולוציות	אורך
`minimax-h3-max`	טקסט, פריים ראשון ואחרון, תמונות, סרטונים ואודיו לייחוס	480P, 768P	5–15 שניות

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

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "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

כותרת	ערך
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

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

פרמטרים

שדה	סוג	ברירת מחדל	הערות
`model`	string	חובה	`minimax-h3-max`
`content`	array	חובה	הפרומפט והמדיה כפריטים המתוארים בהמשך. נדרש בדיוק פריט `text` אחד שאינו ריק.
`resolution`	enum	חובה	`480P` או `768P`.
`duration`	integer	חובה	כל מספר שלם בין 5 ל-15 שניות.
`ratio`	enum	לפי הקלט	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. חובה בטקסט בלבד, ושם `adaptive` אינו מתקבל.
`extra`	object	מושמט	הגדרות הרחבת פרומפט אופציונליות.
`extra.prompt_expansion_mode`	enum	`balanced`	`disabled`, `balanced` או `quality`. השמטת האובייקט או המאפיין שומרת על ברירת המחדל של המודל.
`content_filter`	boolean	`true`	מסנן התוכן של SeedRouter, כמתואר בהמשך. אינו נשלח למודל.

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

פריטי content

`type`	פריט	`role`
`text`	`{"type": "text", "text": "..."}`, עד 7,000 תווים	ללא
`image_url`	`{"type": "image_url", "image_url": {"url": "https://..."}, "role": "..."}`	`first_frame`, `last_frame` או `reference_image`
`video_url`	`{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}`	`reference_video`
`audio_url`	`{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}`	`reference_audio`

תמונה יחידה ללא role היא הפריים הראשון. אם יש יותר מתמונה אחת, לכל תמונה נדרש role.

מצבים

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

מצב	מה מכיל `content`	`ratio`
מטקסט לווידאו	פריט `text` אחד	חובה, לא `adaptive`
מתמונה לווידאו	`text` עם תמונת `first_frame` ו/או `last_frame`	כל ערך נחשב ל-`adaptive`: התמונה קובעת את הצורה
מייחוס לווידאו	`text` עם כל שילוב של עד 9 פריטי `reference_image`, 3 פריטי `reference_video` ו-3 פריטי `reference_audio`	אופציונלי, ברירת המחדל `adaptive`

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

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

קלטי מדיה

כל פריט תמונה, וידאו ואודיו הוא כתובת HTTP(S) ציבורית. כתובות data URI ב-Base64 ומזהי mm_file:// אינם מתקבלים: העלה את הקובץ לאחסון שלך והעבר את הכתובת שלו.

קלט	פורמט	מגבלות
תמונה	JPG, JPEG, PNG, WebP, HEIC, HEIF	עד 30 MB; כל צלע 256–5760 px; רוחב / גובה 0.4–2.5
וידאו	MP4, MOV (H.264 או H.265)	עד 50 MB; כל אחד 2–15 שניות, עד 15 שניות בסך הכול; כל צלע 256–5760 px; רוחב / גובה 0.4–2.5; קצב 23.976–60 fps
אודיו	WAV, MP3	עד 15 MB; כל אחד 2–15 שניות, עד 15 שניות בסך הכול

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

מסנן תוכן

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

ממדי תמחור

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

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

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

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

סכמת פלט

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

{"id": "task_...", "model": "minimax-h3-max", "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",
  "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",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

טיפים

תאר את השוט ואת הסאונד יחד: נושא, מקום, מצלמה, תאורה, דיאלוג ואפקטים.
כתוב דיאלוג בפרומפט וצרף אודיו ייחוס כשהקול צריך לעקוב אחריו.
צור טיוטה ב-480P, ובחר 768P כשדרושים פרטים נוספים. יצירה חדשה היא בקשה נפרדת בתשלום.
השתמש ב-extra: {"prompt_expansion_mode": "disabled"} לפרומפט שכבר הושלם, או בחר הרחבה במצב balanced / quality.
השתמש בפריים ראשון ואחרון לשליטה בתחילת השוט ובסופו; השתמש בייחוסים לשמירת מאפייני מוצר, אדם או תנועה.
הוסף no text, no logos כדי להימנע מסימנים מומצאים.

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

מקורות החוזה

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

On this page