Video

/api/v1/video/queue

Queue a new video generation request.

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

post/api/v1/video/queue

Request

Base URL: https://api.venice.ai
URL: https://api.venice.ai/api/v1/video/queue
Auth: one of:
- HTTP bearer
- API key in header SIGN-IN-WITH-X

Request body

modelstring required

The model to use for video generation.

promptstring

The prompt to use for video generation. Required for most models; optional for H3 Max Multi-Angle. The maximum length varies by model (default 2500 characters, up to 20000 for some models).

negative_promptstring

Optional negative prompt. The maximum length varies by model (default 2500 characters, up to 20000 for some models).

duration'1s' | '2s' | '3s' | '4s' | '5s' | '6s' | '7s' | '8s' | '9s' | '10s' | '11s' | '12s' | '13s' | '14s' | '15s' | '16s' | '17s' | '18s' | '19s' | '20s' | '21s' | '22s' | '23s' | '24s' | '25s' | '26s' | '27s' | '28s' | '29s' | '30s' | '-1' | '1 gen' | 'auto' | 'Auto' required

The duration of the video to generate. Available options vary by model. For Seedance 2.5 reference-to-video edit jobs, -1 or auto matches output length to the source clip (requires reference_video_urls on queue, or reference_video_total_duration on quote; source must be 4–30s).

aspect_ratio'1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '9:21' | '16:9' | '21:9' | 'adaptive' | 'auto'

The aspect ratio of the video. Available options vary by model. Some models do not support aspect_ratio. For Seedance 2.x reference-to-video edit/extend, adaptive or auto matches output aspect ratio to the source clip (requires reference_video_urls on queue, or reference_video_total_duration on quote).

omni_reference_task_type'auto' | 'reference' | 'edit' | 'extend'

Optional Seedance 2.5 reference-to-video task-type hint forwarded to BytePlus (auto | reference | edit | extend). Aliases editing→edit and extension→extend are accepted on the queue API. Pre-guides classification to reduce async TaskTypeConstraint errors. The prompt must still match the chosen type. When omitted, Venice infers from the prompt if reference_video_urls are present. Not supported on other models.

resolution'256p' | '360p' | '480p' | '540p' | '580p' | '720p' | '1080p' | '1440p' | '2160p' | '2k' | '4k' | '1x' | '2x' | '4x' | '2K' | '480P' | '768P' | '1080P' | 'true_1080p'

The resolution of the video. Available options vary by model. Some models do not support resolution. Use upscale_factor for upscale models.

upscale_factor1 | 2 | 4

For upscale models only. 1 = quality enhancement, 2 = double resolution (default), 4 = quadruple.

enhancement_modelstring

For enhancement models only. The provider-side enhancement model. Available values are listed per model in GET /models constraints.topaz.models.

target_fpsinteger

For enhancement models only. Target FPS for frame interpolation (16-120). Doubles the price on upscaling endpoints when ≥48; scales linearly on interpolation. Omit to keep the source frame rate.

softnessnumber

For enhancement models only. Softness level (1-5, sharpest to softest).

creativitynumber

For enhancement models only. How much new detail the model invents (0.0-1.0).

realismnumber

For enhancement models only. Bias generated detail toward photorealism (0.0-1.0).

sharpnumber

For enhancement models only. Output sharpness (0.0 softens, 0.5 neutral, 1.0 strong).

compressionnumber

For enhancement models only. Compression artifact removal level (0.0-1.0).

noisenumber

For enhancement models only. Noise reduction level (0.0-1.0).

halonumber

For enhancement models only. Halo reduction level (0.0-1.0).

grainnumber

For enhancement models only. Film grain amount (0.0-0.1).

recover_detailnumber

For enhancement models only. Recover original detail level (0.0-1.0).

h264_outputboolean

For enhancement models only. Output H.264 instead of the default H.265.

output_format'mp4' | 'prores'

For enhancement models only (SDR-to-HDR). Output container: mp4 (10-bit H265 HDR10) or prores (10-bit ProRes).

slowdown_factor1 | 2 | 4 | 8

For enhancement models only (frame interpolation). Slow-motion factor: 2 makes the output twice as long at the target FPS, up to 8x. Multiplies the billed duration.

audioboolean

For models which support audio generation and configuration. Defaults to true.

image_urlstring

For image-to-video models, the reference image. Must be a URL (http/https) or a data URL (data:image/...).

end_image_urlstring

For models that support end images or transitions, the end frame image. Must be a URL or data URL.

image_strengthnumber

