视频队列 | Venice API 文档

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

调用 /video/quote 获取价格估算，然后使用返回的 queue_id 轮询 /video/retrieve 直到完成。私有模型还会为已完成的视频返回 download_url。这是一个短期分发 URL（下载失败时几次重试是可以的）；详情和可选的 DELETE 隐私操作请参阅视频生成指南。

Seedance 2.0 与 2.5

对于 seedance-2-0-*-basic 和 seedance-2-5-*-basic 模型（文生视频、图生视频、参考生视频，以及 Seedance 2.0 的 -fast-* 变体），请参阅 Seedance 2.0 与 2.5 指南了解四工作流模型（Reference / Edit / Extend / Stitch）、与源匹配的 aspect_ratio / duration 值、家族特定的多模态输入限制、公共 API 媒体政策和定价详情。

公共 Seedance 媒体政策

公共 Seedance 模型不使用同意声明流程（consents.seedance / needs_consent）。包含可检测人物的媒体可能在上游被拒绝。要使用完整的 Seedance 功能集，请使用 Venice 应用或 Studio。详情请参阅 Seedance 指南。

视频放大

对于 topaz-video-upscale 模型，请使用 upscale_factor（1、2 或 4）代替 resolution，并提供 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"

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

prompt

string

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 20000 for some models).

Required string length: 1 - 20000

示例:

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

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"

omni_reference_task_type

enum<string>

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.

可用选项:

auto,

reference,

edit,

extend

示例:

"edit"

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,

2k,

4k,

1x,

2x,

4x,

2K,

480P,

768P,

1080P,

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

enhancement_model

string

For enhancement models only. The provider-side enhancement model. Available values are listed per model in GET /models constraints.topaz.models.

示例:

"Proteus"

target_fps

integer

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.

示例:

60

softness

number

For enhancement models only. Softness level (1-5, sharpest to softest).

必填范围: 1 <= x <= 5

示例:

3

creativity

number

For enhancement models only. How much new detail the model invents (0.0-1.0).

必填范围: 0 <= x <= 1

示例:

0.5

realism

number

For enhancement models only. Bias generated detail toward photorealism (0.0-1.0).

必填范围: 0 <= x <= 1

示例:

0.5

sharp

number

For enhancement models only. Output sharpness (0.0 softens, 0.5 neutral, 1.0 strong).

必填范围: 0 <= x <= 1

示例:

0.5

compression

number

For enhancement models only. Compression artifact removal level (0.0-1.0).

必填范围: 0 <= x <= 1

示例:

0.5

noise

number

For enhancement models only. Noise reduction level (0.0-1.0).

必填范围: 0 <= x <= 1

示例:

0.5

halo

number

For enhancement models only. Halo reduction level (0.0-1.0).

必填范围: 0 <= x <= 1

示例:

0.5

grain

number

For enhancement models only. Film grain amount (0.0-0.1).

必填范围: 0 <= x <= 0.1

示例:

0

recover_detail

number

For enhancement models only. Recover original detail level (0.0-1.0).

必填范围: 0 <= x <= 1

示例:

0.5

h264_output

boolean

For enhancement models only. Output H.264 instead of the default H.265.

示例:

false

output_format

enum<string>

For enhancement models only (SDR-to-HDR). Output container: mp4 (10-bit H265 HDR10) or prores (10-bit ProRes).

可用选项:

mp4,

prores

示例:

"mp4"

slowdown_factor

enum<integer>

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.

可用选项:

1,

2,

4,

8

示例:

1

audio

boolean

默认值:true

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

示例:

true

camera_trajectory

object[]

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 elements

Show child attributes

示例:

[
  {
    "time": 0,
    "azimuth": 0,
    "elevation": 0,
    "distance": 1
  },
  {
    "time": 1,
    "azimuth": 45,
    "elevation": 10,
    "distance": 1
  }
]

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

reference_document_urls

string[]

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: 1

示例:

["https://example.com/brief.pdf"]

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

Venice APIs

排队视频生成

Seedance 2.0 与 2.5

公共 Seedance 媒体政策

视频放大

授权

请求体

响应

​Seedance 2.0 与 2.5

​公共 Seedance 媒体政策

​视频放大

授权

请求体

响应

Seedance 2.0 与 2.5

公共 Seedance 媒体政策

视频放大