MiniMax H3 Max Turbo

ولّد فيديو 5–15 ثانية بدقة 480P أو 768P من نص أو الإطار الأول والأخير. حقول الطلب وحدود الصور وأسعار ثواني المخرجات والاستعلام عن المهام.

يولّد MiniMax H3 Max Turbo فيديوهات قصيرة من النص أو صور الإطارات. استخدم معرّف النموذج minimax-h3-max-turbo واحتفظ بمعرّف المهمة المُعاد، واستعلم للحصول على الفيديو المكتمل. تصف هذه الصفحة الواجهة الأصلية بمصفوفة content المتاحة على SeedRouter.

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

معرّف النموذج	المدخلات	الدقات	المدة
`minimax-h3-max-turbo`	نص، وإطار أول، وإطار أخير اختياري	480P، 768P	5–15 ثانية

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

مثال سريع

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "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-max-turbo`
`content`	array	مطلوب	الموجّه وأي وسائط على هيئة العناصر الموضحة أدناه. عنصر `text` واحد غير فارغ بالضبط.
`resolution`	enum	مطلوب	`480P` أو `768P`.
`duration`	integer	مطلوب	أي عدد صحيح من 5 إلى 15 ثانية.
`ratio`	enum	بحسب المدخلات	`adaptive`، `21:9`، `16:9`، `4:3`، `1:1`، `3:4`، `9:16`. مطلوب للنص وحده، ولا يُقبل `adaptive` حينها.
`extra`	object	غير مُدرج	إعدادات اختيارية لتوسيع الموجّه.
`extra.prompt_expansion_mode`	enum	`balanced`	`disabled` أو `balanced` أو `quality`. يحافظ حذف الكائن أو الخاصية على القيمة الافتراضية للنموذج.
`content_filter`	boolean	`true`	فلتر محتوى SeedRouter الموضح أدناه. لا يُرسل إلى النموذج.

المخطط صارم: تُرفض الحقول غير المعروفة بدل تجاهلها. لا يتوفر callback_url؛ استعلم عن المهمة بدلًا منه. extra كائن اختياري صارم يحتوي على prompt_expansion_mode فقط. ترفض جميع الحقول null؛ احذف الحقول الاختيارية بدلًا من ذلك.

عناصر content

`type`	العنصر	`role`
`text`	`{"type":"text","text":"..."}`، حتى 7,000 حرف	لا يوجد
`image_url`	`{"type":"image_url","image_url":{"url":"https://..."},"role":"first_frame"}`	`first_frame` أو `last_frame`

يلزم عنصر نصي واحد غير فارغ بالضبط. تُعامل الصورة الوحيدة دون دور على أنها الإطار الأول. يُقبل إطار أول واحد وإطار أخير واحد كحد أقصى؛ ويتطلب الإطار الأخير إطارًا أول. الصور والفيديو والصوت المرجعي غير مدعومة.

الأوضاع

تحدد عناصر content الوضع؛ ولا يُرسل حقل mode.

الوضع	المحتوى	النسبة
من نص إلى فيديو	عنصر نصي واحد	مطلوبة؛ إحدى ست نسب محددة، ولا تُستخدم `adaptive`
من صورة إلى فيديو	نص وإطار أول، مع إطار أخير اختياري	تتبع صور الإطارات؛ ولا تؤثر قيمة صحيحة أخرى

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

صور الإطارات

استخدم روابط HTTP(S) عامة دون بيانات اعتماد مضمّنة. لا تُقبل Base64 ولا معرّفات mm_file://. يمكن أن تكون الصور JPG أو JPEG أو PNG أو WebP أو HEIC أو HEIF، بحجم لا يتجاوز 30 MB لكل منها، وكل ضلع 256–5760 بكسل، ونسبة عرض إلى ارتفاع بين 0.4 و2.5. تُفحص المدخلات قبل التوليد. استخدم تكوينات ونسب أبعاد متوافقة للإطارين.

فلتر المحتوى

