Download video

Download a completed video using its public task ID. A platform API Key is required. The response body is binary, not JSON.

GET/v1/videos/{task_id}/content

Authorization

bearerAuth

AuthorizationBearer <token>

Use the platform API Key: Authorization: Bearer your-api-key.

In: header

Path Parameters

task_id*string

The public task ID returned by the platform. Store it as a string and use it for retrieval and download, not request_id or a nested upstream task ID.

Length1 <= length

Response Body

`video/mp4`

`application/json`

curl -X GET "https://api.agtcloud.cn/v1/videos/TASK_ID/content" \
  -H "Authorization: Bearer your-api-key" \
  --output video.mp4

No example response

Binary video response. Save according to the actual Content-Type; no JSON example is provided.

Steps

Confirm status: "completed" using platform retrieval, or output.task_status: "SUCCEEDED" using native retrieval.
Put the public task ID returned by creation in the path and use an API Key for the same user at the corresponding API site.
Save according to the actual Content-Type; the cURL example writes the file with --output video.mp4.

Downloading does not create a new task. You may also save metadata.url or output.video_url returned by retrieval. Save the video before the URL expires.

An incomplete task may return HTTP 400; a missing or inaccessible task may return HTTP 404. Errors may be JSON containing an error object. Check the HTTP status and content type before treating a saved response as a video.

Alibaba Cloud Wan 3.0 video generation API referenceReference for the model native protocol; platform fields and responses follow this page.

Authorization

Path Parameters

Response Body

200video/mp4

400application/json

401application/json

404application/json

Steps

`video/mp4`

`application/json`

`application/json`

`application/json`