curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tencent-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "tencent-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 120,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 3.264,
"user_group": "default"
}
}Tencent Video Upscale
- Tencent Video Upscale (tencent-video-upscale) enhances existing videos and upscales them to
720p,1080p,2k, or4k - Offers 7 enhancement styles for live-action footage, animation, small faces in distant shots, facial fidelity, stronger detail, and softer results
- Preserves the source frame rate by default (
model_params.max_fps: "source"); use"30","60", or"120"to set a cap. Only reduces frame rate; does not interpolate frames - Billed by video duration. See EvoLink model pricing for prices at different resolutions and output frame rates
- Asynchronous processing: use the returned task ID to query task status
- Tasks cannot be canceled after submission
- Enhanced video URLs are valid for 24 hours. Save your video promptly
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tencent-video-upscale",
"video_urls": [
"https://example.com/my-video.mp4"
]
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "tencent-video-upscale",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 120,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 3.264,
"user_group": "default"
}
}Authorizations
All APIs require Bearer Token authentication
Get API Key:
Visit API Key Management Page to get your API Key
Add to request header:
Authorization: Bearer YOUR_API_KEY
Body
Video upscaling model name
tencent-video-upscale "tencent-video-upscale"
Input video URL list
Notes:
- Only
1video 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:
60seconds - Maximum source resolution: 4K (short side no greater than
2160pixels) - On submission, the server reads the video duration, resolution, and frame rate. A read failure returns
video_probe_failed
1 element["https://example.com/my-video.mp4"]
Enhancement style. Choose based on the video content
Options:
realistic- General realistic: live-action footage and other typical scenes — defaultrealistic_distant- Realistic, distant shots: optimized for small faces in distant footageanimation- General animation: animation, anime, and cartoonsanimation_distant- Animation, distant shots: optimized for small faces in animated scenes with distant charactersface_fidelity- Facial fidelity: preserves the original facial features as much as possibledetail_boost- Detail enhancement: makes textures and edges more pronouncedsoft- Soft: lighter sharpening for a more natural look
Case-insensitive. Invalid values are rejected
realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft "realistic"
Target resolution, measured by the video's short side
Options:
720p- Short side of720pixels1080p- Short side of1080pixels — default2k- Short side of1440pixels4k- Short side of2160pixels
Notes:
- The target resolution cannot be lower than the source. For example, a
1080psource can use1080p,2k, or4k;720pis rejected - Choosing the lowest tier that is at least as high as the source keeps the image size largely unchanged
720p, 1080p, 2k, 4k "1080p"
Model-specific parameters
Show child attributes
Show child attributes
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
2048characters
Callback Mechanism:
- Timeout:
10seconds - Maximum
3retries after failure (at1/2/4seconds after failure) - Callback response format is consistent with task query API
- 2xx status code is considered successful, other codes trigger retry
"https://your-domain.com/webhooks/video-task-completed"
Response
Video enhancement task created successfully
Task creation timestamp
1757169743
Task ID
"task-unified-1757169743-7cvnl5zw"
Actual model name used
"tencent-video-upscale"
Task type
video.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Video task details
Show child attributes
Show child attributes
Task output type
text, image, audio, video "video"
Usage and billing information
Show child attributes
Show child attributes