Vídeo
Enfileirar Geração de Vídeo
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>"
}Chame
/video/quote para obter uma estimativa de preço e depois faça polling em /video/retrieve com o queue_id retornado até concluir.
Alguns modelos também retornam uma download_url para o vídeo finalizado. Verifique se ela está presente na resposta; se estiver ausente, obtenha o vídeo por meio de /video/retrieve. A download_url é uma URL de entrega de curta duração (algumas tentativas são aceitáveis caso um download caia); veja o guia de Geração de Vídeo para detalhes e para o DELETE opcional para privacidade.
Seedance 2.0 & 2.5
Para os modelosseedance-2-0-*-basic e seedance-2-5-*-basic (text-to-video, image-to-video, reference-to-video, além das variantes -fast-* do Seedance 2.0), veja o Guia do Seedance 2.0 & 2.5 para o modelo de quatro workflows (Reference / Edit / Extend / Stitch), valores aspect_ratio / duration correspondentes à origem, bitrate_mode configurável pelo usuário, limites multimodais específicos por família, política de mídia da API pública e detalhes de preço.
Política de mídia pública do Seedance
Os modelos públicos do Seedance não utilizam atestação de consentimento (consents.seedance / needs_consent). Mídia com pessoas detectáveis pode ser rejeitada upstream. Use o app Venice ou o Studio para o conjunto completo de recursos do Seedance. Veja o guia do Seedance para detalhes.
Upscaling de vídeo
Para o modelotopaz-video-upscale, use upscale_factor (1, 2 ou 4) em vez de resolution e forneça uma video_url. Duração e FPS são detectados automaticamente a partir do arquivo de vídeo. Veja o Guia de Upscaling de Vídeo para detalhes e exemplos completos.
Autorizações
BearerAuthsiwx
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
application/json
Request body for video generation. Available fields and valid values vary by model.
The model to use for video generation.
Exemplo:
"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).
Opções disponíveis:
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 Exemplo:
"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 - 32000Exemplo:
"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:
32000Exemplo:
"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).
Opções disponíveis:
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 Exemplo:
"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.
Opções disponíveis:
auto, reference, edit, extend Exemplo:
"edit"
The resolution of the video. Available options vary by model. Some models do not support resolution. Use upscale_factor for upscale models.
Opções disponíveis:
256p, 360p, 480p, 540p, 580p, 720p, 768p, 1080p, 1440p, 2160p, 2k, 4k, 1x, 2x, 4x, 2K, 480P, 768P, 1080P, true_1080p Exemplo:
"720p"
For upscale models only. 1 = quality enhancement, 2 = double resolution (default), 4 = quadruple.
Opções disponíveis:
1, 2, 4 Exemplo:
2
For enhancement models only. The provider-side enhancement model. Available values are listed per model in GET /models constraints.topaz.models.
Exemplo:
"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.
Exemplo:
60
For enhancement models only. Softness level (1-5, sharpest to softest).
Intervalo obrigatório:
1 <= x <= 5Exemplo:
3
For enhancement models only. How much new detail the model invents (0.0-1.0).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Bias generated detail toward photorealism (0.0-1.0).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Output sharpness (0.0 softens, 0.5 neutral, 1.0 strong).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Compression artifact removal level (0.0-1.0).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Noise reduction level (0.0-1.0).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Halo reduction level (0.0-1.0).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Film grain amount (0.0-0.1).
Intervalo obrigatório:
0 <= x <= 0.1Exemplo:
0
For enhancement models only. Recover original detail level (0.0-1.0).
Intervalo obrigatório:
0 <= x <= 1Exemplo:
0.5
For enhancement models only. Output H.264 instead of the default H.265.
Exemplo:
false
For enhancement models only (SDR-to-HDR). Output container: mp4 (10-bit H265 HDR10) or prores (10-bit ProRes).
Opções disponíveis:
mp4, prores Exemplo:
"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.
Opções disponíveis:
1, 2, 4, 8 Exemplo:
1
For models which support audio generation and configuration. Defaults to true.
Exemplo:
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
Exemplo:
[
{
"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/...).
Exemplo:
"data:image/png;base64,iVBORw0K..."
For models that support end images or transitions, the end frame image. Must be a URL or data URL.
Exemplo:
"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.
Intervalo obrigatório:
0 <= x <= 1Exemplo:
1
For models that support audio input, background music. Must be a URL or data URL. Supported: WAV, MP3. Max: 30s, 15MB.
Exemplo:
"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.
Exemplo:
"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:
30Exemplo:
["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:
10Exemplo:
["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:
10Exemplo:
["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:
1Exemplo:
["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
Exemplo:
[
{
"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:
4Exemplo:
["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
Exemplo:
[
{
"image_url": "data:image/png;base64,iVBORw0K...",
"frame_index": 0
},
{
"image_url": "data:image/png;base64,iVBORw0K...",
"frame_index": 120
}
]
Resposta
Video generation request queued successfully
The ID of the model used for video generation.
Exemplo:
"video-model-123"
The ID of the video generation request.
Exemplo:
"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.
Esta página foi útil?
⌘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>"
}