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

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

معرف نموذج API

wan-3-0-video

المدخلات

text, file

Files API

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

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

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

القدرة

فيديو

الفوترة

METERED

حد prompt

20000 أحرف

عقد الطلب

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

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

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

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
seedance_scene	select	لا	text	-	text, frames, reference	اختر عقد إدخال واحدًا متنافيًا قبل رفع الوسائط.
variant	select	لا	standard	-	standard, prime	يستخدم Standard وPrime عناصر التحكم نفسها لكن بأسعار مختلفة لكل ثانية.
resolution	select	لا	1080P	-	480P, 720P, 1080P	الحجز يساوي معدل الإصدار والدقة مضروبًا في مجموع ثواني فيديو الإدخال المتحقق منها وثواني الإخراج المحجوزة، مع تقريب الإجمالي إلى الأعلى مرة واحدة. تحجز المدة الذكية 30 ثانية إخراج ولا تُستخدم مع فيديو مرجعي.
aspect_ratio	select	لا	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	اختر تأطيرًا تكيفيًا أو نسبة إخراج ثابتة واحدة.
duration	number	لا	5	min -1 / max 30 / step 1	-	اختر -1 للمدة الذكية أو عددًا صحيحًا من 2 إلى 30 ثانية. تحجز المدة الذكية 30 ثانية إخراج، ولا يمكن استخدامها مع فيديو مرجعي.
audio	select	لا	true	-	true, false	اختر ما إذا كان الفيديو المنشأ سيتضمن صوتًا أنشأه النموذج.
seed	number	لا	-	min 0 / max 2147483647 / step 1	-	اتركه فارغا للحصول على نتيجة عشوائية جديدة في كل مرة. إعادة استخدام العدد الصحيح نفسه تسهّل إعادة إنتاج نتيجة سابقة أو ضبطها. تكون النتيجة أقرب فقط عندما يبقى الموجّه والإعدادات الرئيسية الأخرى متشابهة أيضا، ولا يضمن ذلك تطابقا 1:1.

سياسة الرفع

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

قاعدة المرجع

إطارات توجيه أو مراجع متعددة الوسائط موقعة: يقبل وضع الإطارات صورة أولى إلزامية واحدة وصورة أخيرة اختيارية واحدة. ويقبل وضع المراجع حتى 10 صور JPEG أو PNG بلا شفافية أو WebP أو BMP بحجم 20 MB لكل صورة، و5 مقاطع فيديو MP4/MOV بحجم 95 MB ومدة 1–15 ثانية لكل مقطع، و5 مقاطع صوت MP3/WAV بحجم 15 MB ومدة 1–15 ثانية لكل مقطع؛ ويقتصر إجمالي مدة الفيديو والصوت كل على حدة على 15 ثانية.

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

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

image, video, audio

Duration token

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

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

الطلب الأدنى

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

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

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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

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

{
  "id": "task_wan_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "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 3.0 Video