Skip to main content
POST
/
v1
/
ai
/
video-upscaler-precision
Video Upscaler Precision - Upscale video
curl --request POST \
  --url https://api.freepik.com/v1/ai/video-upscaler-precision \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "video": "<string>",
  "resolution": "2k",
  "fps_boost": false,
  "sharpen": 0,
  "smart_grain": 0,
  "strength": 60,
  "webhook_url": "<string>"
}
'
{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "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
​
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
​
fps_boost
boolean
default:false

Enable FPS boost to increase the frame rate of the upscaled video. When enabled, the strength parameter is ignored and the fully upscaled result is returned.

​
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
​
strength
integer
default:60

Strength of the upscaling effect. Controls how much the output differs from the original video. A value of 0 returns the original video, 100 returns the fully upscaled result. Intermediate values blend the original with the upscaled result. This parameter is ignored when fps_boost is enabled. Default is 60.

Required range: 0 <= x <= 100
​
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 - Task created. The X-Frames-Billed header indicates the number of frames billed for B2B users.

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