وثائق Rivya AI
صفحات API للنماذج

دمج API لنموذج Seedance 2.0 Fast

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

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

seedance-2-fast

المدخلات

text

Files API

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

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

140

القدرة

فيديو

الفوترة

FIXED

حد prompt

2500 أحرف

عقد الطلب

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

المفتاحالنوعمطلوبالافتراضيالوصف
modelstringنعمseedance-2-fastاستخدم معرف نموذج API وهو seedance-2-fast.
promptstringنعم-الحد الأقصى لهذا النموذج هو 2500 حرفا.
paramsobjectلا-كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_idstringلا-معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

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

المفتاحالنوعمطلوبالافتراضيالنطاقالخياراتالوصف
seedance_sceneselectلاtext-text, frames, referenceيحدد أي مسار Seedance 2 Fast يتم تشغيله: نص خالص إلى فيديو، أو توجيه بالإطار الأول / الإطار الأول والأخير، أو توليد بمرجع متعدد الوسائط.
resolutionselectلا720p-480p, 720pالدقة
aspect_ratioselectلا16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveنسبة العرض إلى الارتفاع
durationnumberلا5min 4 / max 15-المدة
generate_audioselectلاtrue-true, falseتوليد الصوت
return_last_frameselectلاfalse-false, trueيعيد أيضا الإطار النهائي كصورة ثابتة، وهذا مفيد للأغلفة، أو تشغيلات المتابعة، أو التحرير اللاحق.
web_searchselectلاfalse-false, trueبحث الويب
nsfw_checkerselectلاfalse-false, trueفاحص NSFW

الطلب الأدنى

{
  "model": "seedance-2-fast",
  "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_fast_example",
  "status": "queued",
  "model": "seedance-2-fast",
  "reserved_credits": 140,
  "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

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