How strongly the input image guides an image-to-video generation, from 0 to 1. Supported on models that declare image strength. Omitted values use the provider default (1). Does not change the quoted price.

audio_urlstring

For models that support audio input, background music. Must be a URL or data URL. Supported: WAV, MP3. Max: 30s, 15MB.

video_urlstring

For models that support video input (video-to-video, upscale). Must be a URL or data URL. Supported: MP4, MOV, WebM.

reference_image_urlsstring[]

For models with reference image support, up to 30 images for character/style consistency. Each must be a URL or data URL.

reference_video_urlsstring[]

For models with reference video support (e.g. Seedance 2.0 R2V), up to 10 reference video URLs (role: "reference_video") used to inherit subject motion, camera movement, and overall style. Per-clip 2–15 s, .mp4 or .mov, ≤50 MB; aggregate duration ≤15 s. Each must be a URL or data URL.

reference_audio_urlsstring[]

For models with reference audio support (e.g. Seedance 2.0 R2V), up to 10 reference audio URLs (role: "reference_audio") used as donors for vocal timbre, narration, or sound effects. Per-clip 2–15 s, .wav or .mp3; aggregate duration ≤15 s. Must be paired with at least one reference image or reference video — audio-only Reference workflows are rejected at validation. Each must be a URL or data URL.

reference_document_urlsstring[]

For models with document / webpage Omni-Reference (Wan 3.0), up to 1 URL. Document files and public webpage URLs are fetched by Venice and forwarded as type: "file" (≤100 MB). Each must be a URL or data URL.

scene_image_urlsstring[]

For models with advanced element support. Up to 4 scene reference images. Reference in prompt as @Image1, @Image2, etc.

Example request

{
  "model": "seedance-2-0-text-to-video-basic",
  "consents": {
    "seedance": {
      "confirmed_terms_and_privacy": true,
      "confirmed_legal_right": true,
      "confirmed_screening_acknowledged": true
    }
  },
  "prompt": "Commerce being conducted in the city of Venice, Italy.",
  "negative_prompt": "low resolution, error, worst quality, low quality, defects",
  "duration": "10s",
  "aspect_ratio": "16:9",
  "omni_reference_task_type": "edit",
  "resolution": "720p",
  "upscale_factor": 2,
  "enhancement_model": "Proteus",
  "target_fps": 60,
  "softness": 3,
  "creativity": 0.5,
  "realism": 0.5,
  "sharp": 0.5,
  "compression": 0.5,
  "noise": 0.5,
  "halo": 0.5,
  "recover_detail": 0.5,
  "output_format": "mp4",
  "slowdown_factor": 1,
  "audio": true,
  "camera_trajectory": [
    {
      "time": 0,
      "azimuth": 0,
      "elevation": 0,
      "distance": 1
    },
    {
      "time": 1,
      "azimuth": 45,
      "elevation": 10,
      "distance": 1
    }
  ],
  "image_url": "data:image/png;base64,iVBORw0K...",
  "end_image_url": "data:image/png;base64,iVBORw0K...",
  "image_strength": 1,
  "audio_url": "data:audio/mpeg;base64,SUQzBAA...",
  "video_url": "data:video/mp4;base64,AAAAFGZ0eXA...",
  "reference_image_urls": [
    "data:image/png;base64,iVBORw0K..."
  ],
  "reference_video_urls": [
    "https://example.com/reference-clip.mp4"
  ],
  "reference_audio_urls": [
    "data:audio/mpeg;base64,SUQzBAAAAAA..."
  ],
  "reference_document_urls": [
    "https://example.com/brief.pdf"
  ],
  "elements": [
    {
      "frontal_image_url": "data:image/png;base64,iVBORw0K...",
      "reference_image_urls": [
        "data:image/png;base64,iVBORw0K..."
      ]
    }
  ],
  "scene_image_urls": [
    "data:image/png;base64,iVBORw0K..."
  ],
  "keyframes": [
    {
      "image_url": "data:image/png;base64,iVBORw0K...",
      "frame_index": 0
    },
    {
      "image_url": "data:image/png;base64,iVBORw0K...",
      "frame_index": 120
    }
  ]
}

Response

Video generation request queued successfully

modelstring required

The ID of the model used for video generation.

queue_idstring required

The ID of the video generation request.

download_urlstring

Pre-signed URL to download the completed video. Only present for VPS-backed models. When provided, the retrieve endpoint returns JSON status only (no video stream). Fetch this URL after status is COMPLETED to get the video/mp4 file. Valid for 24 hours.

Example response

{
  "model": "video-model-123",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.