Download a video

Retrieve the binary video content by Video ID. Save the response as a file instead of parsing it as JSON.

GET/v1/videos/{video_id}/content

Download the binary content of a completed video task. The response body is not JSON. Save it as a video file according to its Content-Type. The cURL example uses --output video.mp4 to write the response to a file.

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

video_id*string

Video ID of a completed video task.

Length1 <= length

Query Parameters

variant?string

Downloadable resource type to return. The default is an MP4 video.

Response Body

`video/mp4`

`application/json`

curl -X GET "https://example.com/v1/videos/video_123/content" \  -H "Authorization: Bearer your-api-key" \  --output video.mp4

No example response

The request succeeded and the response body contains binary video content. Handle the file according to the response headers:

Content-Type: video file type.
Content-Length: video file size in bytes, when returned by the server.
Content-Disposition: file download information, when returned by the server.

The response body is a binary video stream, so no JSON example is provided. Save or process the file according to the returned Content-Type.

The request succeeded and the response body contains binary video content. Handle the file according to the response headers: - `Content-Type`: video file type. - `Content-Length`: video file size in bytes, when returned by the server. - `Content-Disposition`: file download information, when returned by the server. The response body is a binary video stream, so no JSON example is provided. Save or process the file according to the returned `Content-Type`.

Authorization

Path Parameters

Query Parameters

Response Body

200video/mp4

401application/json

404application/json

`video/mp4`

`application/json`

`application/json`