Retrieve a video

Use the task ID returned by the platform create endpoint to retrieve the status, video URL, and result metadata.

GET/v1/video/generations/{task_id}

Use the Task ID returned by the create endpoint to retrieve the task status and video result.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Path Parameters

task_id*string

Task ID returned when the Vidu video task was created.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v1/video/generations/abcd1234efgh"

{
  "error": null,
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "fps": 30,
    "height": 512,
    "seed": 20231234,
    "width": 512
  },
  "status": "succeeded",
  "task_id": "abcd1234efgh",
  "url": "https://example.com/video.mp4"
}

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`