صفحات 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.
| المفتاح | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| model | string | نعم | seedance-2 | استخدم معرف نموذج API وهو seedance-2. |
| prompt | string | نعم | - | الحد الأقصى لهذا النموذج هو 20000 حرفًا. |
| params | object | لا | - | كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها. |
| client_request_id | string | لا | - | معرف اختياري من جهة العميل لتتبع الطلبات في نظامك. |
معلمات النموذج
| المفتاح | النوع | مطلوب | الافتراضي | النطاق | الخيارات | الوصف |
|---|---|---|---|---|---|---|
| seedance_scene | select | لا | text | - | text, frames, reference | يحدد أي مسار Seedance 2 يتم تشغيله: نص خالص إلى فيديو، أو توجيه بالإطار الأول / الإطار الأول والأخير، أو توليد بمرجع متعدد الوسائط. |
| resolution | select | لا | 720p | - | 720p, 1080p, 4K | الدقة |
| 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"
}
}استجابة الإنشاء
تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.
{
"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
تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.
