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
Tencent 视频超分辨率
- Tencent Video Upscale (tencent-video-upscale) 对已有视频做画质增强,并放大到目标清晰度:
720p、1080p、2k或4k - 提供 7 种增强风格,覆盖真人实拍、动画、远景小人脸、人脸保真、细节强化和柔和效果
- 帧率默认沿用原视频(
model_params.max_fps: "source");可设"30"、"60"、"120"作为上限,只降不升,不会补帧 - 按视频时长计费,不同清晰度和输出帧率的价格请以 EvoLink 模型价格 为准
- 异步处理模式,使用返回的任务ID 进行查询
- 任务提交后不可取消
- 增强后的视频链接有效期为24小时,请尽快保存
POST
/
v1
/
videos
/
generations
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"
}
}授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key :
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
application/json
视频超分模型名称
可用选项:
tencent-video-upscale 示例:
"tencent-video-upscale"
输入视频URL列表
注意:
- 每次请求仅支持
1个视频(多传只取第一个) - 视频URL必须可被服务器直接访问(公共URL或预签名URL)
- 支持的格式:
.mp4、.mov - 最长时长:
60秒 - 原视频清晰度最高 4K(短边不超过
2160像素) - 提交时服务器会先读取视频的时长、分辨率和帧率,读取失败会返回
video_probe_failed
Required array length:
1 element示例:
["https://example.com/my-video.mp4"]
增强风格,按视频内容选择
可选项:
realistic- 通用真实:真人实拍等常规画面 — 默认值realistic_distant- 真实 · 远景:远景拍摄,针对画面里的小人脸优化animation- 通用动画:动画、动漫、卡通内容animation_distant- 动画 · 远景:远景角色较多的动画,针对小人脸优化face_fidelity- 人脸保真:尽量保留原视频的人脸特征detail_boost- 细节强化:纹理和边缘细节更明显soft- 柔和:锐化更轻,观感更自然
不区分大小写,无效值会被拒绝
可用选项:
realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft 示例:
"realistic"
目标清晰度,按视频短边计算
可选项:
720p- 短边720像素1080p- 短边1080像素 — 默认值2k- 短边1440像素4k- 短边2160像素
注意:
- 目标清晰度不能低于原视频,例如
1080p的原视频可选1080p、2k、4k,选720p会被拒绝 - 选择不低于原视频的最低一档,画面基本不放大
可用选项:
720p, 1080p, 2k, 4k 示例:
"1080p"
模型特定参数
Show child attributes
Show child attributes
任务完成后的HTTPS回调地址
回调时机:
- 任务完成(completed)、失败(failed)或取消(cancelled)时触发
- 在计费确认完成后发送
安全限制:
- 仅支持HTTPS协议
- 禁止回调到内网IP地址(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等)
- URL长度不超过
2048字符
回调机制:
- 超时时间:
10秒 - 失败后最多重试
3次(会分别在失败的1秒/2秒/4秒后进行重试) - 回调响应体格式与任务查询接口返回的格式一致
- 回调地址若返回2xx状态码视为成功,其他状态码会触发重试
示例:
"https://your-domain.com/webhooks/video-task-completed"
响应
视频增强任务创建成功
任务创建时间戳
示例:
1757169743
任务ID
示例:
"task-unified-1757169743-7cvnl5zw"
实际使用的模型名称
示例:
"tencent-video-upscale"
任务的具体类型
可用选项:
video.generation.task 任务进度百分比 (0-100)
必填范围:
0 <= x <= 100示例:
0
任务状态
可用选项:
pending, processing, completed, failed 示例:
"pending"
视频任务详细信息
Show child attributes
Show child attributes
任务的输出类型
可用选项:
text, image, audio, video 示例:
"video"
使用量和计费信息
Show child attributes
Show child attributes