Seedance 2.5 Flash

أنشئ مقاطع فيديو مدتها ٤–٣٠ ثانية بدقة 480p أو 720p انطلاقًا من نص أو إطار أول/أخير أو مراجع متعددة الوسائط، أو حرّر فيديو مصدرًا واحدًا.

يدعم Seedance 2.5 Flash تحويل النص إلى فيديو، والتوليد باستخدام الإطار الأول/الأخير، والتوليد بالمراجع، وتحرير الفيديو. استخدم dreamina-seedance-2-5-flash مع فئة Default. أرسل الوسائط عبر عناوين URL عامة ببروتوكول HTTP أو HTTPS دون بيانات اعتماد. احفظ معرّف المهمة المُعاد واستعلم عنه للحصول على الفيديو المكتمل.

راجع ساحة التجربة والأسعار المباشرة، ومواصفة OpenAPI، ودليل التسعير.

مثال سريع

ينشئ هذا الطلب فيديو مدته أربع ثوانٍ. راجع السعر الحالي قبل إرساله؛ فتقديم عملية توليد ناجحة يترتب عليه رسم.

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

المعلمات

الحقلان model وcontent مطلوبان. جميع الحقول الأخرى اختيارية. تُرفض قيم null الصريحة والحقول غير المعروفة.

الحقل	النوع	القيمة الافتراضية	القيود
`model`	سلسلة نصية	مطلوب	`dreamina-seedance-2-5-flash`
`content`	مصفوفة	مطلوب	عنصر نصي واحد غير فارغ على الأقل؛ تتطلب عناصر الوسائط دورًا.
`resolution`	سلسلة نصية	`720p`	`480p` أو `720p`.
`duration`	عدد صحيح	`5`، أو `-1` للتحرير	التوليد: ٤–٣٠ ثانية. التحرير: احذف الحقل أو استخدم `-1`؛ يتبع الناتج المصدر.
`ratio`	سلسلة نصية	`16:9`، أو `adaptive` للإطارات/التحرير	التوليد بالنص/المراجع: `16:9`، `9:16`، `1:1`، `4:3`، `3:4`، `21:9`. الإطار الأول/الأخير والتحرير: `adaptive` فقط.
`generate_audio`	قيمة منطقية	`true`	تفعيل الصوت المُولّد أو تعطيله؛ لا يغيّر ذلك السعر.
`omni_reference_task_type`	سلسلة نصية	`generate`	`generate` أو `edit`. يتطلب التحرير فيديو واحدًا بالضبط.
`content_filter`	قيمة منطقية	`true`	تُقبل `true` فقط؛ لا حاجة إلى عنصر تحكم في ساحة التجربة.

الحد الأقصى الموثّق للمطالبات هو ١٠٬٠٠٠ رمز. لم تُحدَّد أداة عامة لتقسيم النص إلى رموز، لذا يجب عدم اعتبار عدد المحارف عددًا دقيقًا للرموز.

المحتوى والأوضاع

يستخدم النص {"type":"text","text":"Describe the shot"}. وتستخدم الصور والفيديوهات والمقاطع الصوتية عنوان URL متداخلًا ودورًا صريحًا:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

الوضع	المحتوى	التأطير والمدة
تحويل النص إلى فيديو	نص فقط	نسبة ثابتة؛ ٤–٣٠ ثانية.
الإطار الأول/الأخير	نص مع صورة `first_frame` واحدة، وصورة `last_frame` واحدة اختيارية	`adaptive`؛ ٤–٣٠ ثانية. يتطلب الإطار الأخير وجود إطار أول.
التوليد بالمراجع	نص مع عناصر `reference_image` أو `reference_video` أو `reference_audio`	نسبة ثابتة؛ ٤–٣٠ ثانية. حتى ١٠ صور و٥ فيديوهات و٥ مقاطع صوتية.
تحرير الفيديو	نص، وعنصر `reference_video` واحد بالضبط، وصور/مقاطع صوتية مرجعية اختيارية؛ نوع المهمة `edit`	`adaptive`؛ تُحذف المدة أو تكون `-1`.

تستخدم عناصر الفيديو type: "video_url" وvideo_url: {"url": "..."} وrole: "reference_video"؛ وتستخدم عناصر الصوت audio_url وreference_audio بالبنية نفسها. لا يمكن الجمع بين الإطار الأول/الأخير والوسائط المرجعية. لا تتوفر عناصر التحكم في المسودة والتمديد و1080p والعلامة المائية والبذرة وإخراج الإطار الأخير في هذا التكامل. ولا تتوفر استدعاءات ردّ.

قيود الوسائط

الوسائط	التنسيقات	الحجم والمدة
صورة	JPEG, PNG, WebP	حتى ٣٠ MB؛ كل ضلع ٣٠٠–٦٬٠٠٠ px؛ نسبة العرض/الارتفاع ٠٫٤–٢٫٥.
فيديو	MP4, MOV	حتى ٢٠٠ MB؛ ٢٤–٦٠ FPS؛ كل ضلع ٣٠٠–٦٬٠٠٠ px؛ النسبة ٠٫٤–٢٫٥؛ ٤٠٩٬٦٠٠–٨٬٢٩٥٬٠٤٤ بكسل. المراجع: ٢–٣٠ ثانية لكل منها، وبحد أقصى ٣٠ ثانية إجمالًا. مصدر التحرير: ٤–٣٠ ثانية.
صوت	WAV, MP3	حتى ١٥ MB؛ ٢–٣٠ ثانية لكل منها، وبحد أقصى ٣٠ ثانية إجمالًا.

يجب أن تكون الملفات قابلة للقراءة قبل الإرسال. تُقاس مدة الفيديو من الوسائط لحساب الرسم. استخدم عناوين URL عامة مستقرة.

استجابة المهمة والاستعلام الدوري

يعيد الإنشاء id وmodel وstatus وcreated_at. استعلم عن المهمة نفسها حتى تكتمل:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

تكون الحالة processing أو completed أو failed. عند النجاح، اقرأ output.video_url للحصول على الفيديو المخزّن. وعند الفشل، اقرأ error.code وerror.message. لا تتضمن الاستجابات العامة التكاليف. لا يثبت انتهاء مهلة الاستعلام الدوري فشل التوليد: احتفظ بمعرّف المهمة واستعلم عنه مجددًا بدلًا من تقديم عملية توليد أخرى.

الفوترة

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

على سبيل المثال، تُفوَّتر عشر ثوانٍ لناتج مدته خمس ثوانٍ مع فيديو مرجعي مدته ثلاث ثوانٍ. وتُفوَّتر عشرون ثانية لتحرير مصدر مدته عشر ثوانٍ. اضرب الثواني المفوترة في السعر المباشر المطبق.

راجع دورة حياة المهمة ورموز الأخطاء للاطلاع على الاستجابات الشائعة وإرشادات إعادة المحاولة.