Seedance 2.0 Mini API

مرجع 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;

حدود الوسائط

تنطبق هذه الحدود على صور الإطار الأول وصور الإطار الأخير والوسائط المرجعية لنماذج هذه الصفحة.

للصوت المرجعي والفيديو المرجعي حدّان منفصلان لمجموع المدد، قدر كل منهما 15 ثانية. كما أن الأعداد مستقلة: حتى 9 صور و3 فيديوهات و3 مقاطع صوتية. إضافة فيديوهات لا تقلّل عدد الصور المسموح به.

تستخدم جميع النماذج 720p افتراضيًا، لكن يجب مع ذلك توفير resolution. القيمة الافتراضية لمفتاح الصوت هي true؛ ولا يؤثر هذا المفتاح ولا الصوت المرجعي في السعر. يتطلب إنشاء الفيديو من المراجع صورة واحدة أو فيديو واحدًا على الأقل؛ ولا تُدعم الطلبات الصوتية فقط. رفع فيديوهات مرجعية يضاعف تكلفة الإنشاء بغض النظر عن عددها أو مدتها.

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

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

تُرجع جميع النماذج 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": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

قيم الحالة

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

وقت المعالجة

يتراوح وقت المعالجة المعتاد بين دقيقتين و6 دقائق، حسب المدة والدقة.

استعلم كل 5-10 ثوانٍ للتحقق من الحالة.

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

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