4K Upscale

POST /v1/upscale

Upscale a rendered video to 4K (3840x2160) resolution using AI-enhanced upscaling. This works on any video URL, including output from previous render jobs.

Request

Field	Type	Required	Description
src	string	Yes	URL of the source video to upscale
output	object	No	Output options (format defaults to source format)
callback	string	No	Webhook URL

Example

curl

curl -X POST https://api.vidiking.com/v1/upscale \
  -H "Authorization: Bearer $VIDIKING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "src": "https://cdn.vidiking.com/renders/job_abc123.mp4",
    "output": {
      "format": "mp4",
      "quality": "high"
    }
  }'

Node.js

const { jobId } = await client.upscale({
  src: 'https://cdn.vidiking.com/renders/job_abc123.mp4',
  output: { format: 'mp4', quality: 'high' },
});

// Poll for completion
const job = await client.pollJob(jobId);
console.log('4K output:', job.url);

Python

result = client.upscale({
    "src": "https://cdn.vidiking.com/renders/job_abc123.mp4",
    "output": {"format": "mp4", "quality": "high"},
})

# Poll for completion
job = client.poll_job(result.job_id)
print("4K output:", job.url)

Response

{
  "id": "job_upscale_012",
  "status": "QUEUED",
  "created_at": "2025-01-15T10:30:00Z"
}

Two-Step Workflow: Render + Upscale

Render at HD first (faster, cheaper), then upscale to 4K.

// Step 1: Render at HD
const render = await client.render({
  timeline: { /* your timeline */ },
  output: { format: 'mp4', resolution: 'hd' },
});
const renderJob = await client.pollJob(render.jobId);

// Step 2: Upscale to 4K
const upscale = await client.upscale({
  src: renderJob.url,
  output: { format: 'mp4', quality: 'high' },
});
const upscaleJob = await client.pollJob(upscale.jobId);

console.log('4K output:', upscaleJob.url);

Cost

Upscale operations cost 1$0.14 per job.

Notes

• Source video should be at least 720p for best results.
• Upscaling is not instant -- expect processing time of 2-5x the video duration.
• The upscaler works best on rendered content. Heavily compressed or low-quality sources may not improve significantly.
• Maximum source duration for upscaling is 10 minutes.