Passer au contenu principal
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..."
  ]
}
'
{
  "model": "video-model-123",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "download_url": "<string>"
}
Appelez /video/quote pour obtenir une estimation du prix, puis interrogez /video/retrieve avec le queue_id renvoyé jusqu’à ce que la génération soit terminée. Les modèles privés renvoient également un download_url pour la vidéo terminée. Il s’agit d’une URL de livraison à durée de vie courte (quelques relances sont acceptables si un téléchargement échoue) ; voir le guide de génération vidéo pour les détails et la méthode DELETE optionnelle pour la confidentialité.

​
Seedance 2.0

Pour les modèles seedance-2-0-* (text-to-video, image-to-video, reference-to-video, plus les variantes -fast-*), voir le guide Seedance 2.0 pour le modèle à quatre workflows (Reference / Edit / Extend / Stitch), les modèles de prompt canoniques, les limites d’entrée multimodale et les détails de tarification.

​
Consentement Seedance

Lorsqu’une requête Seedance image-to-video ou reference-to-video contient un visage humain, l’API renvoie un 409 needs_consent avec le texte de la politique, et vous resoumettez la même requête avec une attestation consents.seedance. Voir le guide de consentement pour les médias avec visage Seedance pour le flux complet, l’objet de consentement, la déduplication et la révocation.

​
Agrandissement vidéo

Pour le modèle topaz-video-upscale, utilisez upscale_factor (1, 2 ou 4) au lieu de resolution, et fournissez un video_url. La durée et le FPS sont détectés automatiquement à partir du fichier vidéo. Voir le guide d’agrandissement vidéo pour les détails complets et les exemples.

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json

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

​
model
string
requis

The model to use for video generation.

Exemple:

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

​
prompt
string
requis

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

Required string length: 1 - 10000
Exemple:

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

​
duration
enum<string>
requis

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

Options disponibles:
2s,
3s,
4s,
5s,
6s,
7s,
8s,
9s,
10s,
11s,
12s,
13s,
14s,
15s,
16s,
18s,
20s,
25s,
30s,
1 gen,
Auto
Exemple:

"10s"

​
consents
object

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

​
negative_prompt
string

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

Maximum string length: 10000
Exemple:

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

Options disponibles:
1:1,
2:3,
3:2,
3:4,
4:3,
9:16,
16:9,
21:9
Exemple:

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

Options disponibles:
256p,
360p,
480p,
540p,
580p,
720p,
1080p,
1440p,
2160p,
4k,
2x,
4x,
true_1080p
Exemple:

"720p"

​
upscale_factor
enum<integer>
défaut:2

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

Options disponibles:
1,
2,
4
Exemple:

2

​
audio
boolean
défaut:true

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

Exemple:

true

​
image_url
string

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

Exemple:

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

Exemple:

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

Exemple:

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

Exemple:

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

​
reference_image_urls
string[]

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

Maximum array length: 9
Exemple:
["data:image/png;base64,iVBORw0K..."]
​
reference_video_urls
string[]

For models with reference video support (e.g. Seedance 2.0 R2V), up to 3 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: 3
Exemple:
["https://example.com/reference-clip.mp4"]
​
reference_audio_urls
string[]

For models with reference audio support (e.g. Seedance 2.0 R2V), up to 3 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: 3
Exemple:
["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
Exemple:
[
  {
    "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
Exemple:
["data:image/png;base64,iVBORw0K..."]

Réponse

Video generation request queued successfully

​
model
string
requis

The ID of the model used for video generation.

Exemple:

"video-model-123"

​
queue_id
string
requis

The ID of the video generation request.

Exemple:

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