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

متاح عبر APIالنص أو URL جاهز؛ تستخدم أوضاع المراجع Files APIفيديو

معرف نموذج API

seedance-2-5

المدخلات

text, file

Files API

مطلوب لأوضاع المراجع

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

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

القدرة

فيديو

الفوترة

METERED

حد prompt

30000 أحرف

عقد الطلب

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

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

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

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

سياسة الرفع

ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.

قاعدة المرجع

إطارات إرشادية أو مراجع عالية السعة: يقبل مشهد الإطارات صورة واحدة (1) أو صورتين (2) بتنسيق JPEG أو PNG أو WebP أو BMP أو GIF أو TIFF وبحجم يصل إلى 30 MB لكل صورة. ويقبل مشهد المرجع حتى 30 صورة، و10 فيديوهات MP4/MOV بحجم يصل إلى 95 MB ومدة 2-30 ثانية لكل منها، و10 ملفات صوت MP3/WAV بحجم يصل إلى 15 MB ومدة 2-30 ثانية لكل منها؛ ويبلغ حد مجموع مدة كل من الفيديو والصوت 30 ثانية، وحد جميع الوسائط معا 50 ملفا.

الحد الأقصى للملفات

أنواع الملفات المقبولة

image, video, audio

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

kind	الحد الأقصى للحجم	أنواع MIME
image	30 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

الطلب الأدنى

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

طلب بملف مرجعي

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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

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

{
  "id": "task_seedance_2_5_example",
  "status": "queued",
  "model": "seedance-2-5",
  "reserved_credits": 315,
  "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

تتطلب بعض الأوضاع رفع مراجع عبر Files API.

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