Skip to main content
POST
/
video
/
queue
/api/v1/video/queue
curl --request POST \
  --url https://api.venice.ai/api/v1/video/queue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan-2.5-preview-image-to-video",
  "prompt": "Commerce being conducted in the city of Venice, Italy.",
  "duration": "5s",
  "image_url": "data:image/png;base64,iVBORw0K...",
  "negative_prompt": "low resolution, error, worst quality, low quality, defects",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "audio": true,
  "audio_url": "data:audio/mpeg;base64,SUQzBAA...",
  "video_url": "data:video/mp4;base64,AAAAFGZ0eXA..."
}
'
{
  "model": "video-model-123",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000"
}
Call /video/quote to get a price estimate, then poll /video/retrieve with the returned queue_id until complete.

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 model to use for image generation.

Example:

"wan-2.5-preview-image-to-video"

​
prompt
string
required

The prompt to use for video generation. The maximum length is 2500 characters.

Required string length: 1 - 2500
Example:

"Commerce being conducted in the city of Venice, Italy."

​
duration
enum<string>
required

The duration of the video to generate.

Available options:
5s,
10s
Example:

"5s"

​
image_url
string
required

For image to video models, the reference image to use for video generation. Must be either a URL (starting with "http://" or "https://") or a data URL (starting with "data:").

Example:

"data:image/png;base64,iVBORw0K..."

​
negative_prompt
string
default:low resolution, error, worst quality, low quality, defects

The negative prompt to use for video generation. The maximum length is 2500 characters.

Maximum string length: 2500
Example:

"low resolution, error, worst quality, low quality, defects"

​
aspect_ratio
any

The aspect ratio of the video to generate.

Example:

"16:9"

​
resolution
enum<string>
default:720p

The resolution of the video to generate.

Available options:
1080p,
720p,
480p
Example:

"720p"

​
audio
any

For models which support audio generation and configuration, indicates if audio should be generated. Defaults to true.

Example:

true

​
audio_url
any

For models that support audio input, the audio file to use as background music. Must be either a URL or a data URL. Supported formats: WAV, MP3. Max duration: 30s. Max size: 15MB.

Example:

"data:audio/mpeg;base64,SUQzBAA..."

​
video_url
any

For models that support video input, the video file to use as a reference. Must be either a URL or a data URL. Supported formats: MP4, MOV, WebM.

Example:

"data:video/mp4;base64,AAAAFGZ0eXA..."

Response

Video generation request queued successfully

​
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"