该接口可以对视频做超清增强。

请求信息

请求 URL

POST /hub/vidu/v2/upscale-new

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
video_url	string	否	待处理视频地址，与 video_creation_id 二选一。常见支持格式：MP4、FLV、HLS、MXF、MOV、TS、WEBM、MKV；视频时长通常不超过 300 秒，帧率低于 60 FPS
video_creation_id	string	否	视频生成物 ID，与 video_url 二选一。若两者同时传入，通常优先使用 video_creation_id
upscale_resolution	string	否	目标清晰度，默认通常为 1080p。常见可选值：1080p、2K、4K、8K。要求高于原视频分辨率
payload	string	否	透传字段，最长 1048576 字符
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

json{
  "video_url": "https://example.com/source.mp4",
  "upscale_resolution": "4K"
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
video_url	string	输入视频地址
video_creation_id	string	输入视频生成物 ID
upscale_resolution	string	目标清晰度
payload	string	透传字段
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567898",
  "state": "created",
  "video_url": "https://example.com/source.mp4",
  "video_creation_id": "",
  "upscale_resolution": "4K",
  "payload": "",
  "credits": "25.000000",
  "created_at": "2026-04-16T09:38:00Z"
}

错误码

完整列表请参考客户端 API 错误码。