MiniMax H3 Max

ولّد مقاطع MiniMax H3 Max بالصوت لمدة 5–15 ثانية بدقة 480P أو 768P من نص أو إطارات أو مراجع، بصيغة MiniMax الرسمية مع تسليم النتيجة عبر مهمة.

MiniMax H3 Max هو الإصدار الأسرع في التوليد من MiniMax H3. ينشئ الطلب الواحد الصورة والصوت معًا: مقطعًا مدته 5–15 ثانية بدقة 480P أو 768P مع حواره وأجوائه ومؤثراته. يتبع متن الطلب صيغة MiniMax الرسمية بمعرّف النموذج minimax-h3-max. أرسله واحتفظ بمعرّف المهمة المُعاد، ثم احصل على الفيديو المكتمل من المهمة. تُرسل الإطارات والمراجع على هيئة روابط URL.

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

معرّف النموذج	المدخلات	الدقات	المدة
`minimax-h3-max`	نص، والإطار الأول والأخير، وصور وفيديو وصوت مرجعي	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",
    "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`
`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` أو `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`

لا يمكن جمع الإطارات والمراجع في طلب واحد. يسرد التوثيق الرسمي إدخال الإطار الأخير وحده، لكنه يتضمن أيضًا شرطًا متعارضًا يقتضي إقرانه بإطار أول. لم يجرِ التحقق من هذه الحالة على SeedRouter. استخدم الإطارين عندما تحتاج صورة نهاية.

{
  "model": "minimax-h3-max",
  "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": "768P",
  "duration": 6
}

مدخلات الوسائط

كل عنصر صورة أو فيديو أو صوت هو رابط HTTP(S) عام. لا تُقبل روابط بيانات 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 Max ثواني المخرجات المولّدة وثواني الفيديو المرجعي منفصلة بحسب دقة المخرجات. أول صورتين مجانيتان؛ وكل صورة لاحقة تضيف رسومًا.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

تُجمع مدد الفيديوهات المرجعية وتُقرّب إلى أقرب ثانية كاملة للاستخدام النهائي. لذا يساهم مقطعان مدة كل منهما 2.4 ثانية بخمس ثوانٍ من المدخلات. لا رسوم إدخال للصوت المرجعي. يُحسب الإطار الأول والأخير صورتين، ولذلك لا يضيف الإطاران وحدهما رسوم صور.

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

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

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

{"id": "task_...", "model": "minimax-h3-max", "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",
  "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",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

نصائح

صِف اللقطة وصوتها معًا: الموضوع والمكان والكاميرا والإضاءة والحوار والمؤثرات.
اكتب الحوار في الموجّه وأرفق مقطعًا صوتيًا مرجعيًا عندما ينبغي أن يتبع الصوت ذلك المقطع.
أنشئ مسودة بدقة 480P، ثم اختر 768P عند الحاجة إلى تفاصيل أكثر. التصيير الجديد طلب مدفوع منفصل.
استخدم extra: {"prompt_expansion_mode": "disabled"} لموجّه مكتمل أصلًا، أو اختر توسيع balanced / quality.
استخدم الإطار الأول والأخير للتحكم في بداية اللقطة ونهايتها؛ واستخدم المراجع للحفاظ على منتج أو شخص أو حركة.
أضف no text, no logos لتجنب العلامات المختلقة.

مصادر مواصفات الواجهة

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