واجهة MiniMax H3 البرمجية

مرجع كامل لواجهة API لنماذج MiniMax H3 لتوليد الفيديو.

إصدارات النموذج

تدعم واجهة API هذه ثلاثة إصدارات من النموذج:

مقارنة سريعة

نسب العرض إلى الارتفاع المدعومة

يدعم نموذجا «من نص إلى فيديو» و«من مراجع إلى فيديو» ما يلي:

21:9, 16:9, 4:3, 1:1, 3:4, 9:16

خيارات الدقة

MiniMax H3 من نص إلى فيديو

نقطة النهاية

POST /api/v1/video/task

معامِلات الطلب

مطلوبة

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'minimax-h3-text-to-video',
    prompt: 'كلب غولدن ريتريفر يركض عبر مرج تغمره أشعة الشمس',
    duration: 8,
    resolution: '2k',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

MiniMax H3 من صورة إلى فيديو

نقطة النهاية

POST /api/v1/video/task

معامِلات الطلب

مطلوبة

اختيارية

ملاحظة: لا يدعم نموذج «من صورة إلى فيديو» المعامِل aspect_ratio.

مثال على الطلب

javascriptنسخ
{
  model_name: 'minimax-h3-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'تتراجع الكاميرا ببطء لتكشف المشهد الطبيعي كاملًا',
  duration: 8,
  resolution: '2k'
}

MiniMax H3 من مراجع إلى فيديو

أنشئ فيديو جديدًا من مراجع اختيارية للصور والفيديو والصوت.

نقطة النهاية

POST /api/v1/video/task

معامِلات الطلب

مطلوبة

الوسائط المرجعية

العناصر النائبة للإشارة المرجعية @ (AT)

تربط ميزة الإشارة المرجعية @ (AT) الوسائط المرجعية بالمطالبة عبر عناصر نائبة مرقمة بصيغة <<<...>>>. يبدأ الترقيم من 1 بصورة مستقلة لكل نوع من الوسائط، ويتبع ترتيب المصفوفة المقابلة.

على سبيل المثال، إذا كانت الصورة الأولى مرجعًا للشخصية والصورة الثانية مرجعًا للمشهد، فاستخدم <<<image_1>>> للشخصية و<<<image_2>>> للمشهد في prompt. يجب أن يشير كل عنصر نائب إلى عنصر موجود في المصفوفة المقابلة له.

مثال على الطلب

javascriptنسخ
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: 'استخدم الصورة الأولى للعنصر الرئيسي والفيديو الأول للحركة والصوت الأول للأجواء',
  duration: 8,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

مثال على طلب «من مراجع إلى فيديو» باستخدام @ (AT)

javascriptنسخ
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: 'ضع المستكشف من <<<image_1>>> في البيئة من <<<image_2>>>، متبعًا حركة الكاميرا في <<<video_1>>>، واجعله يتحدث بالصوت المرجعي من <<<audio_1>>>',
  duration: 10,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.jpg'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

تنسيق الاستجابة

الاستجابة الأولية

تعيد جميع النماذج task_id لاستقصاء الحالة:

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

استجابة استقصاء الحالة

استعلم بصورة دورية عن GET /api/v1/video/{taskId} للتحقق من الحالة:

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

قيم الحالة

• submitted: تم قبول المهمة وهي في انتظار المعالجة
• processing: جارٍ توليد الفيديو
• succeed: اكتمل توليد الفيديو
• failed: فشل توليد الفيديو

أفضل الممارسات

1. صِف الحركة بوضوح: أدرج أوصافًا محددة للحركة في المطالبات
2. اختيار الدقة: استخدم 768p لمعالجة أسرع، و2k للحصول على إخراج بجودة أعلى
3. جودة الصورة: عند استخدام نموذج «من صورة إلى فيديو»، استخدم صور إدخال عالية الجودة للحصول على أفضل النتائج
4. ترتيب المراجع: رتّب images وvideos وaudios ترتيبًا مقصودًا، وأشر إليها باستمرار في المطالبة
5. إشارات @ المرجعية (AT): استخدم العناصر النائبة <<<image_N>>> و<<<video_N>>> و<<<audio_N>>> عندما تحتاج إلى تحكم صريح في الأصل المرجعي الذي يوجّه كل جزء من المشهد