> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# دليل تكامل API لتوليد الفيديو MiniMax H3
> Minimax API guide - Ace Data Cloud
يقدم هذا المقال تكامل واستخدام API لتوليد الفيديو MiniMax H3. تدعم هذه الواجهة توليد الفيديو من النص، والتحكم بالإطار الأول والأخير، وتوليد الفيديو بالمرجع متعدد الوسائط، وتستخدم بنية V2 موحّدة متعددة الوسائط `content` لإنشاء المهام.
## عملية التقديم
لاستخدام API لتوليد الفيديو MiniMax H3، انتقل أولاً إلى [وحدة تحكم Ace Data Cloud](https://platform.acedata.cloud/console/applications) للحصول على API Token الخاص بك، واحتفظ به للاستخدام لاحقاً.
إذا لم تكن قد سجلت الدخول أو أنشأت حساباً بعد، فسيتم تحويلك تلقائياً إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد الإكمال ستعود تلقائياً إلى الصفحة الحالية.
**يمكن لـ API Token واحد استدعاء جميع خدمات المنصة، ولا حاجة للتقديم بشكل منفصل لكل خدمة.** سيُمنح رصيد مجاني عند أول تقديم، ويمكن التجربة مجاناً؛ وعندما لا يكون الرصيد كافياً، يمكن شحن الرصيد العام من [وحدة التحكم](https://platform.acedata.cloud/console/coin).
> 📘 الوثائق الكاملة: [API لتوليد الفيديو MiniMax H3 →](https://platform.acedata.cloud/documents/minimax-videos-integration)
يُوصى بحفظ Token كمتغير بيئة، ولا تكتبه في الشيفرة المصدرية أو ترسله إلى مستودع الإصدارات:
```bash theme={null}
export ACEDATACLOUD_API_KEY="YOUR_API_KEY"
```
## نظرة عامة على الواجهة
* **Base URL**: `https://api.acedata.cloud`
* **Endpoint**: `POST /minimax/videos`
* **طريقة المصادقة**: تضمين `authorization: Bearer {token}` في HTTP Header
* **رؤوس الطلب**:
* `accept: application/json`
* `content-type: application/json`
* **النموذج (model)**: `MiniMax-H3`
* **بنية الإدخال**: تمرير النصوص والصور ومقاطع الفيديو والصوت بشكل موحّد عبر `content`
* **وضع الإخراج**: افتراضياً، ينتظر بشكل متزامن حتى يكتمل التوليد ويعيد `task` كاملاً؛ وعند تمرير `async: true` أو `callback_url` يعيد فوراً `task_id` و`trace_id`
* **استعلام النتيجة**: الحصول على الحالة والفيديو الناتج عبر [API لاستعلام مهام MiniMax H3](https://platform.acedata.cloud/documents/minimax-tasks-integration)
* **رد الاتصال غير المتزامن**: اختياري، استقبل نتيجة المهمة النهائية عبر `callback_url`
لا تحتاج إلى تمرير `action` لاختيار وضع التوليد، إذ ستحدد الواجهة الاستخدام تلقائياً بناءً على نوع المادة و`role` في `content`.
## ما السيناريوهات المناسبة
| السيناريو | تركيبة الإدخال | الاستخدامات الشائعة |
| - | - | - |
| توليد الفيديو من النص | نص | إبداع إعلاني، معاينة القصص المصورة، فيديوهات قصيرة، لقطات أجواء |
| توليد الفيديو من صورة الإطار الأول | نص + صورة الإطار الأول | جعل صور المنتجات أو الملصقات أو صور الأشخاص أو الرسوم التوضيحية تتحرك بشكل طبيعي |
| فيديو الإطار الأخير / الإطار الأول والأخير | نص + إطار أخير، أو نص + إطار أول + إطار أخير | التحكم في البداية والنهاية، والانتقالات، وتغيرات النمو، والمقارنات قبل وبعد |
| توليد الفيديو بالمرجع متعدد الوسائط | نص + صورة / فيديو / صوت مرجعي | الحفاظ على اتساق الشخصيات والمنتجات، وإعادة إنتاج الحركات أو حركة الكاميرا أو طبقة الصوت أو إيقاع التحرير |
## عملية الاستدعاء
عند عدم تمرير `async` افتراضياً، سينتظر `/minimax/videos` حتى يكتمل التوليد ويعيد `task` كاملاً مباشرةً. عند الحاجة إلى تحرير الاتصال فوراً، مرّر `async: true` أو `callback_url`:
1. احفظ `task_id` و`trace_id` في الاستجابة الفورية.
2. عند عدم إعداد رد اتصال، استدعِ `/minimax/tasks` مرة كل 10 ثوانٍ تقريباً للاستعلام.
3. عندما تصبح `task.status` هي `succeeded`، احصل على الفيديو من `task.content.url`.
4. عندما تكون الحالة `failed` أو `cancelled`، أوقف الاستعلام الدوري واقرأ `task.error`.
## معاملات الطلب العليا
| المعامل | النوع | مطلوب | القيمة الافتراضية | الوصف |
| - | - | - | - | - |
| `model` | string | نعم | - | ثابت كـ `MiniMax-H3` |
| `content` | object\[] | نعم | - | مصفوفة محتوى متعددة الوسائط، ويجب أن تحتوي على عنصر `text` غير فارغ |
| `resolution` | string | نعم | - | `768P` أو `2K` |
| `duration` | integer | نعم | - | مدة التوليد، عدد صحيح من 4 إلى 15 ثانية |
| `ratio` | string | مطلوب بشروط | `adaptive` | `adaptive`، `21:9`، `16:9`، `4:3`، `1:1`، `3:4`، `9:16` |
| `async` | boolean | لا | `false` | عند `true` يعيد معرّف المهمة فوراً، واحصل على النتيجة عبر واجهة المهام |
| `callback_url` | string | لا | - | عنوان URL عام لرد الاتصال لاستلام نتيجة المهمة النهائية؛ يؤدي تقديمه إلى تفعيل الوضع غير المتزامن تلقائياً |
تعتمد قواعد `ratio` على سير العمل:
* **توليد الفيديو من النص**: مطلوب، ولا يمكن أن يكون `adaptive`.
* **فيديو الإطار الأول أو الإطار الأخير أو الإطار الأول والأخير**: تحدد صورة الإدخال نسبة الأبعاد، ويُوصى بحذفه أو تمرير `adaptive`.
* **توليد الفيديو بالمرجع متعدد الوسائط**: يمكن حذفه، والقيمة الافتراضية هي `adaptive`؛ ويمكن أيضاً تحديد نسبة ثابتة بوضوح.
لا تقبل الواجهة الحقول القديمة أو حقول التوافق، مثل `prompt` و`image_urls` و`audio_urls` و`messages` و`first_frame_image`. عند تلقي أخطاء لهذه المعاملات، احذف الحقول القديمة وانتقل إلى `content`؛ مثلاً غيّر `"prompt": "一只猫挥手"` إلى `"content": [{"type": "text", "text": "一只猫挥手"}]`。لا ترسل التنسيقين الجديد والقديم في الوقت نفسه.
## معاملات عناصر محتوى content
يجب أن يحتوي كل عنصر محتوى على `type`، وتُحدد الحقول الأخرى حسب النوع:
| `type` | حقل البيانات | `role` | الوصف |
| - | - | - | - |
| `text` | `text` | لا يتم تمريره | يجب أن يحتوي كل طلب على عنصر نصي غير فارغ، بحد أقصى 7000 حرف |
| `image_url` | `image_url.url` | `first_frame` | صورة الإطار الأول؛ وعندما توجد صورة واحدة فقط ويتم حذف `role`، تُعامل أيضاً كإطار أول |
| `image_url` | `image_url.url` | `last_frame` | صورة الإطار الأخير؛ يمكن استخدامها منفردة، أو دمجها مع `first_frame` للتحكم في نقطة البداية والنهاية |
| `image_url` | `image_url.url` | `reference_image` | مرجع للموضوع أو الشخصية أو المنتج أو الملابس أو المشهد أو الأسلوب |
| `video_url` | `video_url.url` | `reference_video` | مرجع للحركة أو حركة الكاميرا أو الأداء أو بنية التحرير |
| `audio_url` | `audio_url.url` | `reference_audio` | مرجع لطبقة الصوت أو الحوار أو الموسيقى أو الإيقاع |
تدعم عناوين الوسائط ثلاثة أشكال:
* عنوان HTTPS متاح للعامة، ويوصى به للملفات الكبيرة.
* `mm_file://{file_id}`، للإشارة إلى الملفات التي تم رفعها أو النتائج الموجودة بالفعل.
* Base64 data URI لنوع الوسائط المقابل. يزيد Base64 الحجم بنحو الثلث، لذا تأكد من أن جسم الطلب بالكامل لا يتجاوز 64 MB.
## مواصفات المواد وحدود الكمية
| المادة | التنسيق | حد الملف الواحد | الأبعاد / المدة | حد العدد |
| - | - | - | - | - |
| الصور | JPG، JPEG، PNG، WEBP، HEIC، HEIF | لا يتجاوز 30 MB | العرض والارتفاع كلاهما 256-5760 px؛ نسبة العرض إلى الارتفاع 0.4-2.5 | حتى صورة واحدة للإطار الأول، وصورة واحدة للإطار الأخير، و9 صور مرجعية |
| الفيديو | MP4، MOV؛ H.264/AVC أو H.265/HEVC؛ المسار الصوتي AAC أو MP3 | لا يتجاوز 50 MB | كل مقطع 2-15 ثانية، والإجمالي لا يتجاوز 15 ثانية؛ العرض والارتفاع كلاهما 256-5760 px؛ نسبة العرض إلى الارتفاع 0.4-2.5؛ 23.976-60 fps | حتى 3 مقاطع فيديو مرجعية |
| الصوت | WAV، MP3 | لا يتجاوز 15 MB | كل مقطع 2-15 ثانية، والإجمالي لا يتجاوز 15 ثانية | حتى 3 مقاطع صوتية مرجعية |
يمكن أن يصل إجمالي ملفات الصور والفيديو والصوت في سيناريو المراجع متعددة الوسائط إلى 12 ملفًا كحد أقصى. سيناريو الإطارين الأول والأخير وسيناريو المواد المرجعية متنافيان: بمجرد استخدام `reference_image` أو `reference_video` أو `reference_audio`، لا يمكن استخدام `first_frame` أو `last_frame` بعد ذلك، والعكس صحيح.
## عرض قدرات على مستوى الإنتاج
ما يلي ليس رسومًا مفاهيمية أو موادًا بديلة، بل هو مدخلات مرجعية حقيقية ومخرجات فيديو فعلية من عينات القدرات الرسمية لـ MiniMax H3 على مستوى الإنتاج. تغطي مجموعات الحالات الثلاث على التوالي أفلام العلامات التجارية القصيرة، والسرد الواقعي، والتجارة الإلكترونية للأزياء، وهي مناسبة لتقييم أهم قدرات النموذج في الإنتاج التجاري.
| القدرة | نقاط الملاحظة الرئيسية |
| - | - |
| اتساق الشخصيات والوجوه | ما إذا كانت ملامح الوجه، وتسريحة الشعر، والمكياج، وطابع الشخصية مستقرة بعد تبديل اللقطات المتعددة |
| الأداء الوجهي | نظرات العين، والتعبيرات الدقيقة، والتوتر العاطفي، وحركة الرأس الطبيعية في اللقطات القريبة |
| الحفاظ على بنية المنتج | ملامح منتجات مثل النظارات وحقائب اليد، وموادها، وعلاقة ارتدائها، وانعكاسات المرايا |
| تنفيذ الهوية البصرية للعلامة التجارية | ما إذا كان جو المشهد، وحبيبات الفيلم، والألوان، والشعار، وإيقاع المونتاج موحّدة |
| السرد السينمائي | ما إذا كانت تغيّرات أحجام اللقطات، وتحريك الشخصيات، وحركة الكاميرا، والإيقاع، والصوت يمكن أن تشكل مقطعًا كاملًا |
تشير «قدرات الوجه» هنا إلى اتساق مظهر الشخصية، وتفاصيل الوجه، والتحكم في الأداء ضمن توليد الفيديو، وليست التعرف على الهوية، أو مقارنة الوجوه، أو واجهة استبدال الوجوه.
### فيلم قصير لعلامة تجارية فاخرة: توحيد الشخصية والمنتج وأصول العلامة التجارية
**هدف الإنتاج:** فيلم لعلامة أزياء راقية بنسبة 16:9. استخدام طريق صحراوي وسيارة كلاسيكية لإرساء أجواء باردة وحادة، مع الحفاظ على مظهر البطلة وبنية حقيبة اليد السوداء، وإدماج شعار العلامة التجارية بشكل طبيعي في النهاية. تركز هذه الحالة على اختبار اتساق الشخصيات عبر اللقطات، والحفاظ على المنتج، والطابع السينمائي، وقدرة إنهاء العلامة التجارية.
| مرجع الأجواء والمشهد | مرجع الشخصية |
| - | - |
| 
| 
|
| مرجع منتج حقيبة اليد | مرجع شعار العلامة التجارية |
| - | - |
| 
| 
|
[فتح أو تنزيل فيلم العلامة التجارية القصير مباشرةً](https://cdn.acedata.cloud/uploads/6845b11d-1a58-4478-afd8-29e7e117772a)
طريقة تنظيم `content` المقابلة:
```json theme={null}
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "15 秒、16:9 高级时装品牌片。荒漠公路旁停着复古汽车，女主从后备箱取出黑色手袋，与男主短暂对视后独自离开。保持人物、手袋与品牌视觉一致；冷峻高级，电影颗粒，剪辑利落，结尾自然呈现品牌 Logo。"
},
{
"type": "image_url",
"image_url": { "url": "https://cdn.acedata.cloud/uploads/6e65f865-f1c2-4f80-8b51-9a98d4d930b1" },
"role": "reference_image"
},
{
"type": "image_url",
"image_url": { "url": "https://cdn.acedata.cloud/uploads/88d89cc3-e6cb-42b4-ab4c-1bbbf6c9f7c8" },
"role": "reference_image"
},
{
"type": "image_url",
"image_url": { "url": "https://cdn.acedata.cloud/uploads/e91f7fff-f8e3-4da5-b882-87edbc3c9473" },
"role": "reference_image"
},
{
"type": "image_url",
"image_url": { "url": "https://cdn.acedata.cloud/uploads/b68dac43-fb14-42b5-bf8b-fd4d65506520" },
"role": "reference_image"
}
],
"resolution": "2K",
"duration": 15,
"ratio": "16:9"
}
```
### دراما قصيرة عمودية واقعية: اتساق الوجه والأداء العاطفي
**هدف الإنتاج:** إعلان تشويقي لدراما رومانسية مظلمة واقعية مدته 15 ثانية، بنسبة 9:16. ثبّت مظهر الشخصيات بالاعتماد على صور مرجعية للبطل والبطلة، وقيّد الفضاء باستخدام صورة مرجعية لقلعة قديمة؛ استخدم اللقطات المتوسطة القريبة واللقطات المقربة للوجه لإظهار مواجهة النظرات، والخوف، وضبط النفس، والإحساس بالخطر. هذه الحالة مناسبة لمراقبة استقرار ملامح الوجه البشري الواقعي، والتعبيرات الدقيقة، وعلاقات النظرات، والأداء المتواصل.
| مرجع البطل والبطلة | مرجع مشهد القلعة |
| - | - |
| 
| 
|
[فتح أو تنزيل الدراما القصيرة الواقعية مباشرة](https://cdn.acedata.cloud/uploads/0f3e9bf2-5073-46f4-9a2d-7d8d912391cf)
يجب أن تحدد المطالبة بوضوح علاقة الشخصيات والمشاعر وحجم اللقطة، بدلاً من مجرد وصف «حوار بين رجل وامرأة»:
```text theme={null}
15 秒、9:16 真人暗黑浪漫短剧预告。女主误入禁忌古堡，唤醒沉睡的吸血鬼贵族；
他危险而克制地靠近，她恐惧但不屈服。保持两位角色的五官、发型与服装一致，
以中近景和面部特写表现眼神对峙与情绪张力，暗色电影光线，节奏紧凑。
```
### إعلان نظارات عصرية: الحفاظ على تفاصيل الوجه وبنية المنتج
**هدف الإنتاج:** إعلان نظارات عصرية راقٍ بنسبة 9:16. تتولى الصورة الكاملة للجسم تحديد هيئة العارضة ومشيتها، وتتولى الصورة المرجعية للوجه تحديد ملامح الوجه والمكياج، وتتولى صورة المنتج تحديد المنحنيات المحيطة وانعكاسات العدسات وذراعي النظارة ومحيط عين القطة. تختبر هذه الحالة في الوقت نفسه اللقطات القريبة للوجه، واتساق عدة أشخاص، وعلاقة الارتداء، والبنية الهندسية للمنتج.
| مرجع العارضة والتصميم | مرجع تفاصيل الوجه | مرجع منتج النظارات |
| - | - | - |
| 
| 
| 
|
[فتح أو تنزيل إعلان النظارات العصرية مباشرة](https://cdn.acedata.cloud/uploads/55715089-b6bd-4ef6-a3c2-e762a672f751)
في إعلانات المنتجات، ينبغي أن تفصل المطالبة بوضوح بين أدوار مرجع الشخصيات ومرجع المنتج: تقيّد مواد الشخصيات الوجه والمكياج وهيئة الجسم والطابع؛ وتقيّد مواد المنتج المحيط والخامة والانعكاسات وموضع الارتداء. هذا أكثر استقراراً من كتابة «أنشئ إعلاناً للنظارات» بشكل عام.
## تحويل النص إلى فيديو
عندما يكون هناك عنصر نصي واحد فقط، يكون ذلك تحويل النص إلى فيديو. وهو مناسب لتوليد المشاهد مباشرة من الإبداع أو السيناريو أو وصف اللقطات. يمكن تنظيم المطالبة وفق ترتيب «الموضوع + الحركة + المشهد + الكاميرا + الإضاءة + الصوت».
```bash theme={null}
curl -X POST 'https://api.acedata.cloud/minimax/videos' \
-H "Authorization: Bearer $ACEDATACLOUD_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "15 秒电影级香水广告：清晨海岸的黑色礁石上，透明香水瓶被薄雾与海浪环绕。微距展现瓶身水珠和玻璃折射，镜头从产品特写缓慢拉升到广阔海面；银蓝色调，真实自然光，高级克制，结尾定格产品。"
}
],
"resolution": "2K",
"duration": 15,
"ratio": "16:9"
}'
```
يعيد الوضع المتزامن الافتراضي المهمة الكاملة بعد اكتمال التوليد:
```json theme={null}
{
"task": {
"id": "f5977217-ed2c-40da-adbe-93d08235618f",
"model": "MiniMax-H3",
"status": "succeeded",
"content": { "url": "https://cdn.acedata.cloud/minimax/f5977217.mp4" },
"resolution": "2K",
"duration": 15,
"ratio": "16:9"
}
}
```
إذا أُضيف `"async": true` إلى الطلب، تعيد الواجهة فوراً:
```json theme={null}
{
"task_id": "f5977217-ed2c-40da-adbe-93d08235618f",
"trace_id": "trace_7f8c2b1a"
}
```
## تحويل صورة الإطار الأول إلى فيديو
ضع علامة `first_frame` على الصورة، وسيبدأ النموذج بالتوليد من هذا المشهد. وهو مناسب لإضفاء الحركة الطبيعية على الملصقات وصور المنتجات ومخططات إعداد الشخصيات والأعمال الفوتوغرافية.
```json theme={null}
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "人物自然呼吸并看向窗外，衣角被微风吹动，镜头缓慢推进"
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/b1c82e4937.png"
},
"role": "first_frame"
}
],
"resolution": "2K",
"duration": 5,
"ratio": "adaptive"
}
```
## فيديو الإطار الأخير وفيديو الإطارين الأول والأخير
توفير `last_frame` فقط يتيح للنموذج توليد الفيديو بشكل طبيعي حتى يصل إلى المشهد المحدد؛ وتوفير كلٍ من `first_frame` و`last_frame` يتيح التحكم الواضح في نقطة البداية والنهاية. مناسب للانتقالات، وتغيرات الشكل، وعملية النمو، أو المقارنة بين المنتج قبل وبعد.
```json theme={null}
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "女孩从童年自然成长为青年，时间流逝平滑，人物始终位于画面中央"
},
{
"type": "image_url",
"image_url": { "url": "YOUR_FIRST_FRAME_URL" },
"role": "first_frame"
},
{
"type": "image_url",
"image_url": { "url": "YOUR_LAST_FRAME_URL" },
"role": "last_frame"
}
],
"resolution": "2K",
"duration": 5,
"ratio": "adaptive"
}
```
يجب أن تكون أبعاد ونسبة العرض إلى الارتفاع للإطار الأول والإطار الأخير متطابقة قدر الإمكان، وألا تكون الفروق في موضع العنصر الرئيسي والتكوين والإضاءة كبيرة جدًا، مما يسهل الحصول على انتقال طبيعي.
## توليد الفيديو بالرجوع إلى مراجع متعددة الوسائط
يمكن استخدام المواد المرجعية بشكل مركب: تتحكم الصور المرجعية في مظهر الشخصية أو المنتج، وتتحكم الفيديوهات المرجعية في الحركة وحركة الكاميرا، وتتحكم المقاطع الصوتية المرجعية في صوت الحوار أو الموسيقى أو إيقاع التحرير. يجب توضيح ما الذي ينبغي أن تتحكم به كل فئة من المواد بوضوح في النص التوجيهي، لتجنب رفع المواد فقط دون تقديم علاقة ارتباط.
```json theme={null}
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "保持参考人物的五官、发型与服装一致，按照参考视频中的表演动作完成时尚短片；镜头节奏跟随参考音频，近景突出自然面部表情"
},
{
"type": "image_url",
"image_url": { "url": "YOUR_CHARACTER_IMAGE_URL" },
"role": "reference_image"
},
{
"type": "video_url",
"video_url": { "url": "YOUR_PERFORMANCE_VIDEO_URL" },
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": { "url": "YOUR_AUDIO_URL" },
"role": "reference_audio"
}
],
"resolution": "2K",
"duration": 5,
"ratio": "adaptive"
}
```
## إشعار الاستدعاء
سيؤدي تمرير `callback_url` إلى تفعيل الوضع غير المتزامن تلقائيًا: تعيد واجهة الإنشاء فورًا `task_id` و`trace_id`، وترسل النتيجة النهائية عبر POST إلى هذا العنوان بعد اكتمال المهمة، ويكون هيكلها متوافقًا مع استجابة استعلام المهمة.
تكون الحالات النهائية في الاستدعاء هي `succeeded` أو `failed` أو `cancelled`. حتى عند استخدام الاستدعاء، يُوصى أيضًا بحفظ `task_id` لتسهيل الاستعلام النشط أو تعويض الإشعارات الفائتة.
## الأخطاء الشائعة
| رمز حالة HTTP | المعنى | توصية المعالجة |
| - | - | - |
| `400` | خطأ في المعلمات أو تركيبة مواد غير صالحة | تحقق من الحقول المطلوبة و`role` وعدد المواد وتنسيقها |
| `401` | Token مفقود أو غير صالح | تحقق من `Authorization: Bearer ...` |
| `402` | الرصيد أو الحصة غير كافيين | أضف إلى الرصيد العام في لوحة التحكم |
| `422` | لم يجتز فحص أمان المحتوى | عدّل النص التوجيهي أو المواد ثم أعد الإرسال |
| `429` | الطلبات متكررة جدًا | أعد المحاولة بعد تراجع أسي؛ يُوصى بأن تكون فترة استطلاع المهمة نحو 10 ثوانٍ |
| `500` | الخدمة غير متاحة مؤقتًا | احتفظ بمعلومات الطلب وأعد المحاولة لاحقًا |
يشير `task.status: succeeded` في الاستجابة المتزامنة إلى أن الفيديو قد تم إنشاؤه؛ أما التأكيد غير المتزامن فلا يعني سوى أن المهمة دخلت قائمة الانتظار. لا يتم احتساب الرسوم إلا عند نجاح المهمة نهائيًا، واستعلام المهمة نفسه مجاني ولا يؤدي إلى خصم متكرر.
### H3 Max
يدعم `MiniMax-H3-Max` دقة 480P أو 768P، ومددًا صحيحة من 5 إلى 15 ثانية. لا تُفرض رسوم إضافية على إدخال الصوت، وأول صورتين مجانيتان، بينما تُحتسب رسوم لكل صورة إضافية؛ ويُحتسب الفيديو المرجعي وفقًا لمدة الإدخال الفعلية. لا يدعم هذا النموذج دقة 2K.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.