MiniMax H3

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

⁦MiniMax H3 (Hailuo 03)⁩ הוא מודל הווידאו המולטימודלי של MiniMax. בקשה אחת יוצרת את התמונה ואת הסאונד יחד: קליפ של 4–15 שניות ב-768P או ב-2K עם דיאלוג, סאונד סביבה ואפקטים משלו. גוף הבקשה הוא הפורמט הרשמי של MiniMax עם מזהה המודל minimax-h3. שלח את הבקשה, שמור את מזהה המשימה שהוחזר, וקרא את הווידאו המוכן מתוך המשימה. פריימים וייחוסים נשלחים ככתובות URL.

מזהי מודל

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

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

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "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`
`content`	array	חובה	הפרומפט וכל מדיה, כפריטים שמתוארים למטה. בדיוק פריט `text` אחד שאינו ריק.
`resolution`	enum	חובה	`768P` או `2K`.
`duration`	integer	חובה	כל מספר שלם בין 4 ל-15 שניות.
`ratio`	enum	לפי הקלט	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. חובה בטקסט בלבד, ושם `adaptive` לא מתקבל.
`content_filter`	boolean	`true`	מסנן התוכן של SeedRouter, שמתואר למטה. לא נשלח למודל.

הסכמה מחמירה: שדות לא מוכרים נדחים ולא מתעלמים מהם. callback_url אינו זמין; תשאל את המשימה במקום זאת. extra שייך ל-MiniMax-H3-Max ואינו מתקבל במודל הזה.

פריטי 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 קובעים את המצב; אין שדה מצב.

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

אי אפשר לשלב פריימים וייחוסים באותה בקשה.

{
  "model": "minimax-h3",
  "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": "2K",
  "duration": 6
}

קלטי מדיה

כל פריט תמונה, וידאו ואודיו הוא כתובת URL ציבורית ב-⁦HTTP(S)⁩. כתובות data של 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 מחויב לפי שנייה של וידאו, בתעריף שנקבע לפי רזולוציית הפלט, ועוד תמונות קלט מעבר לחמש הראשונות:

billed seconds = duration + ceil(Σ each reference video's seconds)
extra images   = max(0, number of images − 5)
cost = billed seconds × rate per second + extra images × rate per image

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

מבנה הפלט

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

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

קבלת המשימה

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

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

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

{
  "id": "task_...",
  "model": "minimax-h3",
  "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. בבדיקה שלנו, קליפ של 4 שניות ב-768P ב-16:9 חזר כ-⁦MP4 (H.264)⁩ ב-⁦1344 × 768⁩ וב-24 fps, עם רצועת AAC סטריאו ב-32 kHz.

שגיאות

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

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

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

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

טיפים

תאר את השוט ואת הסאונד שלו יחד: נושא, מקום, מצלמה, תאורה, דיאלוג ואפקטים.
כתוב את הדיאלוג בתוך הפרומפט וצרף קטע אודיו לייחוס כשהקול צריך לעקוב אחריו.
הכן טיוטה ב-768P, ואז רנדר את השוט הסופי ב-2K עם אותה בקשה.
השתמש בפריים ראשון ובפריים אחרון כדי לשלוט באיפה השוט מתחיל ונגמר; השתמש בייחוסים כדי לשמור על מוצר, אדם או תנועה.
הוסף no text, no logos כדי למנוע סימנים מומצאים.