واجهة API لـ Wan 2.7

مرجع API كامل لنماذج Wan 2.7 video generation من Alibaba.

متغيرات النموذج

يدعم هذا API أربعة متغيرات للنموذج:

مقارنة سريعة

Wan 2.7 نص إلى فيديو

نقطة النهاية

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: 'wan-2.7-text-to-video',
    prompt: 'A cat playing with a ball of yarn in a sunlit room',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    negative_prompt: 'blur, low quality',
    seed: 42
  })
});

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

Wan 2.7 صورة إلى فيديو

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

مطلوب

اختياري

مثال طلب

javascriptنسخ
{
  model_name: 'wan-2.7-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  video_url: 'https://example.com/reference-continuation.mp4',
  audio_url: 'https://example.com/driving-audio.mp3',
  prompt: 'Gentle camera push-in; leaves rustle softly in the breeze',
  duration: 6,
  resolution: '720p',
  negative_prompt: 'blur, low quality',
  seed: 42
}

Wan 2.7 تحرير الفيديو

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

مطلوب

اختياري

مثال طلب

javascriptنسخ
{
  model_name: 'wan-2.7-video-edit',
  prompt: 'Replace the sky with warm sunset colors, keep subjects natural',
  negative_prompt: 'artifacts, flicker',
  seed: 42,
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/ref-a.jpg', 'https://example.com/ref-b.jpg'],
  audio_setting: 'auto'
}

Wan 2.7 مرجع إلى فيديو

أنشئ فيديو جديدا من مراجع صور وفيديو مرتبة، مع توجيه صوتي اختياري من مقطع صوتي واحد.

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

مطلوب

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

يلزم توفير صورة مرجعية واحدة أو فيديو مرجعي واحد على الأقل. لا يجوز أن يتجاوز إجمالي عناصر images وvideos خمسة عناصر.

اختياري

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

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

مثال طلب

javascriptنسخ
{
  model_name: 'wan-2.7-reference-to-video',
  prompt: 'Use image one for the hero and video one for the motion; keep the hero voice consistent with audio one',
  resolution: '1080p',
  duration: 8,
  aspect_ratio: '16:9',
  images: ['https://example.com/hero-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  negative_prompt: 'flicker, distorted hands, duplicate subjects',
  seed: 42
}

مثال طلب Reference-to-Video باستخدام @ (AT)

javascriptنسخ
{
  model_name: 'wan-2.7-reference-to-video',
  prompt: 'Place the presenter from <<<image_1>>> in the studio from <<<image_2>>>, follow the camera path in <<<video_1>>>, and use the reference voice from <<<audio_1>>>',
  resolution: '1080p',
  duration: 8,
  aspect_ratio: '16:9',
  images: [
    'https://example.com/presenter-reference.jpg',
    'https://example.com/studio-reference.jpg'
  ],
  videos: ['https://example.com/camera-path-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  negative_prompt: 'flicker, distorted hands, duplicate subjects',
  seed: 42
}

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

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

تُرجع كل النماذج 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: فشل إنشاء الفيديو

وقت المعالجة

وقت المعالجة النموذجي: 2-5 دقائق حسب المدة والدقة settings.

قد تستغرق الفيديوهات الأطول (10-15 seconds) at 1080p ما يصل إلى 8 minutes.

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

1. صف المشهد والحركة: ضمّن محتوى المشهد وحركة الكاميرا في الموجهات
2. اختيار الدقة: استخدم 720p لمعالجة أسرع و1080p لأعلى جودة
3. تخطيط المدة: تكلف الفيديوهات الأطول أكثر (تسعير بالثانية)
4. دمج الصوت: أضف صوتاً مخصصاً عبر معامل audio_url
5. جودة الصورة: في image-to-video، استخدم صور إدخال عالية الجودة للحصول على أفضل النتائج
6. موجهات تحرير الفيديو: كن محدداً بشأن ما تريد تغييره وما تريد الحفاظ عليه
7. عدد الأصول المرجعية: في reference-to-video، اجعل العدد الإجمالي لعناصر images وvideos خمسة أو أقل
8. الصوت المرجعي: استخدم audios فقط لتوجيه هوية الصوت، وصف المحتوى المنطوق المطلوب في الموجه