Skip to main content
GET
cURL
Use this endpoint to download the finished Sora output after the job reaches completed. Until then, it returns an error instead of a video file.

Before you download

  • Wait until Retrieve Video reports status: completed
  • Pass the video_id from the create step
  • Store the file in your own bucket or CDN if you need it to outlive the provider’s temporary delivery window

Download flow

1

Create the video

Start with Create Video.
2

Poll for completion

Use Retrieve Video until the job reaches completed.
3

Fetch the binary file

Call this endpoint to download the MP4 or another supported asset variant.

Temporary delivery window

Once the render is complete, retrieve the file promptly. The provider’s delivery URL is not permanent.

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

video_id
string
required

Completed video id.

Query Parameters

variant
string

Optional content variant such as the main video, thumbnail, or spritesheet when supported by the provider.

Response

Binary video content.

The response is of type file.