Muse Video

צור קליפים של Muse Video באורך 10 שניות ב-720p עם סאונד מפרומפט או מעד 9 תמונות ייחוס, בשבעה יחסי גובה-רוחב, בתשלום לקליפ ובמסירה כמשימה.

⁦Muse Video⁩ הוא מודל הווידאו של ⁦Meta Superintelligence Labs⁩. בקשה אחת יוצרת קליפ של כ-10 שניות ב-720p עם סאונד, מפרומפט או מפרומפט ועד 9 תמונות ייחוס, באחד משבעה יחסי גובה-רוחב. שלח את הבקשה, שמור את מזהה המשימה שחוזר, וקרא את הווידאו המוכן מתוך המשימה. תמונות הייחוס נשלחות ככתובות URL.

מזהי מודל

מזהה מודל	קלטים	רזולוציה	אורך
`muse-video`	טקסט, 0–9 תמונות	`720p`	כ-10 שניות, עם סאונד

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

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_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`	מחרוזת	חובה	`muse-video`
`prompt`	מחרוזת	חובה	אסור שיהיה ריק אחרי הסרת רווחים מהקצוות. חובה גם עם תמונות ייחוס.
`image_urls`	רשימת כתובות URL	אין	0–9 כתובות ציבוריות לתמונות, בגודל כולל של 11 MB. בלעדיהן, הבקשה היא מטקסט לווידאו.
`aspect_ratio`	ערך מרשימה	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` או `2:3`. השמט לבחירה אוטומטית: תמונות הייחוס קובעות את הצורה; טקסט בלבד נותן `16:9`. אל תשלח `"auto"`.
`size`	ערך מרשימה	אין	כינוי תאימות של `aspect_ratio`: אחד היחסים שלעיל, או `auto`. כששניהם תקינים, `aspect_ratio` מקבל עדיפות.
`duration`	מספר שלם או מחרוזת	`10`	רק `10`, `"10"` או `"10s"`. אורך הקליפ הוא כ-10 שניות.
`resolution`	ערך מרשימה	`720p`	רק `720p`.
`audio`	ערך בוליאני	`true`	רק `true`; בכל קליפ יש סאונד. `false` נדחה.
`n`	מספר שלם	`1`	רק `1`. כל בקשה מחזירה קליפ אחד.

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

תמונות ייחוס

העבר עד 9 תמונות ב-image_urls ותאר את התנועה ב-prompt. ⁦Muse Video⁩ משתמש בהן כתמונות ייחוס: הקליפ נשאר קרוב אליהן, אבל הפריים הראשון אינו העתק זהה ברמת הפיקסל. כשמשמיטים את aspect_ratio, הקליפ מקבל את הצורה שלהן.

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

קלטי מדיה

כל תמונת ייחוס היא כתובת ⁦HTTP(S)⁩ ציבורית. כתובות data URI ב-base64 אינן מתקבלות: העלה את הקובץ לאחסון שלך והעבר את הכתובת שלו. השתמש בתמונות PNG, JPEG או WebP; הגודל הכולל של הקבצים המקוריים בכל תמונות הייחוס חייב להיות 11 MB לכל היותר. קבוצת תמונות שחורגת מהמגבלה נכשלת אחרי שהתקבלה ואינה מחויבת.

גורמי עלות

בדוק את מדור המחירים של המודל לתעריפים הנוכחיים. ל-⁦Muse Video⁩ יש מחיר אחד לקליפ:

cost = price per clip × 1

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

מבנה הפלט

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

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

קבלת המשימה

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

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

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

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

בבדיקות שלנו, הקליפים חזרו כקובצי ⁦MP4 (H.264)⁩ באורך 10.0 שניות עם רצועת אודיו AAC: ב-⁦1280 × 720⁩ עבור 16:9, ב-⁦720 × 1280⁩ עבור 9:16, וב-⁦1248 × 704⁩ עבור תמונת ייחוס בצורת ⁦16:9⁩, כ-100–200 שניות מהשליחה.

שגיאות

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

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

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

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

טיפים

תאר נושא, פעולה, תנועת מצלמה ותאורה, וציין את הצלילים שאתה רוצה; האודיו נוצר יחד עם התמונה.
צור תמונה דוממת עם Muse Image, ואז העבר לכאן את כתובת ה-URL שלה כדי להנפיש אותה.
לווידאו אנכי, שלח aspect_ratio: "9:16" או תמונת ייחוס אנכית.
הוסף no text כדי למנוע כיתובים מומצאים.