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

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

معرف نموذج API

wan-2-7-video

المدخلات

text, file

Files API

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

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

القدرة

فيديو

الفوترة

FIXED

حد prompt

5000 أحرف

عقد الطلب

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

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

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

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

سياسة الرفع

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

قاعدة المرجع

وسائط مرجعية: ارفع حتى أصلين. استخدم ما يصل إلى صورتين لمسار الصورة إلى فيديو، أو فيديو واحدا مع صورة اختيارية واحدة لتحرير الفيديو.

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

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

image, video

Duration token

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

kind	الحد الأقصى للحجم	أنواع MIME
image	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime

الطلب الأدنى

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

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

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

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

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

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "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

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

دمج API لنموذج Wan 2.7 Video