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

API کے ذریعے دستیابتیاریویڈیو

API ماڈل ID

topaz-video-upscale

اِن پٹس

file

Files API

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

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

per_input_second · 1x_or_2x=8 · 4x=14 · ⌈total⌉

صلاحیت

ویڈیو

بلنگ

METERED

پرامپٹ کی حد

پرامپٹ کی کوئی دستاویزی حد نہیں

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

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

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

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

کلید	قسم	ضروری	طے شدہ	حد	اختیارات	وضاحت
upscale_factor	select	نہیں	2	-	1, 2, 4	اپ اسکیل فیکٹر

اپ لوڈ پالیسی

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

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

ماخذ ویڈیو: Rivya زیادہ سے زیادہ 10MB کی ایک MP4، MOV یا MKV فائل قبول کرتا ہے؛ upstream انٹرفیس 50MB کی اجازت دیتا ہے، اس لیے Rivya کی حد سخت ہے۔

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

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

video

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

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

kind	زیادہ سے زیادہ حجم	MIME اقسام
video	10 MB	video/mp4, video/quicktime, video/x-matroska

کم سے کم درخواست

{
  "model": "topaz-video-upscale",
  "params": {
    "upscale_factor": "2"
  }
}

حوالہ جاتی فائل کی درخواست

{
  "model": "topaz-video-upscale",
  "params": {
    "upscale_factor": "2",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api"
      }
    ]
  }
}

تخلیقی جواب

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

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

Topaz Video Upscaler API انضمام