Topaz Video Upscaler API -integraatio
Käytä mallia Topaz Video Upscaler Rivya Public API v1:n kautta malli-ID:llä topaz-video-upscale; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.
topaz-video-upscale
file
Vaaditaan referenssimoodeissa
per_input_second · 1x_or_2x=8 · 4x=14 · ⌈total⌉
Video
METERED
Dokumentoitu prompt-raja puuttuu
Pyyntösopimus
Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.
| Avain | Tyyppi | Pakollinen | Oletus | Kuvaus |
|---|---|---|---|---|
| model | string | Kyllä | topaz-video-upscale | Käytä topaz-video-upscale-arvoa API-malli-ID:nä. |
| prompt | string | Ei | - | Prompt-teksti malleille, jotka tukevat tekstisyötettä. |
| params | object | Ei | - | Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin. |
| client_request_id | string | Ei | - | Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi. |
Malliparametrit
| Avain | Tyyppi | Pakollinen | Oletus | Alue | Vaihtoehdot | Kuvaus |
|---|---|---|---|---|---|---|
| upscale_factor | select | Ei | 2 | - | 1, 2, 4 | Skaalauskerroin |
Latauskäytäntö
Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.
Lähdevideo: Rivya hyväksyy yhden enintään 10MB:n MP4-, MOV- tai MKV-tiedoston; upstream-rajapinta sallii 50MB, joten Rivyan raja on tiukempi.
1
video
Video- ja äänireferenssien pitäisi kantaa /api/v1/files-reitin durationToken-arvoa, kun keston varmennus vaaditaan.
| kind | Enimmäiskoko | MIME-tyypit |
|---|---|---|
| video | 10 MB | video/mp4, video/quicktime, video/x-matroska |
Minimipyyntö
{
"model": "topaz-video-upscale",
"params": {
"upscale_factor": "2"
}
}Referenssitiedostopyyntö
{
"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"
}
]
}
}Create-vastaus
Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.
{
"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
}Yleiset virheet
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Jotkin moodit vaativat Files API -referenssilatauksia.
