Upscale-pro
POST https://api.vidu.com/ent/v2/upscale-new
Request Header
| Field | Value | Description |
|---|---|---|
| Content-Type | application/json | Data Exchange Format |
| Authorization | Token {your api key} | Replace {} with your API key |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| video_url | String | Optional | The URL of the video to be upscaled. Requirements: - URL must be accessible - Supported container formats: MP4, FLV, HLS, MXF, MOV, TS, WEBM, MKV - Supported video codecs: H.264, H.264 intra, H.265, AV1, H.266, MV-HEVC, MPEG2, VP8, VP9 - Maximum video duration: 300 seconds - Frame rate must be below 60 FPS |
| video_creation_id | String | Optional | Unique ID of the video generation task on Vidu. - Must be retrieve creation_id from the GetGenaration API, request URL {/ent/v2/tasks/{id}/creations} - Note: If both video_creation_id and video_url are provided, the system will prioritize video_creation_id and ignore video_url. |
| upscale_resolution | String | Optional | Target resolution for upscaling. - Default is 1080p. Accept values: 1080p, 2K, 4K, 8K. - The resolution must be higher than the original video resolution, otherwise the task will fail. |
| payload | String | Optional | transparent transmission parameters No processing, only data transmission，with a maximum length of 1048576 characters |
| callback_url | String | Optional | Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the GET Generation API. The “status” in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). |
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.com/ent/v2/upscale-new
Response Body
| Field | Type | Description |
|---|---|---|
| task_id | String | Task ID |
| state | String | It will be returned to a specific processing state: - created created task successfully - queueing task in queue - processing processing - success generation successful - failedtask failed |
| video_url | String | The video URL submitted for upscaling |
| video_creation_id | String | The video creation id submitted for upscaling |
| upscale_resolution | String | The resolution used for upscaling |
| payload | String | The payload parameter used for this call |
| created_at | String | Task creation time |
{"task_id": "your_task_id_here","state": "created","video_url": "your_video_url","video_creation_id": "your_creation_id_here","upscale_resolution":"1080p","payload":"","created_at": "2025-01-01T15:41:31.968916Z"}