Wan 3.0 API

مرجع API كامل لنماذج إنشاء الفيديو Wan 3.0 من Alibaba.

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

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

مقارنة سريعة

نقطة النهاية المشتركة

تستخدم جميع إصدارات Wan 3.0 نقطة نهاية مهام الفيديو:

POST /api/v1/video/task

المعلمات المشتركة

مطلوبة {#}

اختيارية

Wan 3.0 Text to Video

اضبط model_name على "wan-3.0-text-to-video" وقدّم المعلمات المطلوبة المشتركة.

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

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-3.0-text-to-video',
    prompt: 'A cinematic tracking shot follows a cyclist through a rain-soaked neon city at night',
    duration: 8,
    resolution: '1080p',
    aspect_ratio: '16:9',
    sound: true,
    seed: 42
  })
});

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

Wan 3.0 Image to Video

مدخلات الصور المطلوبة

يجب أن تستخدم الصورتان تنسيق JPEG أو JPG أو PNG من دون قناة ألفا أو BMP أو WEBP. ويجب أن يتراوح طول كل جانب من الصورة بين 240 و8000 بكسل.

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

javascriptنسخ
{
  model_name: 'wan-3.0-image-to-video',
  prompt: 'The camera glides forward as daylight gradually shifts into a warm evening glow',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Video Edit

إدخال الفيديو المطلوب

يجب ألا يتجاوز مجموع مدة فيديو المصدر وduration المطلوبة للإخراج 30 ثانية.

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

javascriptنسخ
{
  model_name: 'wan-3.0-video-edit',
  prompt: 'Turn the daytime scene into a rainy evening while preserving the subject and camera movement',
  video_url: 'https://example.com/source-video.mp4',
  duration: 10,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Reference to Video

مدخلات المراجع اختيارية ويمكن دمجها، باستثناء files وlinks إذ لا يمكن إرسالهما معًا.

مدخلات المراجع الاختيارية

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

javascriptنسخ
{
  model_name: 'wan-3.0-reference-to-video',
  prompt: 'Use the references to create a cinematic product launch with coordinated motion and sound',
  duration: 12,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/product-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/sound-reference.mp3'],
  links: ['https://example.com/public-creative-brief'],
  seed: 42
}

لاستخدام ملف مرجعي بدلًا من صفحة ويب، احذف links ومرّر عنوان URL واحدًا في files.

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

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

تعيد جميع النماذج 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. مدخلات الصور: استخدم صور البداية والنهاية والمراجع المطابقة لنسبة العرض إلى الارتفاع المطلوبة. يجب ألا تحتوي صور PNG على قناة ألفا.
3. توقيت تحرير الفيديو: تحقق من مدة المصدر قبل اختيار مدة الإخراج المطلوبة بحيث يظل مجموعهما ضمن 30 ثانية.
4. حدود المراجع: تحقّق من عدد كل مجموعة مراجع وتنسيقها وأبعادها ومدتها الإجمالية قبل الإرسال.
5. الملفات والروابط: أرسل إما ملفًا مرجعيًا واحدًا أو رابطًا واحدًا لصفحة ويب عامة، ولا ترسلهما معًا في الطلب نفسه.