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-basic",
  "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-basic",
    "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-basic',
    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-basic',
    '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-basic\",\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-basic\",\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-basic\",\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>"
}

/video/quote를 호출하여 가격 견적을 받은 다음, 완료될 때까지 반환된 queue_id로 /video/retrieve를 폴링하세요. 비공개 모델은 완성된 비디오를 위한 download_url도 반환합니다. 이는 수명이 짧은 전달 URL입니다(다운로드가 끊겨도 몇 번의 재시도는 괜찮습니다). 자세한 내용과 개인정보 보호를 위한 선택적 DELETE는 비디오 생성 가이드를 참조하세요.

Seedance 2.0 및 2.5

seedance-2-0-*-basic 및 seedance-2-5-*-basic 모델(text-to-video, image-to-video, reference-to-video 그리고 Seedance 2.0 -fast-* 변형)의 경우, 네 가지 워크플로우 모델(Reference / Edit / Extend / Stitch), 소스와 일치하는 aspect_ratio / duration 값, 패밀리별 멀티모달 제한, 공개 API 미디어 정책 및 가격 세부 정보는 Seedance 2.0 및 2.5 가이드를 참조하세요.

공개 Seedance 미디어 정책

공개 Seedance 모델은 동의 증명(consents.seedance / needs_consent)을 사용하지 않습니다. 감지 가능한 인물이 포함된 미디어는 업스트림에서 거부될 수 있습니다. Seedance의 전체 기능 세트를 사용하려면 Venice 앱 또는 Studio를 이용하세요. 자세한 내용은 Seedance 가이드를 참조하세요.

비디오 업스케일링

topaz-video-upscale 모델의 경우, resolution 대신 upscale_factor(1, 2 또는 4)를 사용하고 video_url을 제공하세요. 길이와 FPS는 비디오 파일에서 자동으로 감지됩니다. 전체 세부 정보와 예제는 비디오 업스케일링 가이드를 참조하세요.

인증

Authorization

string

header

필수

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

본문

application/json

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

model

string

필수

The model to use for video generation.

예시:

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

prompt

string

필수

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

예시:

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

duration

enum<string>

필수

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

사용 가능한 옵션:

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

예시:

"10s"

consents

object

Optional provider-specific consent attestations. Required only for models that return a needs_consent response.

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

예시:

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

사용 가능한 옵션:

1:1,

2:3,

3:2,

3:4,

4:3,

4:5,

5:4,

9:16,

9:21,

16:9,

21:9,

adaptive,

auto

예시:

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

사용 가능한 옵션:

256p,

360p,

480p,

540p,

580p,

720p,

1080p,

1440p,

2160p,

4k,

2x,

4x,

2K,

768P,

true_1080p

예시:

"720p"

upscale_factor

enum<integer>

기본값:2

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

사용 가능한 옵션:

1,

2,

4

예시:

2

audio

boolean

기본값:true

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

예시:

true

image_url

string

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

예시:

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

예시:

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

예시:

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

예시:

"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

예시:

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

예시:

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

예시:

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

예시:

[
  {
    "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

예시:

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

예시:

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

응답

Video generation request queued successfully

model

string

필수

The ID of the model used for video generation.

예시:

"video-model-123"

queue_id

string

필수

The ID of the video generation request.

예시:

"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-basic",
  "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-basic",
    "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-basic',
    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-basic',
    '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-basic\",\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-basic\",\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-basic\",\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

비디오 생성 큐

Seedance 2.0 및 2.5

공개 Seedance 미디어 정책

비디오 업스케일링

인증

본문

응답

​Seedance 2.0 및 2.5

​공개 Seedance 미디어 정책

​비디오 업스케일링

인증

본문

응답

Seedance 2.0 및 2.5

공개 Seedance 미디어 정책

비디오 업스케일링