واجهة API لـ Seedance 2.0 Mini

مرجع API كامل لنماذج توليد الفيديو Seedance 2.0 Mini من ByteDance.

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

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

مقارنة سريعة

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

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

خيارات الدقة

Seedance 2.0 Mini Text to Video

نقطة النهاية

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: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

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

Seedance 2.0 Mini Image 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: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

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

Seedance 2.0 Mini Reference to Video

معلمات الطلب

مطلوبة

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

يجب أن يتضمن كل طلب صورة واحدة أو مقطع فيديو واحدًا على الأقل. أرسل من 1 إلى 9 صور عند استخدام مراجع الصور. لا يجوز حذف مصفوفة images أو تركها فارغة إلا عندما تحتوي مصفوفة videos على مقطع فيديو مرجعي واحد على الأقل. الطلبات التي تحتوي على صوت فقط غير مدعومة.

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

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

يجب أن يشير كل عنصر نائب إلى عنصر موجود في المصفوفة المقابلة له.

اختيارية

تسعير الفيديو المرجعي

يتبع Seedance V2.0 Mini Reference-to-Video بنية الفوترة نفسها القائمة على الدقة ولكل ثانية مثل متغيرات Seedance 2.0 المرجعية الأخرى. عندما تحتوي مصفوفة videos على مقطع فيديو مرجعي واحد على الأقل، تُضاعف تكلفة التوليد الإجمالية بمقدار 2. يُطبق هذا المضاعف مرة واحدة بغض النظر عن عدد مقاطع الفيديو المرجعية المرفوعة أو مدتها.

مثال طلب

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: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    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']
  })
});

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

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

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

تعيد جميع النماذج task_id لأغراض polling:

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

استجابة Polling

نفذ polling على 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-6 دقائق حسب المدة والدقة.

نفذ polling كل 5-10 ثوان للتحقق من الحالة.

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

1. صف الحركة بوضوح: أدرج أوصاف حركة محددة في المطالبات
2. اختيار الدقة: استخدم 480p لمعالجة أسرع، و720p لجودة أعلى
3. تحسين الصوت: أبق sound مفعلا لتجارب فيديو أكثر غمرا
4. Image to Video: وفر إطارا أول واضحا عبر image_url; استخدم image_end_url عندما تحتاج إلى إطاري بداية ونهاية مضبوطين
5. الوسائط المرجعية: استخدم مراجع الصور والفيديو والصوت المدعومة، وتأكد من تضمين صورة واحدة أو مقطع فيديو واحد على الأقل
6. تسعير الفيديو المرجعي: تُحتسب تكلفة أي طلب Reference-to-Video يحتوي على مقطع فيديو مرجعي واحد على الأقل بضعفين، بغض النظر عن عدد مقاطع الفيديو المرفوعة أو مدتها
7. معلمة Seed: لا ترسل seed؛ فنماذج Seedance 2.0 Mini لا تدعمها