Gunakan Topaz Video Upscaler melalui Rivya Public API v1 dengan ID model topaz-video-upscale, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanVideo

ID model API

topaz-video-upscale

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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

Keupayaan

Video

Bil

METERED

Had prompt

Tiada had prompt didokumenkan

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	topaz-video-upscale	Gunakan ID model API topaz-video-upscale.
prompt	string	Tidak	-	Teks prompt untuk model yang menyokong input teks.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
upscale_factor	select	Tidak	2	-	1, 2, 4	Faktor upscale

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Video sumber: Rivya menerima satu fail MP4, MOV atau MKV sehingga 10MB; antara muka upstream membenarkan 50MB, jadi had Rivya lebih ketat.

Fail maksimum

Jenis fail diterima

video

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
video	10 MB	video/mp4, video/quicktime, video/x-matroska

Permintaan minimum

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

Permintaan fail rujukan

{
  "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"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

{
  "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
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Topaz Video Upscaler