Video Queue | Venice API Docs

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": "seedance-2-0-text-to-video",
  "prompt": "Commerce being conducted in the city of Venice, Italy.",
  "duration": "10s",
  "consents": {},
  "negative_prompt": "low resolution, error, worst quality, low quality, defects",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "upscale_factor": 2,
  "audio": true,
  "image_url": "data:image/png;base64,iVBORw0K...",
  "end_image_url": "data:image/png;base64,iVBORw0K...",
  "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..."
  ],
  "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
    }
  ]
}
'

import requests

url = "https://api.venice.ai/api/v1/video/queue"

payload = {
    "model": "seedance-2-0-text-to-video",
    "prompt": "Commerce being conducted in the city of Venice, Italy.",
    "duration": "10s",
    "consents": {},
    "negative_prompt": "low resolution, error, worst quality, low quality, defects",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "upscale_factor": 2,
    "audio": True,
    "image_url": "data:image/png;base64,iVBORw0K...",
    "end_image_url": "data:image/png;base64,iVBORw0K...",
    "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..."],
    "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
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'seedance-2-0-text-to-video',
    prompt: 'Commerce being conducted in the city of Venice, Italy.',
    duration: '10s',
    consents: {},
    negative_prompt: 'low resolution, error, worst quality, low quality, defects',
    aspect_ratio: '16:9',
    resolution: '720p',
    upscale_factor: 2,
    audio: true,
    image_url: 'data:image/png;base64,iVBORw0K...',
    end_image_url: 'data:image/png;base64,iVBORw0K...',
    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...'],
    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}
    ]
  })
};

fetch('https://api.venice.ai/api/v1/video/queue', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.venice.ai/api/v1/video/queue",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'seedance-2-0-text-to-video',
    'prompt' => 'Commerce being conducted in the city of Venice, Italy.',
    'duration' => '10s',
    'consents' => [
        
    ],
    'negative_prompt' => 'low resolution, error, worst quality, low quality, defects',
    'aspect_ratio' => '16:9',
    'resolution' => '720p',
    'upscale_factor' => 2,
    'audio' => true,
    'image_url' => 'data:image/png;base64,iVBORw0K...',
    'end_image_url' => 'data:image/png;base64,iVBORw0K...',
    '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...'
    ],
    '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
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.venice.ai/api/v1/video/queue"

	payload := strings.NewReader("{\n  \"model\": \"seedance-2-0-text-to-video\",\n  \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n  \"duration\": \"10s\",\n  \"consents\": {},\n  \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"720p\",\n  \"upscale_factor\": 2,\n  \"audio\": true,\n  \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"audio_url\": \"data:audio/mpeg;base64,SUQzBAA...\",\n  \"video_url\": \"data:video/mp4;base64,AAAAFGZ0eXA...\",\n  \"reference_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"reference_video_urls\": [\n    \"https://example.com/reference-clip.mp4\"\n  ],\n  \"reference_audio_urls\": [\n    \"data:audio/mpeg;base64,SUQzBAAAAAA...\"\n  ],\n  \"elements\": [\n    {\n      \"frontal_image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"reference_image_urls\": [\n        \"data:image/png;base64,iVBORw0K...\"\n      ]\n    }\n  ],\n  \"scene_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"keyframes\": [\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 0\n    },\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 120\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.venice.ai/api/v1/video/queue")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"seedance-2-0-text-to-video\",\n  \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n  \"duration\": \"10s\",\n  \"consents\": {},\n  \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"720p\",\n  \"upscale_factor\": 2,\n  \"audio\": true,\n  \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"audio_url\": \"data:audio/mpeg;base64,SUQzBAA...\",\n  \"video_url\": \"data:video/mp4;base64,AAAAFGZ0eXA...\",\n  \"reference_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"reference_video_urls\": [\n    \"https://example.com/reference-clip.mp4\"\n  ],\n  \"reference_audio_urls\": [\n    \"data:audio/mpeg;base64,SUQzBAAAAAA...\"\n  ],\n  \"elements\": [\n    {\n      \"frontal_image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"reference_image_urls\": [\n        \"data:image/png;base64,iVBORw0K...\"\n      ]\n    }\n  ],\n  \"scene_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"keyframes\": [\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 0\n    },\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 120\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/v1/video/queue")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"seedance-2-0-text-to-video\",\n  \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n  \"duration\": \"10s\",\n  \"consents\": {},\n  \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"720p\",\n  \"upscale_factor\": 2,\n  \"audio\": true,\n  \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"audio_url\": \"data:audio/mpeg;base64,SUQzBAA...\",\n  \"video_url\": \"data:video/mp4;base64,AAAAFGZ0eXA...\",\n  \"reference_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"reference_video_urls\": [\n    \"https://example.com/reference-clip.mp4\"\n  ],\n  \"reference_audio_urls\": [\n    \"data:audio/mpeg;base64,SUQzBAAAAAA...\"\n  ],\n  \"elements\": [\n    {\n      \"frontal_image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"reference_image_urls\": [\n        \"data:image/png;base64,iVBORw0K...\"\n      ]\n    }\n  ],\n  \"scene_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"keyframes\": [\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 0\n    },\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 120\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

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

