Vidu API
工作台
文档
登录

智能超清-尊享

POST https://api.vidu.cn/ent/v2/upscale-new

请求头

字段描述
Content-Typeapplication/json数据交换格式
AuthorizationToken {your api key}{token} 替换为您的 token

请求体

参数名称类型必填参数描述
video_urlString可选待超清优化的视频访问 URL,要求:
- URL 必须可以访问
- 支持的视频封装格式:MP4、FLV、HLS、MXF、MOV、TS、WEBM、MKV
- 支持的视频编码标准:H.264、H.264 intra、H.265、AV1、H.266、MV-HEVC、MPEG2、VP8、VP9
- 视频时长不超过 300 秒
- 视频帧率应低于 60 FPS
video_creation_idString可选Vidu 视频生成任务的唯一 ID
- 需通过查询任务接口获取,仅支持对平台生成的视频进行超清处理。
- 注:若同时传入 video_creation_id 和 video_url,系统默认优先使用 video_creation_id,忽略 video_url。
upscale_resolutionString可选目标输出分辨率,默认值为 1080p。
- 可选值包括:1080p、2K、4K、8K。
- 设置的清晰度必须高于原视频分辨率,否则任务将返回失败。
callback_urlString可选Callback 协议
需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态:
- processing 任务处理中
- success 任务完成(如发送失败,回调三次)
- failed 任务失败(如发送失败,回调三次)
curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
"video_url": "your_video_url",
"upscale_resolution": "1080p"
}' https://api.vidu.cn/ent/v2/upscale-new

响应体

字段类型描述
task_idStringVidu 生成的任务ID
stateString处理状态
可选值:
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
video_urlString本次调用需要超清的 视频
video_creation_idString本次调用需要超清的 视频
upscale_resolutionString本次调用的 超清清晰度
created_atString任务创建时间
{
"task_id": "your_task_id_here",
"state": "created",
"video_url": "vidu1.0",
"video_creation_id": "your_video_url_here",
"upscale_resolution": "1080p",
"created_at": "2025-01-01T15:41:31.968916Z"
}