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

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

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

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

seedance-2

المدخلات

text

Files API

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

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

per_input_and_output_second · 720p_without_video=41 · 1080p_with_video=62 · 1080p_without_video=102 · 4K_with_video=128 · 4K_without_video=208 · ⌈total⌉

القدرة

فيديو

الفوترة

METERED

حد prompt

20000 أحرف

عقد الطلب

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

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

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

المفتاحالنوعمطلوبالافتراضيالنطاقالخياراتالوصف
seedance_sceneselectلاtext-text, frames, referenceيحدد أي مسار Seedance 2 يتم تشغيله: نص خالص إلى فيديو، أو توجيه بالإطار الأول / الإطار الأول والأخير، أو توليد بمرجع متعدد الوسائط.
resolutionselectلا720p-720p, 1080p, 4Kالدقة
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",
  "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"
  }
}

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

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

{
  "id": "task_seedance_2_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 205,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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

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