Video Generation

Video generation is async. Submit a job, save queue_id, then poll /video/retrieve until the response is video/mp4.

Endpoints

Endpoint	Purpose	Required
`POST /video/quote`	Get price in USD before generating	No
`POST /video/queue`	Submit generation request	Yes
`POST /video/retrieve`	Poll status or download video	Yes
`POST /video/complete`	Delete video from storage	No

Step 1: Queue Generation

Request:

POST https://api.venice.ai/api/v1/video/queue
Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json

{
  "model": "wan-2.5-preview-text-to-video",
  "prompt": "A gondola gliding through Venice canals at sunset",
  "duration": "5s",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Response (200):

{
  "model": "wan-2.5-preview-text-to-video",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000"
}

Save both model and queue_id - you need them for all subsequent calls.

Step 2: Poll for Completion

Request:

POST https://api.venice.ai/api/v1/video/retrieve
Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json

{
  "model": "wan-2.5-preview-text-to-video",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000"
}

Response depends on status:

Content-Type	Meaning	Action
`application/json`	Still processing	Wait 5s, poll again
`video/mp4`	Complete	Response body is the video file

Processing response (200, application/json):

{
  "status": "PROCESSING",
  "average_execution_time": 145000,
  "execution_duration": 53200
}

Times are in milliseconds. Use average_execution_time to estimate remaining wait. Complete response (200, video/mp4): Response body is raw binary video data. Save to file.

Step 3: Cleanup (Optional)

Either auto-delete on retrieval:

{
  "model": "wan-2.5-preview-text-to-video",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "delete_media_on_completion": true
}

Or call /video/complete after saving:

POST https://api.venice.ai/api/v1/video/complete
Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json

{
  "model": "wan-2.5-preview-text-to-video",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000"
}

Response (200):

{
  "success": true
}

Complete Example

import os
import time
import requests

API_KEY = os.environ.get("VENICE_API_KEY")
BASE_URL = "https://api.venice.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Queue
resp = requests.post(f"{BASE_URL}/video/queue", headers=HEADERS, json={
    "model": "wan-2.5-preview-text-to-video",
    "prompt": "A gondola gliding through Venice canals at sunset",
    "duration": "5s",
    "resolution": "720p",
    "aspect_ratio": "16:9"
})
data = resp.json()
model, queue_id = data["model"], data["queue_id"]

# Poll
while True:
    resp = requests.post(f"{BASE_URL}/video/retrieve", headers=HEADERS,
                         json={"model": model, "queue_id": queue_id})
    if "video/mp4" in resp.headers.get("Content-Type", ""):
        with open("output.mp4", "wb") as f:
            f.write(resp.content)
        break
    time.sleep(5)

# Cleanup
requests.post(f"{BASE_URL}/video/complete", headers=HEADERS,
              json={"model": model, "queue_id": queue_id})

Request Parameters

Queue Request

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model ID. Use `wan-2.5-preview-text-to-video` for text-to-video, `wan-2.5-preview-image-to-video` for image-to-video
`prompt`	string	Yes	-	What to generate. Max 2500 chars
`negative_prompt`	string	No	`"low resolution, error, worst quality, low quality, defects"`	What to avoid
`duration`	string	Yes	-	`"5s"` or `"10s"`
`resolution`	string	No	`"720p"`	`"480p"`, `"720p"`, or `"1080p"`
`aspect_ratio`	string	Conditional	-	Model-dependent. Required for models that expose aspect-ratio options; omit for models that do not support aspect-ratio selection
`audio`	boolean	Conditional	`true` (when supported)	Only valid for models with `supportsAudioConfig: true`; omit for models without audio config support
`image_url`	string	Only for image-to-video	-	URL or base64 data URL of source image
`audio_url`	string	Conditional	-	URL or base64 data URL of reference audio for models that support audio input

Queue validation is model-specific. Check /models?type=video for each model’s supported request fields before calling /video/queue.

Quote Request

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model ID to price
`duration`	string	Yes	-	`"5s"` or `"10s"`
`resolution`	string	No	`"720p"`	`"480p"`, `"720p"`, or `"1080p"`
`aspect_ratio`	string	Conditional	-	Include when the selected model supports or requires aspect-ratio selection
`audio`	boolean	Conditional	`true` (when supported)	Only valid for models with `supportsAudioConfig: true`

Retrieve Request

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	From queue response
`queue_id`	string	Yes	-	From queue response
`delete_media_on_completion`	boolean	No	`false`	Delete video after successful retrieval

Complete Request

Parameter	Type	Required	Description
`model`	string	Yes	From queue response
`queue_id`	string	Yes	From queue response

Image to Video

For image-to-video models, pass source image via image_url. The prompt describes desired motion, not the image content.

{
  "model": "wan-2.5-preview-image-to-video",
  "prompt": "Camera slowly zooms in as leaves rustle in the wind",
  "image_url": "https://example.com/image.jpg",
  "duration": "5s"
}

Or with base64:

{
  "model": "wan-2.5-preview-image-to-video",
  "prompt": "Camera slowly zooms in as leaves rustle in the wind",
  "image_url": "data:image/jpeg;base64,/9j/4AAQ...",
  "duration": "5s"
}

Price Quote

Get exact cost before generating. Send only pricing inputs (model, duration, and optional resolution, aspect_ratio, audio): Request:

{
  "model": "wan-2.5-preview-text-to-video",
  "duration": "10s",
  "resolution": "1080p"
}

Response:

{
  "quote": 0.085
}

Quote is in USD.

Errors

Status	Returned By	Meaning	Action
400	`queue`, `quote`, `retrieve`, `complete`	Invalid parameters	Check request body against schema
401	`queue`, `retrieve`, `complete`	Auth failed	Check API key
402	`queue`	Insufficient balance	Add funds
404	`retrieve`	Media not found (invalid, expired, or deleted)	Verify `model`/`queue_id` or re-queue
413	`queue`	Payload too large	Reduce image/audio size
422	`queue`, `retrieve`	Content violation	Modify prompt
500	`queue`, `retrieve`, `complete`	Inference/processing failed	Retry with backoff; contact support if persistent
503	`retrieve`	Model at capacity	Retry with backoff

Polling Strategy

Poll /video/retrieve on an interval (for example, every 5 seconds)
If Content-Type is application/json, status is still PROCESSING; inspect average_execution_time and execution_duration (milliseconds)
If Content-Type is video/mp4, save the response body as your output file
Optional cleanup: set delete_media_on_completion: true on retrieve, or call /video/complete after download
Handle 404 as invalid, expired, or deleted media; handle 500/503 with retries/backoff

Available Models

See Video Models for current model list and pricing.

Overview

Guides

Endpoints

Step 1: Queue Generation

Step 2: Poll for Completion

Step 3: Cleanup (Optional)

Complete Example

Request Parameters

Queue Request

Quote Request

Retrieve Request

Complete Request

Image to Video

Price Quote

Errors

Polling Strategy

Available Models

Overview

Guides

​Endpoints

​Step 1: Queue Generation

​Step 2: Poll for Completion

​Step 3: Cleanup (Optional)

​Complete Example

​Request Parameters

​Queue Request

​Quote Request

​Retrieve Request

​Complete Request

​Image to Video

​Price Quote

​Errors

​Polling Strategy

​Available Models

Endpoints

Step 1: Queue Generation

Step 2: Poll for Completion

Step 3: Cleanup (Optional)

Complete Example

Request Parameters

Queue Request

Quote Request

Retrieve Request

Complete Request

Image to Video

Price Quote

Errors

Polling Strategy

Available Models