Video
MiniMax H3
ولّد مقاطع مدتها 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.
| الحقل | النوع | مطلوب / الافتراضي | القيم |
|---|---|---|---|
model | string | مطلوب | minimax-h3-standard |
prompt | string | مطلوب | غير فارغ؛ مطلوب في كل وضع |
quality | string | مطلوب | low, high; السعر نفسه |
duration_s | number | 5 | 5–15, بما في ذلك الكسور العشرية |
resolution | string | 768p | 480p, 768p, 1080p, 2k, 4k |
aspect_ratio | string | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
seed | integer | عشوائي | 0–9223372036854775807 |
watermark | boolean | false | true / false |
enhance | boolean | true | إعادة صياغة الموجّه؛ false يُبقيه كما هو |
priority | integer | 1000 | 1000 / 0 |
content_filter | boolean | true | فحص المحتوى لدى SeedRouter قبل التوليد؛ false يتخطى الفحص |
first_frame_image_url | string | اختياري | رابط URL لصورة واحدة |
last_frame_image_url | string | اختياري | يتطلب الإطار الأول |
reference_image_url | string[] | اختياري | 1–4 روابط URL للصور |
reference_video_url | string[] | اختياري | رابط 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، 2K | 4–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| الترويسة | القيمة |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الفيديو المكتمل. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح API في شفرة تعمل على الخادم.
المعاملات
| الحقل | النوع | القيمة الافتراضية | ملاحظات |
|---|---|---|---|
model | string | مطلوب | minimax-h3 |
content | array | مطلوب | الموجّه وأي وسائط، على شكل عناصر موضّحة أدناه. عنصر text واحد غير فارغ بالضبط. |
resolution | enum | مطلوب | 768P أو 2K. |
duration | integer | مطلوب | أي عدد صحيح من 4 إلى 15 ثانية. |
ratio | enum | حسب المدخلات | adaptive، 21:9، 16:9، 4:3، 1:1، 3:4، 9:16. مطلوب للنص وحده، حيث لا تُقبل adaptive. |
content_filter | boolean | true | فلتر المحتوى من 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، HEIF | 30 ميغابايت أو أقل؛ كل ضلع 256–5760 px؛ العرض / الارتفاع 0.4–2.5 |
| فيديو | MP4 أو MOV، بترميز H.264 أو H.265 | 50 ميغابايت أو أقل؛ 2–15 ثانية لكل منها، و15 ثانية إجمالًا؛ كل ضلع 256–5760 px؛ العرض / الارتفاع 0.4–2.5؛ 23.976–60 fps |
| صوت | WAV، MP3 | 15 ميغابايت أو أقل؛ 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لإبعاد العلامات المختلقة عن الإطار.
