الانتقال إلى المحتوى الرئيسي
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 للحصول على تقدير للسعر، ثم استعلِم /video/retrieve باستخدام الـ queue_id المُعاد حتى يكتمل. تُعيد النماذج الخاصة أيضًا download_url للفيديو النهائي. وهو عنوان URL للتسليم قصير الأمد (لا بأس بإعادة المحاولة بضع مرات في حال انقطع التنزيل)؛ راجع دليل توليد الفيديو للتفاصيل وDELETE الاختيارية للخصوصية.

​
Seedance 2.0

بالنسبة لنماذج seedance-2-0-* (text-to-video، image-to-video، reference-to-video، بالإضافة إلى متغيرات -fast-*)، راجع دليل Seedance 2.0 لنموذج التدفقات الأربعة (Reference / Edit / Extend / Stitch)، وأنماط الـ prompt القياسية، وحدود الإدخال متعدد الوسائط، وتفاصيل التسعير.

​
موافقة Seedance

عندما يحتوي طلب image-to-video أو reference-to-video في 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.