وضع توليد الفيديو في قائمة الانتظار
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.
/video/quote للحصول على تقدير للسعر، ثم استعلِم /video/retrieve باستخدام الـ queue_id المُعاد حتى يكتمل.
تُعيد النماذج الخاصة أيضًا download_url للفيديو النهائي. وهو عنوان URL للتسليم قصير الأمد (لا بأس بإعادة المحاولة بضع مرات في حال انقطع التنزيل)؛ راجع دليل توليد الفيديو للتفاصيل وDELETE الاختيارية للخصوصية.
Seedance 2.0 و 2.5
لنماذجseedance-2-0-*-api و seedance-2-5-*-api (text-to-video و image-to-video و reference-to-video، بالإضافة إلى متغيّرات -fast-* لـ Seedance 2.0)، راجع دليل Seedance 2.0 و 2.5 لنموذج سير العمل الأربعة (Reference / Edit / Extend / Stitch) وحدود الوسائط المتعددة حسب العائلة وسلوك واجهة faces-off وتفاصيل التسعير.
واجهة Seedance بدون وجوه (faces-off)
نماذج Seedance العامة لا تدعم تجهيز أصول الوجه ولا إثبات موافقة الوجه. قد تُرفض المدخلات التي تحتوي على وجوه في المنبع. لتوليد likeness / أصول الوجه استخدم تطبيق Venice أو Studio. راجع دليل Seedance.تكبير الفيديو
لنموذجtopaz-video-upscale، استخدم upscale_factor (1 أو 2 أو 4) بدلًا من resolution، وقدّم video_url. يتم اكتشاف المدة و FPS تلقائيًا من ملف الفيديو. راجع دليل تكبير الفيديو للحصول على التفاصيل والأمثلة الكاملة.
التفويضات
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
الجسم
Request body for video generation. Available fields and valid values vary by model.
The model to use for video generation.
"seedance-2-0-text-to-video"
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).
1 - 20000"Commerce being conducted in the city of Venice, Italy."
The duration of the video to generate. Available options vary by model.
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 gen, Auto "10s"
Optional provider-specific consent attestations. Seedance consent is required only when submitted media contains faces.
Optional negative prompt. The maximum length varies by model (default 2500 characters, up to 20000 for some models).
20000"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.
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"
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"
For upscale models only. 1 = quality enhancement, 2 = double resolution (default), 4 = quadruple.
1, 2, 4 2
For models which support audio generation and configuration. Defaults to true.
true
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..."
For models that support end images or transitions, the end frame image. Must be a URL or data URL.
"data:image/png;base64,iVBORw0K..."
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..."
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..."
For models with reference image support, up to 30 images for character/style consistency. Each must be a URL or data URL.
30For 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.
10For 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.
10For models with advanced element support (e.g., Kling O3 R2V). Up to 4 elements defining characters/objects. Reference in prompt as @Element1, @Element2, etc.
4For models with advanced element support. Up to 4 scene reference images. Reference in prompt as @Image1, @Image2, etc.
4For 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.
10الاستجابة
Video generation request queued successfully
The ID of the model used for video generation.
"video-model-123"
The ID of the video generation request.
"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.