Skip to main content
POST

Authorizations

Authorization
string
header
required

All APIs require Bearer Token authentication

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Body

application/json
model
enum<string>
default:tencent-video-upscale
required

Video upscaling model name

Available options:
tencent-video-upscale
Example:

"tencent-video-upscale"

video_urls
string<uri>[]
required

Input video URL list

Notes:

  • Only 1 video is supported per request (if more are provided, only the first is used)
  • The video URL must be directly accessible by the server (public or presigned URL)
  • Supported formats: .mp4, .mov
  • Maximum duration: 60 seconds
  • Maximum source resolution: 4K (short side no greater than 2160 pixels)
  • On submission, the server reads the video duration, resolution, and frame rate. A read failure returns video_probe_failed
Required array length: 1 element
Example:
mode
enum<string>
default:realistic

Enhancement style. Choose based on the video content

Options:

  • realistic - General realistic: live-action footage and other typical scenes — default
  • realistic_distant - Realistic, distant shots: optimized for small faces in distant footage
  • animation - General animation: animation, anime, and cartoons
  • animation_distant - Animation, distant shots: optimized for small faces in animated scenes with distant characters
  • face_fidelity - Facial fidelity: preserves the original facial features as much as possible
  • detail_boost - Detail enhancement: makes textures and edges more pronounced
  • soft - Soft: lighter sharpening for a more natural look

Case-insensitive. Invalid values are rejected

Available options:
realistic,
realistic_distant,
animation,
animation_distant,
face_fidelity,
detail_boost,
soft
Example:

"realistic"

quality
enum<string>
default:1080p

Target resolution, measured by the video's short side

Options:

  • 720p - Short side of 720 pixels
  • 1080p - Short side of 1080 pixels — default
  • 2k - Short side of 1440 pixels
  • 4k - Short side of 2160 pixels

Notes:

  • The target resolution cannot be lower than the source. For example, a 1080p source can use 1080p, 2k, or 4k; 720p is rejected
  • Choosing the lowest tier that is at least as high as the source keeps the image size largely unchanged
Available options:
720p,
1080p,
2k,
4k
Example:

"1080p"

model_params
object

Model-specific parameters

callback_url
string<uri>

HTTPS callback URL for task completion

Callback Timing:

  • Triggered when task is completed, failed, or cancelled
  • Sent after billing confirmation

Security Restrictions:

  • HTTPS protocol only
  • Internal IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • URL length must not exceed 2048 characters

Callback Mechanism:

  • Timeout: 10 seconds
  • Maximum 3 retries after failure (at 1/2/4 seconds after failure)
  • Callback response format is consistent with task query API
  • 2xx status code is considered successful, other codes trigger retry
Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video enhancement task created successfully

created
integer

Task creation timestamp

Example:

1757169743

id
string

Task ID

Example:

"task-unified-1757169743-7cvnl5zw"

model
string

Actual model name used

Example:

"tencent-video-upscale"

object
enum<string>

Task type

Available options:
video.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object

Video task details

type
enum<string>

Task output type

Available options:
text,
image,
audio,
video
Example:

"video"

usage
object

Usage and billing information