Video
MiniMax H3
יצירת קליפים של 4–15 שניות עם סאונד ב-768P או ב-2K בעזרת MiniMax H3: מטקסט לווידאו, פריים ראשון ואחרון ומייחוס לווידאו, בפורמט הבקשה הרשמי של MiniMax, עם מסירה כמשימה.
Standard ו-Pro
שני הערוצים תומכים ב-content_filter. ברירת המחדל היא true, והתוכן נבדק לפני היצירה. ב-Playground הוא נשאר פעיל; משתמשי API יכולים להגדיר false. ייתכן שהגבלות התוכן של הספק עדיין יחולו.
minimax-h3 הוא Pro ושומר על פורמט הבקשה וההתנהגות הקיימים. הסעיפים על הפורמט המקורי למטה מתארים את Pro. Standard משתמש ב-minimax-h3-standard עם גוף JSON שטוח משלו באותה נקודת קצה /v1/videos/generations. זו אינה גרסת Max או Turbo. אין מעבר אוטומטי בין שתי האפשרויות במקרה של כשל.
{
"model": "minimax-h3-standard",
"prompt": "A sailboat crosses a quiet bay, with soft wind and waves.",
"quality": "high",
"content_filter": true,
"duration_s": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}Standard מקבל רק את השדות הבאים. כתובות ה-URL חייבות להיות כתובות HTTP(S) ציבוריות ללא פרטי הזדהות; אין תמיכה בהעלאת קבצים ישירה או ב-base64.
| שדה | סוג | חובה / ברירת מחדל | ערכים |
|---|---|---|---|
model | string | חובה | minimax-h3-standard |
prompt | string | חובה | לא ריק; חובה בכל מצב |
quality | string | חובה | low, high; אותו מחיר |
duration_s | number | 5 | 5–15, כולל שברים עשרוניים |
resolution | string | 768p | 480p, 768p, 1080p, 2k, 4k |
aspect_ratio | string | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
seed | integer | אקראי | 0–9223372036854775807 |
watermark | boolean | false | true / false |
enhance | boolean | true | ניסוח מחדש של הפרומפט; false שומר על הפרומפט |
priority | integer | 1000 | 1000 / 0 |
content_filter | boolean | true | בדיקת תוכן של SeedRouter לפני היצירה; false מדלג על הבדיקה |
first_frame_image_url | string | אופציונלי | כתובת URL של תמונה אחת |
last_frame_image_url | string | אופציונלי | נדרש פריים ראשון |
reference_image_url | string[] | אופציונלי | 1–4 כתובות URL של תמונות |
reference_video_url | string[] | אופציונלי | כתובת URL של סרטון אחד |
אי אפשר לשלב פריים ראשון או אחרון עם ייחוסים. ללא מדיה, הווידאו נוצר מטקסט. אפשר לשלב תמונות ייחוס וסרטון ייחוס אחד. אין תמיכה באודיו ייחוס עצמאי. כל פלט כולל אודיו מובנה. Low נותן עדיפות למהירות ו-High לנאמנות למקור, ללא טענה שאיכות אחת האפשרויות זהה לזו של Pro.
תמונות: עד 30 MiB כל אחת; JPEG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF או AVIF. אין מגבלה על ממדי התמונה; תמונות גדולות עשויות לעבור שינוי גודל לפני היצירה. סרטונים: עד 100 MiB, באורך 0.5–600 שניות, עם זרם וידאו שניתן לקריאה (כולל MP4, MOV ו-WebM), רוחב וגובה זוגיים של לפחות 64 פיקסלים כל אחד.
החיוב ב-Standard הוא ceil(duration_s) × התעריף הנוכחי לרזולוציה. מדיית ייחוס, אודיו, איכות וניסוח מחדש של הפרומפט אינם כרוכים בתוספת תשלום. משימות שנכשלו אינן מחויבות. המחירים מגיעים מסעיף התמחור העדכני.
היצירה ובדיקות הסטטוס משתמשות בפרוטוקול האסינכרוני המשותף שמופיע למטה. פלט מוצלח מכיל video_url, resolution, ratio ו-duration; הערך duration משקף את משך הזמן המבוקש. עלויות, מזהי ספקים וכתובות URL של ספקים אינם מוחזרים. אם תוצאת השליחה אינה ידועה, אין לנסות שוב אוטומטית. לערכי זרע מעל מגבלת המספרים השלמים הבטוחים ב-JavaScript, יש לסריאל את המספר ללא אובדן דיוק; אין לעגל אותו דרך Number.
תיעוד Pro
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כדי למנוע סימנים מומצאים.
