Seedance 2.5 API

مرجع API الكامل لنماذج إنشاء الفيديو Seedance 2.5 من ByteDance.

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

تدعم هذه الواجهة ثلاثة إصدارات:

مقارنة سريعة

نسب الأبعاد المدعومة

يدعم نص إلى فيديو ومراجع إلى فيديو النسب التالية:

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

لا يدعم صورة إلى فيديو المعامل aspect_ratio.

خيارات الدقة

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

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

Seedance 2.5 Image to Video

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

مطلوبة

اختيارية

لا تُضمّن aspect_ratio في طلبات صورة إلى فيديو. هذا النموذج لا يدعم هذا المعامل.

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

javascriptنسخ
{
  model_name: 'seedance-v2.5-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  resolution: '720p',
  duration: 8,
  sound: true
}

Seedance 2.5 Reference to Video

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

مطلوبة

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

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

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

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

مثلًا، إذا كانت الصورة الأولى مرجعًا لشخصية والثانية مرجعًا لمشهد، فاستخدم <<<image_1>>> للشخصية و<<<image_2>>> للمشهد داخل prompt. يجب أن يشير كل عنصر نائب إلى عنصر موجود في المصفوفة المقابلة.

اختيارية

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

javascriptنسخ
{
  model_name: 'seedance-v2.5-reference-to-video',
  prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere',
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

مثال لطلب مراجع إلى فيديو باستخدام @ (AT)

javascriptنسخ
{
  model_name: 'seedance-v2.5-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>>>',
  resolution: '720p',
  duration: 10,
  aspect_ratio: '16:9',
  sound: true,
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.png'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

حدود الوسائط

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

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

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

وقت المعالجة

يختلف وقت المعالجة حسب المدة والدقة وحالة قائمة الانتظار الحالية.

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

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

1. المعاملات المطلوبة: أرسل resolution وduration دائمًا، وأرسل aspect_ratio لنص إلى فيديو ومراجع إلى فيديو
2. نسبة أبعاد صورة إلى فيديو: لا ترسل aspect_ratio في طلبات صورة إلى فيديو
3. الفيديوهات المرجعية: الفيديوهات اختيارية؛ يجب أن تظل مدة كل فيديو ومجموع مدد الفيديوهات ضمن الحدود الموثقة
4. الصور المرجعية: الصور اختيارية ومستقلة عن الفيديوهات والصوت؛ أرسل حتى 30 عنوان URL لصور مدعومة
5. الصوت المرجعي: اجعل مدة كل مقطع 2-30 ثانية وحجمه لا يتجاوز 15 MB، مع مجموع مدد لا يتجاوز 30 ثانية
6. ترتيب المراجع: رتّب images وvideos وaudios كما تريد، وأشر إليها باتساق في الوصف
7. الصوت: احذف sound لاستخدام القيمة الافتراضية true، أو اضبطه على false لتعطيل إنشاء الصوت