Skip to main content
POST
/
v1
/
ai
/
video-upscaler
Video Upscaler - Upscale video
curl --request POST \
  --url https://api.freepik.com/v1/ai/video-upscaler \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "video": "<string>",
  "creativity": 0,
  "resolution": "2k",
  "premium_quality": false,
  "fps_boost": false,
  "sharpen": 0,
  "smart_grain": 0,
  "turbo": false,
  "flavor": "vivid",
  "webhook_url": "<string>"
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
video
string
required

Source video to upscale. Accepts either:

  • A publicly accessible HTTPS URL pointing to the video
  • A base64-encoded video string
​
creativity
integer
default:0

Creativity intensity. Controls how much creative freedom is applied during upscaling. Valid values range from 0 (no creativity) to 100 (maximum creativity). Default is 0.

Required range: 0 <= x <= 100
​
resolution
enum<string>
default:2k

Output resolution for the video upscaling:

  • 1k: Standard definition output
  • 2k: High definition output (default)
  • 4k: Ultra high definition output
Available options:
1k,
2k,
4k
​
premium_quality
boolean
default:false

Enable premium quality enhancement for the upscaled video.

​
fps_boost
boolean
default:false

Enable FPS boost to increase the frame rate of the upscaled video.

​
sharpen
integer
default:0

Video sharpness intensity control. Higher values increase edge definition and clarity. Valid values range from 0 (no sharpening) to 100 (maximum sharpness). Default is 0.

Required range: 0 <= x <= 100
​
smart_grain
integer
default:0

Applies a film grain effect to the output video. Helps preserve natural film grain and texture detail. Valid values range from 0 (no grain) to 100 (maximum grain). Default is 0.

Required range: 0 <= x <= 100
​
turbo
boolean
default:false

Enables faster upscaling, reducing processing time and cost by up to 50%, with a slight trade-off in output quality.

​
flavor
enum<string>
default:vivid

Video processing flavor that determines the upscaling style:

  • vivid: Enhanced colors and contrast for more vibrant output
  • natural: Preserves original colors and natural appearance
Available options:
vivid,
natural
​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications when the upscaling task completes. The webhook will be called with the task status and the upscaled video URL.

Response

OK - The task exists and the status is returned

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}