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

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

معرف نموذج API

wan-2-5-video

المدخلات

text, file

Files API

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

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

per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉

القدرة

فيديو

الفوترة

FIXED

حد prompt

800 أحرف

عقد الطلب

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

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

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

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
resolution	select	لا	720p	-	720p, 1080p	الدقة
duration	select	لا	5	-	5, 10	المدة
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1	نسبة العرض إلى الارتفاع
enable_prompt_expansion	select	لا	false	-	false, true	لأن Wan 2.5 مخصص لمقاطع قصيرة لكنها موجهة بدرجة واضحة. عندما تقارن تنويعات اللقطة نفسها، تساعدك البذرة على البقاء أقرب إلى خيار قابل للتكرار، وتساعد المطالبة السلبية على إزالة أنماط الفشل الشائعة، ويتيح توسيع المطالبة لك أن تقرر هل تبقى حرفيا أم تدع النموذج يضيف تفصيلا. هذه المجموعة مفيدة حتى عندما يكون المقطع 5 أو 10 ثوان فقط، ما دام الاتجاه محددا بالفعل.
seed	number	لا	-	min 0 / max 2147483647	-	اتركه فارغا للحصول على نتيجة عشوائية جديدة في كل مرة. إعادة استخدام العدد الصحيح نفسه تسهّل إعادة إنتاج نتيجة سابقة أو ضبطها. تكون النتيجة أقرب فقط عندما يبقى الموجّه والإعدادات الرئيسية الأخرى متشابهة أيضا، ولا يضمن ذلك تطابقا 1:1.
negative_prompt	text	لا	-	-	-	المطالبة السلبية

سياسة الرفع

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

قاعدة المرجع

صورة مرجعية: ارفع حتى ملف صورة واحد لوضع الصورة إلى فيديو.

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

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

image

Duration token

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

kind	الحد الأقصى للحجم	أنواع MIME
image	10 MB	image/jpeg, image/png, image/webp

الطلب الأدنى

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "استبعادات اختيارية أو أنماط فشل يجب تجنبها."
  }
}

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

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "استبعادات اختيارية أو أنماط فشل يجب تجنبها.",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_wan_2_5_video_example",
  "status": "queued",
  "model": "wan-2-5-video",
  "reserved_credits": 60,
  "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 لنموذج Wan 2.5 Video