واجهة API لـ Wan 2.7 Lora

مرجع API كامل لتوليد image-to-video عبر Wan 2.7 Lora من Alibaba.

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

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

النموذج	ID	الوصف
Wan 2.7 Lora Image to Video	`wan-2.7-lora-image-to-video`	تحريك image-to-video عالي الجودة

مقارنة سريعة

الميزة	Image to Video
الإدخال	صورة + موجه نصي
نطاق المدة	2-15 ثانية
خيارات الدقة	720p، 1080p
نسب العرض إلى الارتفاع	غير مدعومة (تحددها الصورة المصدر)
دعم الصوت	صوت مخصص اختياري
إطار البداية	مطلوب

Wan 2.7 Lora Image to Video

نقطة النهاية

POST /api/v1/video/task

معلمات الطلب

مطلوبة

المعلمة	النوع	الوصف
`model_name`	string	يجب أن تكون `"wan-2.7-lora-image-to-video"`
`prompt`	string	موجه توليد الفيديو
`image_url`	string	رابط صورة الإطار الأول
`duration`	number	مدة الفيديو بالثواني. يجب أن تكون بين `2` و`15`.
`resolution`	string	دقة الإخراج المطلوبة: `"720p"` أو `"1080p"`. القيمة الافتراضية هي `"720p"`.

اختيارية

المعلمة	النوع	الوصف
`audio_url`	string	رابط صوت مخصص اختياري. التنسيقات المدعومة: wav أو mp3. يجب أن تكون مدة الصوت 2-30 ثانية.
`negative_prompt`	string	محتوى يجب تقليله في الفيديو المولد
`seed`	number	بذرة عشوائية ضمن النطاق `[0, 2147483647]`

مثال طلب

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-lora-image-to-video',
    prompt: 'The girl is dancing',
    image_url: 'https://example.com/source-image.jpg',
    resolution: '720p',
    duration: 5,
    audio_url: 'https://example.com/background-audio.mp3',
    seed: 4,
    negative_prompt: 'other people'
  })
});

const { data } = await response.json();
const taskId = data.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/{task_id}. حالات المهمة: submitted, processing, succeed, failed.

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

استخدم موجهات حركة تصف حركة الموضوع وسلوك الكاميرا بوضوح.
قدم صورة إطار أول نظيفة بموضوع محدد جيدا.
استخدم negative_prompt لتقليل الآثار غير المرغوبة أو الموضوعات الزائدة في المشهد.