> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 2.0 و 2.5
> توليد الفيديوهات وتحريرها وتمديدها ودمجها باستخدام Seedance 2.0 و 2.5 على Venice - تدفقات النص إلى الفيديو والصورة إلى الفيديو والمرجع إلى الفيديو، وسياسة وسائط واجهة برمجة التطبيقات العامة، وحدود الوسائط المتعددة الخاصة بكل عائلة.
Seedance هي عائلة فيديو رائدة متعددة الوسائط على Venice لتوليد الفيديو المدفوع بالنص والصور والمراجع. تشترك **Seedance 2.0** (بالإضافة إلى Fast) و **Seedance 2.5** في نموذج توجيه الـ prompt نفسه في R2V: نقطة نهاية واحدة للمرجع إلى الفيديو تتعامل مع **أربعة تدفقات مميزة** (Reference و Edit و Extend و Stitch) — يُستنتَج التدفق من **شكل الـ prompt الخاص بك**.
يغطي هذا الدليل المتغيرات، والتدفقات الأربعة، و**سياسة وسائط واجهة برمجة التطبيقات العامة**، و**حدود الوسائط المتعددة الخاصة بكل عائلة**، والتسعير، وأمثلة `curl`.
**الوسائط التي تحتوي على أشخاص غير مدعومة على واجهة Seedance API العامة.** لا تستخدم نماذج `*-basic` العامة إثباتات موافقة. قد يتم رفض مثل هذه المدخلات من الطبقات الأعلى كخطأ سياسة محتوى أو خطأ من المزوّد. استخدم تطبيق Venice أو Studio للحصول على مجموعة ميزات Seedance الكاملة.
## المتغيرات
| Model ID | المتغير | دقات الإخراج | ملاحظات |
| -------------------------------------------- | -------- | ---------------------------- | --------------------------------------------------------------------------------------------------- |
| `seedance-2-0-text-to-video-basic` | T2V | 480p / 720p / 1080p / **4k** | Prompt نصي فقط |
| `seedance-2-0-image-to-video-basic` | I2V | 480p / 720p / 1080p / **4k** | تثبيت أول إطار (وبشكل اختياري آخر إطار) |
| `seedance-2-0-reference-to-video-basic` | R2V | 480p / 720p / 1080p / **4k** | حتى 9 صور مرجعية + 3 فيديوهات مرجعية + 3 مصادر صوت مرجعية. يشغّل Reference / Edit / Extend / Stitch |
| `seedance-2-0-fast-text-to-video-basic` | Fast T2V | 480p / 720p | مستوى أسرع بجودة أقل (بدون 1080p / 4k) |
| `seedance-2-0-fast-image-to-video-basic` | Fast I2V | 480p / 720p | مستوى أسرع بجودة أقل (بدون 1080p / 4k) |
| `seedance-2-0-fast-reference-to-video-basic` | Fast R2V | 480p / 720p | مستوى أسرع بجودة أقل (بدون 1080p / 4k)؛ نفس مجموعة التدفقات |
| `seedance-2-5-text-to-video-basic` | T2V | 480p / 720p | إخراج حتى 30 ثانية؛ صوت أصلي |
| `seedance-2-5-image-to-video-basic` | I2V | 480p / 720p | إخراج حتى 30 ثانية؛ تثبيت أول إطار (وبشكل اختياري آخر إطار) |
| `seedance-2-5-reference-to-video-basic` | R2V | 480p / 720p | حتى 30 صورة + 10 فيديوهات + 10 مصادر صوت؛ نفس تدفقات Reference / Edit / Extend / Stitch |
جميع المتغيرات غير متزامنة. أرسل عبر `POST /api/v1/video/queue`، ثم استعلم `POST /api/v1/video/retrieve` حتى يصبح جسم الاستجابة `video/mp4`. راجع [توليد الفيديو](/guides/media/video-generation) لتدفق قائمة الانتظار العام.
مرّر `resolution` كواحدة من: `480p` أو `720p` أو `1080p` أو `4k` (أحرف صغيرة). تقبل Seedance **2.0** (غير Fast) الأربعة جميعًا؛ بينما **2.0 Fast** و **2.5** تقبلان `480p` / `720p` فقط. اكتشف معرفات النماذج الحية وقدراتها عبر `GET /models?type=video` — لا تُشفّر التوفر بشكل ثابت.
## نموذج "نموذج واحد، أربعة تدفقات"
تستخدم متغيرات المرجع إلى الفيديو (`seedance-2-0-reference-to-video-basic`، وشقيقها Fast، و `seedance-2-5-reference-to-video-basic`) نمط توجيه الـ prompt نفسه. **يستنتج النموذج المهمة من بادئة الـ prompt وشكل مدخلاتك.** لا يوجد حقل `task` أو `workflow` — بناء الـ prompt هو التوجيه.
| التدفق | ما الذي يفعله | بادئة الـ prompt | المدخلات |
| ------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Reference** | توليد فيديو جديد باستخدام الملفات المرجعية المرفوعة كمصادر للموضوع / الحركة / الأسلوب / الصوت | `Refer to ... in to generate ...` | نص + مرجع صورة أو فيديو واحد على الأقل، بالإضافة إلى مصادر صوت اختيارية (تختلف الأعداد حسب العائلة — راجع الحدود) |
| **Edit** | تعديل فيديو مدخل واحد مع الحفاظ على الباقي | `Strictly edit , changing its ...` | فيديو مدخل واحد + نص (الصور تثبيت اختياري) |
| **Extend** | تمديد للأمام / للخلف لمقطع واحد | `Extend , generate ...` | فيديو مدخل واحد + نص |
| **Stitch** | دمج المقاطع المدخلة مع انتقالات مولّدة تلقائيًا | ` + + followed by + ...` | فيديوهات مدخلة متعددة + نص (تختلف حدود عدد المقاطع / المدة حسب العائلة) |
**بناء الـ prompt قياسي وحساس لحالة الأحرف**: أقواس زاوية، حرف أول كبير، مسافة واحدة قبل الرقم — `` و `` و ``.
***
## أنماط التدفقات
### تدفق Reference
استخدم الملفات المرجعية المرفوعة كـ**مصادر** — الموضوع، المشهد، الحركة، الأسلوب، جرس الصوت — لتوليد فيديو جديد كليًا.
**أنماط الـ prompt القياسية**:
```
Refer to in to generate ...
Refer to the [action | camera scene | style | sound effect] in to generate ...
Refer to the [tone | timbre] in to generate ...
```
**أمثلة**:
* `Refer to in to generate a 5-second clip of the same character riding a horse through snow.`
* `Refer to the camera scene in to generate a similar establishing shot of a futuristic city at dawn.`
* `Refer to in and use the timbre in for the narrator describing the scene.` (يجب إقران مصادر الصوت بمرجع صورة أو فيديو واحد على الأقل — يُرفض الصوت وحده)
### تدفق Edit
عدّل فيديو مدخل واحد. **يتم الحفاظ على كل ما لم يُذكر صراحةً في الـ prompt.** استخدم هذا عندما تريد تغييرًا موضعيًا (استبدال الموضوع، تغيير الطقس / اللون، إضافة / إزالة عنصر) بدلًا من فيديو جديد كليًا.
**نمط الـ prompt القياسي**:
```
Strictly edit , changing its [original feature] to [new feature] ...
```
**أنماط فرعية لتحكم أدق**:
```
Add Elements:
At [timestamp / timing] and [spatial location] of , add [description of intended element].
Remove Elements:
Remove [element to be deleted] from , keeping the rest of the video content unchanged.
Modify Elements:
Replace [description of element to be changed] in with [description of intended element].
```
**أمثلة**:
* `Strictly edit , changing its weather from sunny to a heavy rainstorm.`
* `Add snacks such as fried chicken and pizza to the countertop in .`
* `Remove the red car from , keeping the rest of the video content unchanged.`
* `Replace the perfume featured in with the face cream from , with all original motions and camera work preserved.`
المثال الأخير يجمع بين Edit ومرجع صورة — قانوني تمامًا، حيث يستخدم النموذج `` كمصدر بصري للاستبدال.
### نسبة العرض إلى الارتفاع والمدة المتطابقة مع المصدر
بالنسبة لتدفقات **edit / extend** في المرجع إلى الفيديو من Seedance، يمكنك أن تطلب من الإخراج أن يتبع المقطع المصدر بدلًا من اختيار نسبة أو مدة ثابتة:
| الحقل | القيم | السلوك |
| -------------- | -------------------- | ----------------------------------------------------------------------------------------------------- |
| `aspect_ratio` | `adaptive` أو `auto` | تتطابق نسبة العرض إلى الارتفاع للإخراج مع الفيديو المصدر (Seedance 2.0 و 2.5 R2V) |
| `duration` | `-1` أو `auto` | تتطابق مدة الإخراج مع الفيديو المصدر (Seedance **2.5** R2V edit؛ يجب أن يكون المصدر بين 4 و 30 ثانية) |
المتطلبات:
* **Queue:** أي قيمة متطابقة مع المصدر تتطلب `reference_video_urls`.
* **Quote:** أي قيمة متطابقة مع المصدر تتطلب `reference_video_total_duration`. تُحاسَب المدة المتطابقة مع المصدر بـ `ceil(reference_video_total_duration)` ثانية.
* النسبة والمدة مستقلتان — يمكنك مطابقة إحداهما دون الأخرى.
* بالنسبة لـ **extend**، فضّل `duration` ثابتة (المدة التي تريد توليدها) واختياريًا `aspect_ratio: "adaptive"`. `duration` المتطابقة مع المصدر مخصصة لمهام edit من نوع "نفس مدة المصدر".
### تدفق Extend
استمرار مقطع واحد للأمام أو للخلف زمنيًا. **افتراضيًا تُعيد Seedance المحتوى الجديد فقط** — وليس المدخل الأصلي متسلسلًا مع الامتداد. هذا بحكم التصميم، لضمان استمرارية الانتقال؛ إذا كنت تريد الحفاظ على مقطع المدخل بجانب الامتداد، فاذكر ذلك صراحةً:
```
Extend , generate [description of extended content]
Extend backward, [description of extended content]
Extend , start with , then [description of extended content] ← preserves input at start
Extend backward, [description], and then end with ← preserves input at end
```
معالجة الانتقال: يستخرج النموذج تلقائيًا إطارات الانتقال للمزج السلس، ولا يُعاد توليد المقاطع الأصلية من فيديو المدخل.
**أمثلة**:
* `Extend , generate a dramatic chase scene through narrow alleys at dusk.`
* `Extend backward, the same character walking toward the camera before the original shot begins.`
* `Extend , start with , then the camera pulls back to reveal a vast landscape.`
### تدفق Stitch (إتمام المسار)
اربط المقاطع المدخلة بانتقالات مولّدة بالذكاء الاصطناعي. احترم حدود المدة المُجمّعة وعدد المقاطع **الخاصة بكل عائلة** في [حدود الإدخال متعدد الوسائط](#multimodal-input-limits) (Seedance 2.0: ≤3 مقاطع / ≤15 ثانية مجموع؛ Seedance 2.5: حدود فيديو أعلى).
**نمط الـ prompt القياسي**:
```
+ [transition description] + followed by [+ [transition description] + followed by ]
```
**أمثلة**:
* ` + a smooth seamless cut + followed by `
* `. The moment a leaf falls to the ground, it sets off a special effect of golden particles. A gust of wind blows by, leading into .`
* ` + a wisp of smoke transforms into a flock of birds + followed by + a slow dolly-in + followed by `
يقتطع النموذج تلقائيًا المقاطع الرابطة عند نقاط الالتقاء لضمان الاستمرارية.
***
## صيغة الـ prompt الشاملة
عبر التدفقات الأربعة جميعًا، الصيغة الموصى بها للتأليف هي:
```
Subject + Motion + Environment (Optional)
+ Camera Movement / Cut (Optional)
+ Aesthetic Description (Optional)
+ Audio (Optional)
```
* **Subject + Motion**: الأساس المنطقي — حدّد "مَن" يؤدي "أي فعل"
* **Environment + Aesthetics**: خلفية مكانية، إضاءة، أسلوب بصري
* **Camera**: نوع اللقطة أو الحركة الصريحة
* **Audio**: مؤثرات صوت محيطية أو توجيه صوتي للحصول على إخراج غامر
طبقة هذه الصيغة فوق بادئة تدفق (على سبيل المثال، `Strictly edit , changing its `) تنتج مخرجات بأعلى جودة.
***
## حدود الإدخال متعدد الوسائط
القيم أدناه هي ما يقبله Venice API. تُرفض الطلبات خارج هذه النطاقات في طبقة الـ schema بخطأ 400 قبل الوصول إلى الاستدلال.
**تستخدم Seedance 2.0 و Seedance 2.5 حدودًا مختلفة.** تحقق دائمًا من العمود الخاص بعائلة النموذج التي تستدعيها.
### الحدود الدنيا المشتركة للوسائط
| القيد | القيمة |
| -------------------------------------- | ------------------------------------------------------------------- |
| طرق إدخال الصورة / الفيديو / الصوت | URL (`http://`, `https://`) أو Base64 data URL |
| صيغ الصور | `.jpeg`, `.png`, `.webp`, `.bmp`, `.tiff`, `.gif`, `.heic`, `.heif` |
| نسبة العرض إلى الارتفاع للصورة (W / H) | حصريًا `(0.4, 2.5)` |
| الحد الأدنى لجانب الصورة | ≥ 300 بكسل |
| صيغ الفيديو | `.mp4`, `.mov` |
| برامج ترميز الفيديو | H.264 / AVC، H.265 / HEVC |
| برامج ترميز الصوت (في الحاوية) | AAC، MP3 |
| صيغ الصوت (الصوت المرجعي) | `.wav`, `.mp3` |
| حجم الفيديو لكل مقطع | ≤ 50 MB |
| حجم الصوت لكل مقطع | ≤ 15 MB |
| صور I2V للإطار الأول | 1 |
| I2V الإطار الأول + الأخير | 2 |
### مقارنة العائلات
| القيد | Seedance 2.0 (+ Fast) | Seedance 2.5 |
| ------------------------------------- | ---------------------------------------------------- | ----------------------- |
| مدة الإخراج | 4–15 ثانية | 4–30 ثانية (افتراضي 10) |
| دقات الإخراج | 480p / 720p / 1080p / **4k** (Fast: 480p / 720p فقط) | 480p / 720p فقط |
| صور R2V المرجعية | 1–9 | 1–30 |
| الحد الأقصى لبايتات صورة R2V المرجعية | (حدود الطلب المشتركة) | ≤ 30 MB لكل صورة |
| فيديوهات R2V المرجعية | ≤ 3 | ≤ 10 |
| المدة لكل فيديو مرجعي | `[2, 15]` ثانية | `[2, 30]` ثانية |
| المدة المُجمّعة للفيديو المرجعي | ≤ 15 ثانية | ≤ 30 ثانية |
| مقاطع R2V الصوتية المرجعية | ≤ 3 | ≤ 10 |
| المدة لكل صوت مرجعي | `[2, 15]` ثانية | `[2, 30]` ثانية |
| المدة المُجمّعة للصوت المرجعي | ≤ 15 ثانية | ≤ 30 ثانية |
الصوت المرجعي مدعوم على متغيرات R2V فقط. تُمرَّر كل إدخال إلى النموذج كعنصر محتوى بـ `role: "reference_audio"` يُخاطبه الـ prompt بـ `` و `` … — يستخدم النموذج كل مقطع لجرس الصوت أو المؤثرات الصوتية أو الموسيقى الخلفية بناءً على كيفية صياغة الـ prompt له. حقل `audio_url` المفرد القديم يُطابق نفس شكل المحتوى وأصبح الآن مكافئًا لتمرير `reference_audio_urls` بعنصر واحد.
**لا يمكن أن يكون `reference_audio_urls` هو مدخل المرجع الوحيد.** يتطلب النموذج مرجع صورة أو فيديو واحدًا على الأقل بجانب أي مصدر صوت. اقرن `reference_audio_urls` بـ `reference_image_urls` أو `reference_video_urls` أو `image_url` أو `video_url` — تُرفض الطلبات الصوتية فقط.
### حجم الطلب
تقبل نقطة نهاية قائمة الانتظار أجسام JSON حتى **35 MB**. عناوين URL المضمّنة للبيانات (data URLs) للفيديوهات الكبيرة يمكن أن تتجاوز هذا الحد — بالنسبة لتدفق Stitch متعدد المقاطع بشكل خاص، فضّل عناوين URL على base64 المضمّن.
***
## التسعير
استدعِ `POST /api/v1/video/quote` للحصول على عرض سعر لشكل طلب معين قبل إرساله إلى `/video/queue`. نقطة نهاية عرض السعر هي المصدر الموثوق الوحيد؛ قد تتغير تفاصيل التسعير ولا ينبغي تخزينها مؤقتًا أو تكرارها من جانب العميل.
عندما تكون الفيديوهات المرجعية جزءًا من الطلب، مرّر أيضًا `reference_video_total_duration` (مجموع مدد جميع المقاطع المرجعية بالثواني) حتى يطابق عرض السعر ما سيحاسب عليه `/video/queue`:
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"duration": "5s",
"resolution": "1080p",
"aspect_ratio": "16:9",
"reference_video_total_duration": 5
}'
```
عرض سعر edit في Seedance 2.5 المتطابق مع المصدر (يُحاسَب من مدة المصدر):
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"duration": "auto",
"resolution": "720p",
"aspect_ratio": "adaptive",
"reference_video_total_duration": 5.2
}'
```
***
## أمثلة كاملة
تفترض جميع الأمثلة أن `VENICE_API_KEY` مضبوط في البيئة.
### النص إلى فيديو
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-text-to-video-basic",
"prompt": "A golden retriever frolicking through a sunlit meadow at sunset, slow camera dolly-in, shallow depth of field, warm cinematic lighting.",
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
```
### Seedance 2.0 النص إلى فيديو (4K)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-text-to-video-basic",
"prompt": "Ultra-detailed aerial glide over a sunlit alpine lake, crystal water, distant peaks, cinematic color grade.",
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "4k"
}'
```
### Seedance 2.5 النص إلى فيديو (مدة أطول)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-text-to-video-basic",
"prompt": "A slow aerial push over misty mountains at sunrise, clouds parting, soft orchestral ambience, cinematic widescreen framing.",
"duration": "20s",
"aspect_ratio": "16:9",
"resolution": "720p"
}'
```
### الصورة إلى فيديو (الإطار الأول)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-image-to-video-basic",
"prompt": "The lighthouse keeper turns toward the storm, lantern raised, waves crashing against the rocks.",
"image_url": "https://example.com/lighthouse.jpg",
"duration": "5s",
"resolution": "720p"
}'
```
نماذج Seedance I2V (`seedance-2-0-image-to-video-basic`، ومتغيره Fast، و `seedance-2-5-image-to-video-basic`) **لا تقبل `aspect_ratio`** — تُشتق نسبة العرض إلى الارتفاع للإخراج تلقائيًا من أبعاد صورة المدخل. تمرير الحقل يُعيد خطأ 400 مع *"This model does not support aspect\_ratio"*. استخدم متغيرات T2V أو R2V إذا كنت بحاجة إلى تحكم صريح في نسبة العرض إلى الارتفاع.
### تدفق Reference — مصدر الموضوع
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Refer to in to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night.",
"reference_image_urls": ["https://example.com/character.png"],
"duration": "5s",
"aspect_ratio": "9:16",
"resolution": "1080p"
}'
```
### تدفق Reference في Seedance 2.5 — صور متعددة
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"prompt": "Refer to in and the style in to generate a 12-second clip of the same character exploring a rainy cyberpunk alley.",
"reference_image_urls": [
"https://example.com/character.png",
"https://example.com/style-board.png"
],
"duration": "12s",
"aspect_ratio": "9:16",
"resolution": "720p"
}'
```
### تدفق Reference — مصدر موضوع + صوت
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Refer to in to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night. Refer to the timbre in for a soft female voiceover describing the scene.",
"reference_image_urls": ["https://example.com/character.png"],
"reference_audio_urls": ["https://example.com/voice-sample.mp3"],
"duration": "5s",
"aspect_ratio": "9:16",
"resolution": "1080p"
}'
```
### تدفق Edit
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Strictly edit , changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/sunny-scene.mp4"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Seedance 2.5 edit — المدة ونسبة العرض المتطابقتان مع المصدر
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"prompt": "Strictly edit , changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/sunny-scene.mp4"],
"duration": "auto",
"aspect_ratio": "adaptive",
"resolution": "720p"
}'
```
`duration: "auto"` (أو `"-1"`) و `aspect_ratio: "adaptive"` (أو `"auto"`) تجعل الإخراج يتبع المقطع المصدر. راجع [نسبة العرض إلى الارتفاع والمدة المتطابقة مع المصدر](#source-matched-aspect-ratio-and-duration).
### تدفق Edit مع تثبيت الصورة
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Replace the perfume featured in with the face cream from , with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/perfume-ad.mp4"],
"reference_image_urls": ["https://example.com/face-cream.png"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Extend للأمام
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Extend , generate a dramatic chase scene through narrow alleys at dusk, with neon signs flickering and rain on the pavement.",
"reference_video_urls": ["https://example.com/alley-intro.mp4"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Stitch (3 مقاطع)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": " + a wisp of smoke transforms into a flock of birds + followed by + a slow dolly-in + followed by ",
"reference_video_urls": [
"https://example.com/clip-1.mp4",
"https://example.com/clip-2.mp4",
"https://example.com/clip-3.mp4"
],
"reference_video_total_duration": 12,
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
```
### الاستعلام حتى الاكتمال
بعد كل إرسال إلى قائمة الانتظار، احفظ `queue_id` المُعاد واستعلم `/video/retrieve` حتى يصبح جسم الاستجابة `video/mp4`:
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/retrieve \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"queue_id": "123e4567-e89b-12d3-a456-426614174000"
}' \
-o output.mp4
```
الاستجابة عبارة عن JSON (`{ "status": "queued" | "running" | "failed", ... }`) حتى تكتمل المهمة، عندها يتحول جسم الاستجابة إلى بايتات `video/mp4`. راجع [توليد الفيديو](/guides/media/video-generation) لنمط الاستعلام الكامل.
***
## استكشاف الأخطاء وإصلاحها
### `At least one reference is required for this model`
يجب أن تتضمن طلبات المرجع إلى الفيديو واحدًا على الأقل من `reference_image_urls` أو `reference_video_urls` أو `image_references` أو `video_references`. التوليد النصي البحت ليس تدفق R2V صالحًا — استخدم معرف نموذج نص إلى فيديو بدلًا من ذلك. `reference_audio_urls` وحده ليس كافيًا (راجع قسم الصوت أعلاه).
### الكثير جدًا من الفيديوهات / الصور المرجعية
تحدّ Seedance **2.0** R2V بـ**9 صور** و**3 فيديوهات**. ترفع Seedance **2.5** تلك الحدود إلى **30 صورة** و**10 فيديوهات**. إذا تجاوزت حد العائلة، قلّص المدخلات أو ادمج أولًا خارج الاتصال.
### أخطاء المدة / المدة المُجمّعة
* **2.0:** فيديو / صوت مرجعي لكل مقطع `[2, 15]` ثانية؛ فيديو / صوت مُجمّع ≤ 15 ثانية؛ إخراج 4–15 ثانية.
* **2.5:** فيديو / صوت مرجعي لكل مقطع `[2, 30]` ثانية؛ فيديو / صوت مُجمّع ≤ 30 ثانية؛ إخراج 4–30 ثانية.
* **المدة المتطابقة مع المصدر** (`-1` / `auto` في Seedance 2.5): يجب أن يكون المقطع المصدر بين 4 و 30 ثانية، ويُطلب `reference_video_urls` (queue) أو `reference_video_total_duration` (quote).
قلّص المقاطع من جانب العميل قبل الإرسال.
### الـ prompt يوجّه إلى التدفق الخطأ
يُستنتَج التدفق من بناء الـ prompt. حالات التوجيه الخاطئ الشائعة:
* تريد **Extend** لكنك تكتب `Refer to ...` → يعامل النموذج فيديوك كـ*مصدر*، وليس كخلفية للاستمرار
* تريد **Stitch** لكنك تكتب `Refer to ...` → يختار النموذج واحدًا كمصدر، ويتجاهل الآخرين
* تريد **Edit** لكنك تكتب `Generate a video based on ` → غامض؛ قد يعود النموذج افتراضيًا إلى Reference
استخدم البادئات القياسية كما هي مكتوبة تمامًا: `Strictly edit , ...`، `Extend , ...`، ` + ... + followed by `.
### الوسائط التي تحتوي على أشخاص غير مدعومة
لا تُشغّل نماذج Seedance API العامة تدفق إثبات موافقة. قد تفشل الوسائط التي تحتوي على أشخاص يمكن اكتشافهم بخطأ سياسة محتوى أو خطأ من المزوّد. استخدم تطبيق Venice أو Studio بدلًا من ذلك.
### عرض السعر لا يطابق المبلغ المُدرَج في قائمة الانتظار
إذا أدرجت فيديو مرجعيًا ولكنك لم تمرّر `reference_video_total_duration` إلى `/video/quote`، فقد يختلف عرض السعر عن المبلغ المُدرَج في قائمة الانتظار. مرّر دائمًا `reference_video_total_duration` (مجموع مدد جميع المقاطع المرجعية بالثواني) عندما تكون الفيديوهات المرجعية موجودة.
***
## المراجع
* نقطة نهاية قائمة انتظار الفيديو في Venice: [`POST /api/v1/video/queue`](/api-reference/endpoint/video/queue)
* نقطة نهاية عرض السعر في Venice: [`POST /api/v1/video/quote`](/api-reference/endpoint/video/quote)
* دليل مرافق: [المرجع إلى الفيديو](/guides/media/reference-to-video) (يغطي Kling O3 + Grok Imagine R2V)
* دليل مرافق: [توليد الفيديو](/guides/media/video-generation) (نظرة عامة على قائمة الانتظار / الاستعلام)