{
  "error": "<string>",
  "details": {
    "_errors": [],
    "field": {
      "_errors": [
        "Field is required"
      ]
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": {
    "code": "needs_consent",
    "message": "<string>"
  },
  "consent_flow": "seedance",
  "face_media_roles": [],
  "consent": {
    "consent_version": "<string>",
    "policy_text": "<string>"
  },
  "docs_url": "<string>"
}

{
  "code": "PAYLOAD_TOO_LARGE",
  "error": "File exceeds the maximum allowed size of 25 MB."
}

{
  "error": "<string>",
  "suggested_prompt": "A cinematic instrumental track inspired by stormy weather and dramatic tension."
}

{
  "error": "<string>"
}

Llama a /video/quote para obtener una estimación de precio y, a continuación, consulta /video/retrieve con el queue_id devuelto hasta que se complete. Los modelos privados también devuelven un download_url para el vídeo terminado. Es una URL de entrega de corta duración (algunos reintentos están bien si una descarga se interrumpe); consulta la guía de generación de vídeo para conocer los detalles y el DELETE opcional para privacidad.

Seedance 2.0 y 2.5

Para los modelos seedance-2-0-*-api y seedance-2-5-*-api (text-to-video, image-to-video, reference-to-video, además de las variantes -fast-* de Seedance 2.0), consulta la Guía de Seedance 2.0 y 2.5 para el modelo de cuatro flujos de trabajo (Reference / Edit / Extend / Stitch), límites multimodales por familia, comportamiento faces-off de la API y detalles de precios.

Seedance API sin rostros (faces-off)

Los modelos Seedance públicos no admiten aprovisionamiento de face assets ni atestación de consentimiento facial. Las entradas con rostros pueden ser rechazadas upstream. Para generación con likeness / face assets, usa la app o Studio de Venice. Consulta la guía de Seedance.

Escalado de vídeo

Para el modelo topaz-video-upscale, usa upscale_factor (1, 2 o 4) en lugar de resolution y proporciona un video_url. La duración y los FPS se detectan automáticamente del archivo de vídeo. Consulta la Guía de escalado de vídeo para detalles completos y ejemplos.

Autorizaciones

Authorization

string

header

requerido

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

Cuerpo

application/json

Request body for video generation. Available fields and valid values vary by model.

model

string

requerido

The model to use for video generation.

Ejemplo:

"seedance-2-0-text-to-video"

prompt

string

requerido

The prompt to use for video generation. Required for most models. The maximum length varies by model (default 2500 characters, up to 20000 for some models).

Required string length: 1 - 20000

Ejemplo:

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

duration

enum<string>

requerido

The duration of the video to generate. Available options vary by model.

Opciones disponibles:

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 gen,

Auto

Ejemplo:

"10s"

consents

object

Optional provider-specific consent attestations. Seedance consent is required only when submitted media contains faces.

Show child attributes

negative_prompt

string

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

Maximum string length: 20000

Ejemplo:

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

aspect_ratio

enum<string>

The aspect ratio of the video. Available options vary by model. Some models do not support aspect_ratio.

Opciones disponibles:

1:1,

2:3,

3:2,

3:4,

4:3,

4:5,

5:4,

9:16,

9:21,

16:9,

21:9,

adaptive,

auto

Ejemplo:

"16:9"

resolution

enum<string>

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

Opciones disponibles:

256p,

360p,

480p,

540p,

580p,

720p,

1080p,

1440p,

2160p,

4k,

2x,

4x,

2K,

768P,

true_1080p

Ejemplo:

"720p"

upscale_factor

enum<integer>

predeterminado:2

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

Opciones disponibles:

1,

2,

4

Ejemplo:

2

audio

boolean

predeterminado:true

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

Ejemplo:

true

image_url

string

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

Ejemplo:

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

end_image_url

string

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

Ejemplo:

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

audio_url

string

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

Ejemplo:

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

video_url

string

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

Ejemplo:

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

reference_image_urls

string[]

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

Maximum array length: 30

Ejemplo:

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

reference_video_urls

string[]

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.

Maximum array length: 10

Ejemplo:

["https://example.com/reference-clip.mp4"]

reference_audio_urls

string[]

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.

Maximum array length: 10

Ejemplo:

["data:audio/mpeg;base64,SUQzBAAAAAA..."]

elements

object[]

For models with advanced element support (e.g., Kling O3 R2V). Up to 4 elements defining characters/objects. Reference in prompt as @Element1, @Element2, etc.

Maximum array length: 4

Show child attributes

Ejemplo:

[
  {
    "frontal_image_url": "data:image/png;base64,iVBORw0K...",
    "reference_image_urls": ["data:image/png;base64,iVBORw0K..."]
  }
]

scene_image_urls

string[]

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

Maximum array length: 4

Ejemplo:

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

keyframes

object[]

For keyframe-driven models. Up to 10 keyframe images pinned to frame positions in the generated 24 fps video. Each frame_index must be unique and no greater than duration × 24.

Maximum array length: 10

Show child attributes

Ejemplo:

[
  {
    "image_url": "data:image/png;base64,iVBORw0K...",
    "frame_index": 0
  },
  {
    "image_url": "data:image/png;base64,iVBORw0K...",
    "frame_index": 120
  }
]

Respuesta

Video generation request queued successfully

model

string

requerido

The ID of the model used for video generation.

Ejemplo:

"video-model-123"

queue_id

string

requerido

The ID of the video generation request.

Ejemplo:

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

download_url

string

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.

⌘I

/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": "seedance-2-0-text-to-video",
  "prompt": "Commerce being conducted in the city of Venice, Italy.",
  "duration": "10s",
  "consents": {},
  "negative_prompt": "low resolution, error, worst quality, low quality, defects",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "upscale_factor": 2,
  "audio": true,
  "image_url": "data:image/png;base64,iVBORw0K...",
  "end_image_url": "data:image/png;base64,iVBORw0K...",
  "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..."
  ],
  "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
    }
  ]
}
'

