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

دمج API لنموذج Wan Animate Replace

استخدم Wan Animate Replace عبر Rivya Public API v1 مع معرف النموذج wan-2-2-animate-replace، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

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

wan-2-2-animate-replace

المدخلات

url

Files API

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

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

20

القدرة

فيديو

الفوترة

FIXED

حد prompt

لا يوجد حد prompt موثق

عقد الطلب

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

المفتاحالنوعمطلوبالافتراضيالوصف
modelstringنعمwan-2-2-animate-replaceاستخدم معرف نموذج API وهو wan-2-2-animate-replace.
promptstringلا-نص prompt للنماذج التي تدعم إدخال النص.
paramsobjectلا-كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_idstringلا-معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

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

المفتاحالنوعمطلوبالافتراضيالنطاقالخياراتالوصف
video_urltextلا---الصق عنوان URL عاما لفيديو يمكن لخدمة الإنشاء جلبه مباشرة. يتوقع هذا النموذج أصلا مستضافا مثل MP4 أو MOV أو MKV، لا مسار رفع محليا.
image_urltextلا---الصق عنوان URL عاما لصورة الاستبدال. تعمل JPEG أو PNG أو WebP بأفضل شكل؛ وعندما تختلف نسبة العرض إلى الارتفاع، ستقوم الخدمة upstream بالتحجيم والقص من المنتصف.
resolutionselectلا480p-480p, 580p, 720pالمستويات الحالية هي `480p` و`580p` و`720p`. تعني مستويات الإخراج الأعلى عادة تكلفة أرصدة أعلى وانتظارا أطول.

الطلب الأدنى

{
  "model": "wan-2-2-animate-replace",
  "params": {
    "video_url": "https://example.com/input.mp4",
    "image_url": "https://example.com/reference.png",
    "resolution": "480p"
  }
}

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

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

{
  "id": "task_wan_2_2_animate_replace_example",
  "status": "queued",
  "model": "wan-2-2-animate-replace",
  "reserved_credits": 20,
  "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

يقبل هذا النموذج إدخال URL عام عبر معلمات النموذج.