استخدم Seedance 2.0 عبر Rivya Public API v1 مع معرف النموذج seedance-2، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

متاح عبر APIإدخال النص جاهزفيديو

معرف نموذج API

seedance-2

المدخلات

text

Files API

غير مطلوب للطلب الأدنى

الرصيد الأساسي

175

القدرة

فيديو

الفوترة

FIXED

حد prompt

2500 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	seedance-2	استخدم معرف نموذج API وهو seedance-2.
prompt	string	نعم	-	الحد الأقصى لهذا النموذج هو 2500 حرفا.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
seedance_scene	select	لا	text	-	text, frames, reference	يحدد أي مسار Seedance 2 يتم تشغيله: نص خالص إلى فيديو، أو توجيه بالإطار الأول / الإطار الأول والأخير، أو توليد بمرجع متعدد الوسائط.
resolution	select	لا	720p	-	480p, 720p	الدقة
aspect_ratio	select	لا	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	نسبة العرض إلى الارتفاع
duration	number	لا	5	min 4 / max 15	-	المدة
generate_audio	select	لا	true	-	true, false	توليد الصوت
return_last_frame	select	لا	false	-	false, true	يعيد أيضا الإطار النهائي كصورة ثابتة، وهذا مفيد للأغلفة، أو تشغيلات المتابعة، أو التحرير اللاحق.
web_search	select	لا	false	-	false, true	بحث الويب
nsfw_checker	select	لا	false	-	false, true	فاحص NSFW

الطلب الأدنى

{
  "model": "seedance-2",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

استجابة الإنشاء

يعيد endpoint الإنشاء معرف مهمة عاما. استعلم عن endpoint الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_seedance_2_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 175,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found