Claude Opus 5.5 כבר זמין ב-SeedRouter

Video

MiniMax H3

View Markdown

יצירת קליפים של 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.

שדהסוגחובה / ברירת מחדלערכים
modelstringחובהminimax-h3-standard
promptstringחובהלא ריק; חובה בכל מצב
qualitystringחובהlow, high; אותו מחיר
duration_snumber55–15, כולל שברים עשרוניים
resolutionstring768p480p, 768p, 1080p, 2k, 4k
aspect_ratiostring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9
seedintegerאקראי0–9223372036854775807
watermarkbooleanfalsetrue / false
enhancebooleantrueניסוח מחדש של הפרומפט; false שומר על הפרומפט
priorityinteger10001000 / 0
content_filterbooleantrueבדיקת תוכן של SeedRouter לפני היצירה; false מדלג על הבדיקה
first_frame_image_urlstringאופציונליכתובת URL של תמונה אחת
last_frame_image_urlstringאופציונלינדרש פריים ראשון
reference_image_urlstring[]אופציונלי1–4 כתובות URL של תמונות
reference_video_urlstring[]אופציונליכתובת 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, 2K4–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
כותרתערך
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

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

פרמטרים

שדהסוגברירת מחדלהערות
modelstringחובהminimax-h3
contentarrayחובההפרומפט וכל מדיה, כפריטים שמתוארים למטה. בדיוק פריט text אחד שאינו ריק.
resolutionenumחובה768P או 2K.
durationintegerחובהכל מספר שלם בין 4 ל-15 שניות.
ratioenumלפי הקלטadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. חובה בטקסט בלבד, ושם adaptive לא מתקבל.
content_filterbooleantrueמסנן התוכן של 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 כדי למנוע סימנים מומצאים.

קישורים רלוונטיים