Skip to main content
POST
/
video
/
retrieve
/api/v1/video/retrieve
curl --request POST \
  --url https://api.venice.ai/api/v1/video/retrieve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "video-model-123",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "delete_media_on_completion": false
}
'
{
  "status": "PROCESSING",
  "average_execution_time": 145000,
  "execution_duration": 53200
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
model
string
required

The ID of the model used for video generation.

Example:

"video-model-123"

​
queue_id
string
required

The ID of the video generation request.

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
delete_media_on_completion
boolean
default:false

If true, the video media will be deleted from storage after the request is completed. If false, you can use the complete endpoint to remove the media once you have successfully downloaded the video.

Example:

false

Response

Video file if completed, or processing status if still in progress

​
status
enum<string>
required

The status of the video generation request.

Available options:
PROCESSING
Example:

"PROCESSING"

​
average_execution_time
number
required

The average execution time of the video generation request in milliseconds.

Example:

145000

​
execution_duration
number
required

The current duration of the video generation request in milliseconds.

Example:

53200