Wan 2.7 Video کو Rivya Public API v1 کے ذریعے ماڈل ID wan-2-7-video، معاون اِن پٹس، پیرامیٹرز، Files API قواعد، کریڈٹس اور جواب کی مثالوں کے ساتھ استعمال کریں۔

API کے ذریعے دستیابمتن یا URL تیار؛ حوالہ جاتی طریقے Files API استعمال کرتے ہیںویڈیو

API ماڈل ID

wan-2-7-video

اِن پٹس

text, file

Files API

حوالہ جاتی طریقوں کے لیے ضروری

بنیادی کریڈٹس

per_output_second · 720p=16 · 1080p=24 · ⌈total⌉

صلاحیت

ویڈیو

بلنگ

FIXED

پرامپٹ کی حد

5000 حروف

درخواست کا معاہدہ

`model` ID کو بالائی سطح پر بھیجیں۔ ماڈل کے مخصوص کنٹرولز `params` میں رہتے ہیں۔

کلید	قسم	ضروری	طے شدہ	وضاحت
model	string	ہاں	wan-2-7-video	API ماڈل ID کے طور پر wan-2-7-video استعمال کریں۔
prompt	string	ہاں	-	اس ماڈل کے لیے زیادہ سے زیادہ 5000 حروف۔
params	object	نہیں	-	ماڈل کا مخصوص پیرامیٹر آبجیکٹ۔ اجازت یافتہ کلیدوں کے لیے نیچے والی قطاریں دیکھیں۔
client_request_id	string	نہیں	-	اپنے نظام میں درخواستوں کا سراغ رکھنے کے لیے اختیاری صارف طرفہ ID۔

ماڈل پیرامیٹرز

کلید	قسم	ضروری	طے شدہ	حد	اختیارات	وضاحت
resolution	select	نہیں	720p	-	720p, 1080p	Resolution
duration	number	نہیں	5	min 0 / max 15	-	text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s
aspect_ratio	select	نہیں	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Text-to-video اور video-editing runs اسے directly use کرتے ہیں۔ Image-to-video فی الحال separate aspect-ratio switch expose کرنے کے بجائے uploaded frame geometry follow کرتا ہے۔
negative_prompt	text	نہیں	-	-	-	prompt ≤ 5000; negative_prompt ≤ 500
prompt_extend	select	نہیں	true	-	true, false	یہ control کرتا ہے کہ model generation سے پہلے آپ کا prompt rewrite کرے یا نہیں۔ Convenience کے لیے اسے on رکھیں، یا جب آپ کے پاس بہت precise prompt ہو تو off کریں۔
watermark	select	نہیں	false	-	false, true	Watermark
audio_setting	select	نہیں	auto	-	auto, origin	Video-edit path میں audio کیسے handle ہو گی، یہ control کرتا ہے۔ Auto model کو decide کرنے دیتا ہے، جبکہ Keep original source video's audio preserve کرنے کی کوشش کرتا ہے۔
seed	number	نہیں	-	min 0 / max 2147483647	-	ہر بار نیا بے ترتیب نتیجہ چاہیے ہو تو اسے خالی چھوڑیں۔ اسی عدد صحیح کو دوبارہ استعمال کرنے سے پچھلا نتیجہ دوبارہ بنانا یا باریک بہتر کرنا آسان ہوتا ہے۔ نتیجہ صرف اسی وقت زیادہ قریب رہتا ہے جب پرامپٹ اور دیگر اہم ترتیبات بھی ملتی جلتی رہیں، اور یہ 1:1 مماثلت کی ضمانت نہیں۔

اپ لوڈ پالیسی

حوالہ جاتی فائلیں پہلے اپ لوڈ کریں، پھر واپس ملنے والا URL اور دورانیے کا ٹوکن `params.referenceMediaItems` میں رکھیں۔

حوالے کا قاعدہ

Reference media: Reference media: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

زیادہ سے زیادہ فائلیں

قبول شدہ فائل اقسام

image, video

دورانیے کا ٹوکن

دورانیے کی تصدیق ضروری ہو تو ویڈیو اور آڈیو حوالوں کو /api/v1/files سے ملنے والا `durationToken` ساتھ رکھنا چاہیے۔

kind	زیادہ سے زیادہ حجم	MIME اقسام
image	30 MB	image/jpeg, image/png, image/webp
video	30 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": "negative_prompt ≤ 500",
    "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": "negative_prompt ≤ 500",
    "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"
      }
    ]
  }
}

تخلیقی جواب

تخلیقی اینڈ پوائنٹ عوامی کام کی ID واپس کرتا ہے۔ کام کے کامیاب یا ناکام ہونے تک حالت والے اینڈ پوائنٹ سے جانچتے رہیں۔

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "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 حوالہ جاتی اپ لوڈز درکار ہوتے ہیں۔

Wan 2.7 Video API انضمام