تكون قيمة content_filter هي true ما لم تغيّرها. عند تشغيل الفلتر، يخضع الطلب ونصه ووسائطه للمراجعة قبل التوليد. يفشل الطلب المُعلَّم بالرمز 60001 ولا تُحتسب عليه رسوم. اضبط content_filter على false لتجاوز المراجعة؛ ويُبقي Playground على الموقع الفلتر مفعّلًا دائمًا.

عوامل التكلفة

يعرض قسم أسعار النموذج الأسعار الحالية. لدى Turbo رسم واحد: ثواني المخرجات بالدقة المختارة. لا رسوم منفصلة للإطار الأول والأخير أو لتوسيع الموجّه.

cost = reported output seconds × output-second rate for the resolution

يستخدم التقدير العدد الصحيح المطلوب من الثواني. يعتمد الاحتساب النهائي على ثواني مخرجات المهمة المكتملة بالسعر المسجّل للطلب. عند غياب استخدام صالح، يُستخدم التقدير المقبول. قد تختلف مدة حاوية الوسائط قليلًا عن الثواني المحتسبة. اعرض الرسوم في سجل استخدام حسابك؛ ولا تتضمن استجابات المهام العامة تكاليف. المهام الفاشلة لا تُحتسب.

بنية المخرجات

عند إرسال الطلب، تُعاد المهمة:

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

الاستعلام عن المهمة

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

استعلم كل 10–20 ثانية حتى تصبح status هي completed أو failed. انتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل التوليد: احتفظ بمعرّف المهمة واستأنف فحصها. لا تُنشئ مهمة أخرى للتحقق من التقدم.

المهمة المكتملة

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "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. تتضمن المهمة الدقة والنسبة والمدة الفعلية عند الإبلاغ عنها. يوضح JSON أعلاه بنية الاستجابة؛ وليس نتيجة توليد مقاسة.

الأخطاء

تعيد الطلبات المرفوضة قبل إنشاء مهمة خطأ HTTP مع كائن error ولا تُحتسب عليها رسوم. أما المهمة التي تفشل بعد قبولها فتعيد HTTP 200 عند الاستعلام عنها، مع status: "failed" وكائن error.

راجع دليل الأخطاء المشترك للرموز وحالات HTTP وإرشادات إعادة المحاولة.

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

إذا انتهت مهلة الإرسال نفسه، فافحص مهامك قبل الإرسال مجددًا: ربما قُبل الطلب الأول.

نصائح

صِف موضوعًا وحركة وحركة كاميرا وإعداد إضاءة واحدًا لكل لقطة.
استخدم 480P للمسودة و768P لمزيد من تفاصيل المخرجات. كل توليد جديد طلب مدفوع منفصل.
قدّم إطارًا أول لتثبيت تكوين البداية؛ ولا تضف إطارًا أخيرًا إلا مع تقديم الأول أيضًا.
استخدم extra.prompt_expansion_mode لاختيار disabled أو balanced أو quality؛ ويحافظ الحذف على balanced.
راجع المقطع كاملًا وصوته قبل النشر. لا يضمن الموجّه دقة شكل المنتج أو الكتابة.

نطاق مواصفات الواجهة

تستخدم هذه الواجهة صيغة طلب MiniMax بمصفوفة content، مع معرّفات نماذج SeedRouter ومهام غير متزامنة وصور عبر الروابط فقط وتسليم نتائج مستضافة. لا تتوفر الاستدعاءات الراجعة أو الإلغاء. content_filter فحص مدخلات خاص بـ SeedRouter، وليس معاملًا من MiniMax.

للواجهة المنفصلة المستضافة على fal حقول وحدود مختلفة؛ ولا تنطبق هنا دقة 1080P أو المدد الكسرية أو إعدادات الصوت المستهدف والمراجع المرتبة الخاصة بها. لا تقبل هذه الواجهة إعدادات seed أو العلامة المائية. راجع دليل المقارنة للتمييز والمصادر المرتبطة.