Video Upscale
Upscale and frame-interpolate existing videos, up to 4K.
The video upscale endpoint takes an existing video and returns a higher-resolution, frame-interpolated copy. This is enhancement, not editing — the content of the clip is unchanged and there is no prompt. To restyle or transform a clip with a prompt, use Video Editing instead.
It lives on a dedicated route alongside video generation, with its own request shape and pricing.
| Endpoint | Description |
|---|---|
POST /v2/videos/upscale | Upscale and frame-interpolate footage with Topaz. |
Like generation, this endpoint returns immediately with a jobId, deducts credits at submission, emits the same webhook events, and refunds on failure.
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model identifier — "topaz-video-upscale". |
topazVideoParams | object | Yes | Source video and output settings. See Topaz Video Upscale for every field. |
webhookUrl | string | No | URL to receive webhook notifications. |
webhookEvents | string[] | No | Events to subscribe to: "progress", "completed", "failed". |
There is no top-level prompt — upscaling is not prompt-driven.
Idempotency
Include an Idempotency-Key header to prevent duplicate jobs if the same request is sent twice.
Response
Status: 202 Accepted
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "QUEUED"
}Poll GET /v2/jobs/:id — the completed job carries videoUrl on result (CDN-hosted with the standard 90-day retention).
Available models
| Model | Identifier | Description |
|---|---|---|
| Topaz Video Upscale | "topaz-video-upscale" | Pro-grade video upscale and frame interpolation, up to 4K / 60 fps. |
Error responses
| Status | Error | Meaning |
|---|---|---|
400 | Validation error | Invalid parameters — check details. |
401 | Unauthorized | Missing or invalid API key. |
402 | Insufficient credits | Not enough credits to run this model. |
503 | Service unavailable | Job queue is temporarily down. |