Muse Video

⁦Muse Video⁩ هو نموذج الفيديو من ⁦Meta Superintelligence Labs⁩. ينتج الطلب الواحد مقطعًا مدته نحو 10 ثوانٍ بدقة 720p مع صوت، من موجّه أو من موجّه مع ما يصل إلى 9 صور مرجعية، بإحدى سبع نسب للعرض إلى الارتفاع. أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، واقرأ الفيديو المكتمل من المهمة. تُرسل الصور المرجعية كروابط URL.

معرّفات النماذج

راجع صفحة النموذج للاطلاع على الأسعار الحالية.

مثال سريع

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

الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الفيديو المكتمل. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح API في شفرة تعمل على الخادم.

المعاملات

تُحذف الحقول غير المدرجة في هذه القائمة قبل تمرير الطلب؛ ولا تسبّب خطأ مطلقًا ولا تغيّر المخرجات. لا توجد إعدادات للإطار الأول أو الأخير أو الفيديو المرجعي أو الصوت المرجعي أو التمديد أو البذرة أو الموجّه السلبي. و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، ثم مرّر رابطها هنا لتحريكها.
• للفيديو العمودي، أرسل aspect_ratio: "9:16" أو صورة مرجعية عمودية.
• أضف no text لإبعاد التعليقات النصية المختلقة.

مواضيع ذات صلة

• Playground وأسعار Muse Video
• مرجع Muse Image API
• تنزيل OpenAPI
• Markdown قابل للنسخ