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 المدة المطلوبة. لا تُعاد الرسوم أو معرّفات المورّدين أو روابطهم. إذا كانت نتيجة الإرسال مجهولة فلا تجب إعادة المحاولة تلقائيًا. للبذور التي تتجاوز حد الأعداد الصحيحة الآمنة في 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
}

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

كل عنصر صورة وفيديو وصوت هو رابط ⁦HTTP(S)⁩ عام. ولا تُقبل روابط بيانات Base64 ولا معرّفات mm_file://: ارفع الملف إلى تخزينك الخاص ومرّر رابطه.

المُدخلالصيغةالحدود
صورةJPG، JPEG، PNG، WebP، HEIC، HEIF30 ميغابايت أو أقل؛ كل ضلع 256–5760 px؛ العرض / الارتفاع 0.4–2.5
فيديوMP4 أو MOV، بترميز H.264 أو H.26550 ميغابايت أو أقل؛ 2–15 ثانية لكل منها، و15 ثانية إجمالًا؛ كل ضلع 256–5760 px؛ العرض / الارتفاع 0.4–2.5؛ 23.976–60 fps
صوتWAV، MP315 ميغابايت أو أقل؛ 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 لإبعاد العلامات المختلقة عن الإطار.

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