跳转到主要内容
POST
/
video
/
queue
/api/v1/video/queue
curl --request POST \
  --url https://api.venice.ai/api/v1/video/queue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2-0-text-to-video",
  "prompt": "Commerce being conducted in the city of Venice, Italy.",
  "duration": "10s",
  "consents": {},
  "negative_prompt": "low resolution, error, worst quality, low quality, defects",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "upscale_factor": 2,
  "audio": true,
  "image_url": "data:image/png;base64,iVBORw0K...",
  "end_image_url": "data:image/png;base64,iVBORw0K...",
  "audio_url": "data:audio/mpeg;base64,SUQzBAA...",
  "video_url": "data:video/mp4;base64,AAAAFGZ0eXA...",
  "reference_image_urls": [
    "data:image/png;base64,iVBORw0K..."
  ],
  "reference_video_urls": [
    "https://example.com/reference-clip.mp4"
  ],
  "reference_audio_urls": [
    "data:audio/mpeg;base64,SUQzBAAAAAA..."
  ],
  "elements": [
    {
      "frontal_image_url": "data:image/png;base64,iVBORw0K...",
      "reference_image_urls": [
        "data:image/png;base64,iVBORw0K..."
      ]
    }
  ],
  "scene_image_urls": [
    "data:image/png;base64,iVBORw0K..."
  ]
}
'
{
  "model": "video-model-123",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "download_url": "<string>"
}
调用 /video/quote 获取价格估算，然后使用返回的 queue_id 轮询 /video/retrieve 直到完成。 私有模型还会为已完成的视频返回 download_url。这是一个短期分发 URL（下载失败时几次重试是可以的）；详情和可选的 DELETE 隐私操作请参阅视频生成指南。

​
Seedance 2.0

对于 seedance-2-0-* 模型（文生视频、图生视频、参考生视频以及 -fast-* 变体），请参阅 Seedance 2.0 指南 了解四工作流模型（Reference / Edit / Extend / Stitch）、规范的 prompt 模式、多模态输入限制和定价详情。

​
Seedance 同意声明

当 Seedance 的图生视频或参考生视频请求包含人脸时，API 会返回带有政策文本的 409 needs_consent，您需要在重新提交相同请求时附带 consents.seedance 证明。完整流程、同意对象、去重和撤销机制请参阅 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"

​
prompt
string
必填

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

Required string length: 1 - 10000
示例:

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

​
duration
enum<string>
必填

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

可用选项:
2s,
3s,
4s,
5s,
6s,
7s,
8s,
9s,
10s,
11s,
12s,
13s,
14s,
15s,
16s,
18s,
20s,
25s,
30s,
1 gen,
Auto
示例:

"10s"

​
consents
object

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

​
negative_prompt
string

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

Maximum string length: 10000
示例:

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

可用选项:
1:1,
2:3,
3:2,
3:4,
4:3,
9:16,
16:9,
21:9
示例:

"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,
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 9 images for character/style consistency. Each must be a URL or data URL.

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

For models with reference video support (e.g. Seedance 2.0 R2V), up to 3 reference video URLs (role: "reference_video") used to inherit subject motion, camera movement, and overall style. Per-clip 2–15 s, .mp4 or .mov, ≤50 MB; aggregate duration ≤15 s. Each must be a URL or data URL.

Maximum array length: 3
示例:
["https://example.com/reference-clip.mp4"]
​
reference_audio_urls
string[]

For models with reference audio support (e.g. Seedance 2.0 R2V), up to 3 reference audio URLs (role: "reference_audio") used as donors for vocal timbre, narration, or sound effects. Per-clip 2–15 s, .wav or .mp3; aggregate duration ≤15 s. Must be paired with at least one reference image or reference video — audio-only Reference workflows are rejected at validation. Each must be a URL or data URL.

Maximum array length: 3
示例:
["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
示例:
[
  {
    "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..."]

响应

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.