Vidéo
Mettre en file d'attente une génération vidéo
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
/
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-basic",
"duration": "10s",
"consents": {},
"prompt": "Commerce being conducted in the city of Venice, Italy.",
"negative_prompt": "low resolution, error, worst quality, low quality, defects",
"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,
"grain": 0,
"recover_detail": 0.5,
"h264_output": false,
"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
}
]
}
'import requests
url = "https://api.venice.ai/api/v1/video/queue"
payload = {
"model": "seedance-2-0-text-to-video-basic",
"duration": "10s",
"consents": {},
"prompt": "Commerce being conducted in the city of Venice, Italy.",
"negative_prompt": "low resolution, error, worst quality, low quality, defects",
"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,
"grain": 0,
"recover_detail": 0.5,
"h264_output": False,
"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
}
]
}
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-basic',
duration: '10s',
consents: {},
prompt: 'Commerce being conducted in the city of Venice, Italy.',
negative_prompt: 'low resolution, error, worst quality, low quality, defects',
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,
grain: 0,
recover_detail: 0.5,
h264_output: false,
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}
]
})
};
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-basic',
'duration' => '10s',
'consents' => [
],
'prompt' => 'Commerce being conducted in the city of Venice, Italy.',
'negative_prompt' => 'low resolution, error, worst quality, low quality, defects',
'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,
'grain' => 0,
'recover_detail' => 0.5,
'h264_output' => false,
'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
]
]
]),
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-basic\",\n \"duration\": \"10s\",\n \"consents\": {},\n \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n \"aspect_ratio\": \"16:9\",\n \"omni_reference_task_type\": \"edit\",\n \"resolution\": \"720p\",\n \"upscale_factor\": 2,\n \"enhancement_model\": \"Proteus\",\n \"target_fps\": 60,\n \"softness\": 3,\n \"creativity\": 0.5,\n \"realism\": 0.5,\n \"sharp\": 0.5,\n \"compression\": 0.5,\n \"noise\": 0.5,\n \"halo\": 0.5,\n \"grain\": 0,\n \"recover_detail\": 0.5,\n \"h264_output\": false,\n \"output_format\": \"mp4\",\n \"slowdown_factor\": 1,\n \"audio\": true,\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 1\n },\n {\n \"time\": 1,\n \"azimuth\": 45,\n \"elevation\": 10,\n \"distance\": 1\n }\n ],\n \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"image_strength\": 1,\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 \"reference_document_urls\": [\n \"https://example.com/brief.pdf\"\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-basic\",\n \"duration\": \"10s\",\n \"consents\": {},\n \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n \"aspect_ratio\": \"16:9\",\n \"omni_reference_task_type\": \"edit\",\n \"resolution\": \"720p\",\n \"upscale_factor\": 2,\n \"enhancement_model\": \"Proteus\",\n \"target_fps\": 60,\n \"softness\": 3,\n \"creativity\": 0.5,\n \"realism\": 0.5,\n \"sharp\": 0.5,\n \"compression\": 0.5,\n \"noise\": 0.5,\n \"halo\": 0.5,\n \"grain\": 0,\n \"recover_detail\": 0.5,\n \"h264_output\": false,\n \"output_format\": \"mp4\",\n \"slowdown_factor\": 1,\n \"audio\": true,\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 1\n },\n {\n \"time\": 1,\n \"azimuth\": 45,\n \"elevation\": 10,\n \"distance\": 1\n }\n ],\n \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"image_strength\": 1,\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 \"reference_document_urls\": [\n \"https://example.com/brief.pdf\"\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-basic\",\n \"duration\": \"10s\",\n \"consents\": {},\n \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n \"aspect_ratio\": \"16:9\",\n \"omni_reference_task_type\": \"edit\",\n \"resolution\": \"720p\",\n \"upscale_factor\": 2,\n \"enhancement_model\": \"Proteus\",\n \"target_fps\": 60,\n \"softness\": 3,\n \"creativity\": 0.5,\n \"realism\": 0.5,\n \"sharp\": 0.5,\n \"compression\": 0.5,\n \"noise\": 0.5,\n \"halo\": 0.5,\n \"grain\": 0,\n \"recover_detail\": 0.5,\n \"h264_output\": false,\n \"output_format\": \"mp4\",\n \"slowdown_factor\": 1,\n \"audio\": true,\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 1\n },\n {\n \"time\": 1,\n \"azimuth\": 45,\n \"elevation\": 10,\n \"distance\": 1\n }\n ],\n \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"image_strength\": 1,\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 \"reference_document_urls\": [\n \"https://example.com/brief.pdf\"\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": [
"image"
],
"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>"
}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.
Certains modèles renvoient également un download_url pour la vidéo terminée. Vérifiez s’il est présent dans la réponse ; s’il est absent, récupérez la vidéo via /video/retrieve. download_url est 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 & 2.5
Pour les modèlesseedance-2-0-*-basic et seedance-2-5-*-basic (text-to-video, image-to-video, reference-to-video, plus les variantes -fast-* de Seedance 2.0), voir le guide Seedance 2.0 & 2.5 pour le modèle à quatre workflows (Reference / Edit / Extend / Stitch), les valeurs aspect_ratio / duration alignées sur la source, le paramètre bitrate_mode réglable par l’utilisateur, les limites multimodales spécifiques à chaque famille, la politique média de l’API publique et les détails de tarification.
Politique média publique de Seedance
Les modèles Seedance publics n’utilisent pas d’attestation de consentement (consents.seedance / needs_consent). Les médias contenant des personnes détectables peuvent être rejetés en amont. Utilisez l’application Venice ou Studio pour bénéficier de l’ensemble complet des fonctionnalités Seedance. Voir le guide Seedance pour plus de détails.
Agrandissement vidéo
Pour le modèletopaz-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
BearerAuthsiwx
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.
The model to use for video generation.
Exemple:
"seedance-2-0-text-to-video-basic"
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).
Options 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, 1 gen, auto, Auto Exemple:
"10s"
Optional provider-specific consent attestations. Required only for models that return a needs_consent response.
Show child attributes
Show child attributes
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 32000 for some models).
Required string length:
1 - 32000Exemple:
"Commerce being conducted in the city of Venice, Italy."
Optional negative prompt. The maximum length varies by model (default 2500 characters, up to 32000 for some models).
Maximum string length:
32000Exemple:
"low resolution, error, worst quality, low quality, defects"
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).
Options disponibles:
1:1, 2:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 9:21, 16:9, 21:9, adaptive, auto Exemple:
"16:9"
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.
Options disponibles:
auto, reference, edit, extend Exemple:
"edit"
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, 768p, 1080p, 1440p, 2160p, 2k, 4k, 1x, 2x, 4x, 2K, 480P, 768P, 1080P, true_1080p Exemple:
"720p"
For upscale models only. 1 = quality enhancement, 2 = double resolution (default), 4 = quadruple.
Options disponibles:
1, 2, 4 Exemple:
2
For enhancement models only. The provider-side enhancement model. Available values are listed per model in GET /models constraints.topaz.models.
Exemple:
"Proteus"
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.
Exemple:
60
For enhancement models only. Softness level (1-5, sharpest to softest).
Plage requise:
1 <= x <= 5Exemple:
3
For enhancement models only. How much new detail the model invents (0.0-1.0).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Bias generated detail toward photorealism (0.0-1.0).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Output sharpness (0.0 softens, 0.5 neutral, 1.0 strong).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Compression artifact removal level (0.0-1.0).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Noise reduction level (0.0-1.0).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Halo reduction level (0.0-1.0).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Film grain amount (0.0-0.1).
Plage requise:
0 <= x <= 0.1Exemple:
0
For enhancement models only. Recover original detail level (0.0-1.0).
Plage requise:
0 <= x <= 1Exemple:
0.5
For enhancement models only. Output H.264 instead of the default H.265.
Exemple:
false
For enhancement models only (SDR-to-HDR). Output container: mp4 (10-bit H265 HDR10) or prores (10-bit ProRes).
Options disponibles:
mp4, prores Exemple:
"mp4"
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.
Options disponibles:
1, 2, 4, 8 Exemple:
1
For models which support audio generation and configuration. Defaults to true.
Exemple:
true
For H3 Max Multi-Angle only. 2–12 camera keyframes with strictly increasing normalized time (0–1), azimuth in degrees (signed; total absolute travel at most 32 turns), elevation in degrees (−90 to 90), and positive distance relative to the initial camera (1 = unchanged). Omit to leave the camera path to the model. Requires image_url; aspect ratio follows that image.
Required array length:
2 - 12 elementsShow child attributes
Show child attributes
Exemple:
[
{
"time": 0,
"azimuth": 0,
"elevation": 0,
"distance": 1
},
{
"time": 1,
"azimuth": 45,
"elevation": 10,
"distance": 1
}
]
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..."
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..."
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.
Plage requise:
0 <= x <= 1Exemple:
1
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..."
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..."
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:
30Exemple:
["data:image/png;base64,iVBORw0K..."]
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:
10Exemple:
["https://example.com/reference-clip.mp4"]
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:
10Exemple:
["data:audio/mpeg;base64,SUQzBAAAAAA..."]
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.
Maximum array length:
1Exemple:
["https://example.com/brief.pdf"]
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:
4Show child attributes
Show child attributes
Exemple:
[
{
"frontal_image_url": "data:image/png;base64,iVBORw0K...",
"reference_image_urls": ["data:image/png;base64,iVBORw0K..."]
}
]
For models with advanced element support. Up to 4 scene reference images. Reference in prompt as @Image1, @Image2, etc.
Maximum array length:
4Exemple:
["data:image/png;base64,iVBORw0K..."]
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:
10Show child attributes
Show child attributes
Exemple:
[
{
"image_url": "data:image/png;base64,iVBORw0K...",
"frame_index": 0
},
{
"image_url": "data:image/png;base64,iVBORw0K...",
"frame_index": 120
}
]
Réponse
Video generation request queued successfully
The ID of the model used for video generation.
Exemple:
"video-model-123"
The ID of the video generation request.
Exemple:
"123e4567-e89b-12d3-a456-426614174000"
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.
Cette page vous a-t-elle été utile ?
⌘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-basic",
"duration": "10s",
"consents": {},
"prompt": "Commerce being conducted in the city of Venice, Italy.",
"negative_prompt": "low resolution, error, worst quality, low quality, defects",
"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,
"grain": 0,
"recover_detail": 0.5,
"h264_output": false,
"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
}
]
}
'import requests
url = "https://api.venice.ai/api/v1/video/queue"
payload = {
"model": "seedance-2-0-text-to-video-basic",
"duration": "10s",
"consents": {},
"prompt": "Commerce being conducted in the city of Venice, Italy.",
"negative_prompt": "low resolution, error, worst quality, low quality, defects",
"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,
"grain": 0,
"recover_detail": 0.5,
"h264_output": False,
"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
}
]
}
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-basic',
duration: '10s',
consents: {},
prompt: 'Commerce being conducted in the city of Venice, Italy.',
negative_prompt: 'low resolution, error, worst quality, low quality, defects',
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,
grain: 0,
recover_detail: 0.5,
h264_output: false,
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}
]
})
};
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-basic',
'duration' => '10s',
'consents' => [
],
'prompt' => 'Commerce being conducted in the city of Venice, Italy.',
'negative_prompt' => 'low resolution, error, worst quality, low quality, defects',
'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,
'grain' => 0,
'recover_detail' => 0.5,
'h264_output' => false,
'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
]
]
]),
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-basic\",\n \"duration\": \"10s\",\n \"consents\": {},\n \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n \"aspect_ratio\": \"16:9\",\n \"omni_reference_task_type\": \"edit\",\n \"resolution\": \"720p\",\n \"upscale_factor\": 2,\n \"enhancement_model\": \"Proteus\",\n \"target_fps\": 60,\n \"softness\": 3,\n \"creativity\": 0.5,\n \"realism\": 0.5,\n \"sharp\": 0.5,\n \"compression\": 0.5,\n \"noise\": 0.5,\n \"halo\": 0.5,\n \"grain\": 0,\n \"recover_detail\": 0.5,\n \"h264_output\": false,\n \"output_format\": \"mp4\",\n \"slowdown_factor\": 1,\n \"audio\": true,\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 1\n },\n {\n \"time\": 1,\n \"azimuth\": 45,\n \"elevation\": 10,\n \"distance\": 1\n }\n ],\n \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"image_strength\": 1,\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 \"reference_document_urls\": [\n \"https://example.com/brief.pdf\"\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-basic\",\n \"duration\": \"10s\",\n \"consents\": {},\n \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n \"aspect_ratio\": \"16:9\",\n \"omni_reference_task_type\": \"edit\",\n \"resolution\": \"720p\",\n \"upscale_factor\": 2,\n \"enhancement_model\": \"Proteus\",\n \"target_fps\": 60,\n \"softness\": 3,\n \"creativity\": 0.5,\n \"realism\": 0.5,\n \"sharp\": 0.5,\n \"compression\": 0.5,\n \"noise\": 0.5,\n \"halo\": 0.5,\n \"grain\": 0,\n \"recover_detail\": 0.5,\n \"h264_output\": false,\n \"output_format\": \"mp4\",\n \"slowdown_factor\": 1,\n \"audio\": true,\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 1\n },\n {\n \"time\": 1,\n \"azimuth\": 45,\n \"elevation\": 10,\n \"distance\": 1\n }\n ],\n \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"image_strength\": 1,\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 \"reference_document_urls\": [\n \"https://example.com/brief.pdf\"\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-basic\",\n \"duration\": \"10s\",\n \"consents\": {},\n \"prompt\": \"Commerce being conducted in the city of Venice, Italy.\",\n \"negative_prompt\": \"low resolution, error, worst quality, low quality, defects\",\n \"aspect_ratio\": \"16:9\",\n \"omni_reference_task_type\": \"edit\",\n \"resolution\": \"720p\",\n \"upscale_factor\": 2,\n \"enhancement_model\": \"Proteus\",\n \"target_fps\": 60,\n \"softness\": 3,\n \"creativity\": 0.5,\n \"realism\": 0.5,\n \"sharp\": 0.5,\n \"compression\": 0.5,\n \"noise\": 0.5,\n \"halo\": 0.5,\n \"grain\": 0,\n \"recover_detail\": 0.5,\n \"h264_output\": false,\n \"output_format\": \"mp4\",\n \"slowdown_factor\": 1,\n \"audio\": true,\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 1\n },\n {\n \"time\": 1,\n \"azimuth\": 45,\n \"elevation\": 10,\n \"distance\": 1\n }\n ],\n \"image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"end_image_url\": \"data:image/png;base64,iVBORw0K...\",\n \"image_strength\": 1,\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 \"reference_document_urls\": [\n \"https://example.com/brief.pdf\"\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": [
"image"
],
"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>"
}