import requests

url = "https://api.venice.ai/api/v1/video/queue"

payload = {
    "model": "seedance-2-0-text-to-video",
    "prompt": "Commerce being conducted in the city of Venice, Italy.",
    "duration": "10s",
    "consents": {},
    "negative_prompt": "low resolution, error, worst quality, low quality, defects",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "upscale_factor": 2,
    "audio": True,
    "image_url": "data:image/png;base64,iVBORw0K...",
    "end_image_url": "data:image/png;base64,iVBORw0K...",
    "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..."],
    "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
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'seedance-2-0-text-to-video',
    prompt: 'Commerce being conducted in the city of Venice, Italy.',
    duration: '10s',
    consents: {},
    negative_prompt: 'low resolution, error, worst quality, low quality, defects',
    aspect_ratio: '16:9',
    resolution: '720p',
    upscale_factor: 2,
    audio: true,
    image_url: 'data:image/png;base64,iVBORw0K...',
    end_image_url: 'data:image/png;base64,iVBORw0K...',
    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...'],
    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}
    ]
  })
};

fetch('https://api.venice.ai/api/v1/video/queue', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.venice.ai/api/v1/video/queue",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'seedance-2-0-text-to-video',
    'prompt' => 'Commerce being conducted in the city of Venice, Italy.',
    'duration' => '10s',
    'consents' => [
        
    ],
    'negative_prompt' => 'low resolution, error, worst quality, low quality, defects',
    'aspect_ratio' => '16:9',
    'resolution' => '720p',
    'upscale_factor' => 2,
    'audio' => true,
    'image_url' => 'data:image/png;base64,iVBORw0K...',
    'end_image_url' => 'data:image/png;base64,iVBORw0K...',
    '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...'
    ],
    '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
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.venice.ai/api/v1/video/queue"

	payload := strings.NewReader("{\n  \"model\": \"seedance-2-0-text-to-video\",\n  \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n  \"duration\": \"10s\",\n  \"consents\": {},\n  \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"720p\",\n  \"upscale_factor\": 2,\n  \"audio\": true,\n  \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"audio_url\": \"data:audio/mpeg;base64,SUQzBAA...\",\n  \"video_url\": \"data:video/mp4;base64,AAAAFGZ0eXA...\",\n  \"reference_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"reference_video_urls\": [\n    \"https://example.com/reference-clip.mp4\"\n  ],\n  \"reference_audio_urls\": [\n    \"data:audio/mpeg;base64,SUQzBAAAAAA...\"\n  ],\n  \"elements\": [\n    {\n      \"frontal_image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"reference_image_urls\": [\n        \"data:image/png;base64,iVBORw0K...\"\n      ]\n    }\n  ],\n  \"scene_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"keyframes\": [\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 0\n    },\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 120\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.venice.ai/api/v1/video/queue")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"seedance-2-0-text-to-video\",\n  \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n  \"duration\": \"10s\",\n  \"consents\": {},\n  \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"720p\",\n  \"upscale_factor\": 2,\n  \"audio\": true,\n  \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"audio_url\": \"data:audio/mpeg;base64,SUQzBAA...\",\n  \"video_url\": \"data:video/mp4;base64,AAAAFGZ0eXA...\",\n  \"reference_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"reference_video_urls\": [\n    \"https://example.com/reference-clip.mp4\"\n  ],\n  \"reference_audio_urls\": [\n    \"data:audio/mpeg;base64,SUQzBAAAAAA...\"\n  ],\n  \"elements\": [\n    {\n      \"frontal_image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"reference_image_urls\": [\n        \"data:image/png;base64,iVBORw0K...\"\n      ]\n    }\n  ],\n  \"scene_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"keyframes\": [\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 0\n    },\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 120\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/v1/video/queue")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"seedance-2-0-text-to-video\",\n  \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n  \"duration\": \"10s\",\n  \"consents\": {},\n  \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"720p\",\n  \"upscale_factor\": 2,\n  \"audio\": true,\n  \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n  \"audio_url\": \"data:audio/mpeg;base64,SUQzBAA...\",\n  \"video_url\": \"data:video/mp4;base64,AAAAFGZ0eXA...\",\n  \"reference_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"reference_video_urls\": [\n    \"https://example.com/reference-clip.mp4\"\n  ],\n  \"reference_audio_urls\": [\n    \"data:audio/mpeg;base64,SUQzBAAAAAA...\"\n  ],\n  \"elements\": [\n    {\n      \"frontal_image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"reference_image_urls\": [\n        \"data:image/png;base64,iVBORw0K...\"\n      ]\n    }\n  ],\n  \"scene_image_urls\": [\n    \"data:image/png;base64,iVBORw0K...\"\n  ],\n  \"keyframes\": [\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 0\n    },\n    {\n      \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n      \"frame_index\": 120\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

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

{
  "error": "<string>",
  "details": {
    "_errors": [],
    "field": {
      "_errors": [
        "Field is required"
      ]
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": {
    "code": "needs_consent",
    "message": "<string>"
  },
  "consent_flow": "seedance",
  "face_media_roles": [],
  "consent": {
    "consent_version": "<string>",
    "policy_text": "<string>"
  },
  "docs_url": "<string>"
}

{
  "code": "PAYLOAD_TOO_LARGE",
  "error": "File exceeds the maximum allowed size of 25 MB."
}

{
  "error": "<string>",
  "suggested_prompt": "A cinematic instrumental track inspired by stormy weather and dramatic tension."
}

{
  "error": "<string>"
}

Venice APIs

Encolar generación de vídeo

Seedance 2.0 y 2.5

Seedance API sin rostros (faces-off)

Escalado de vídeo

Autorizaciones

Cuerpo

Respuesta

​Seedance 2.0 y 2.5

​Seedance API sin rostros (faces-off)

​Escalado de vídeo

Autorizaciones

Cuerpo

Respuesta

Seedance 2.0 y 2.5

Seedance API sin rostros (faces-off)

Escalado de vídeo