# Seedance 2.0 API مرجع API الكامل لنماذج إنشاء الفيديو Seedance 2.0 من ByteDance. ## إصدارات النماذج تدعم هذه الواجهة ستة إصدارات: | النموذج | ID | الوصف | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | إنشاء فيديو عالي الجودة من النص | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | تحريك الصور مع التحكم في الحركة | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | إنشاء فيديو بتوجيه من فيديو مرجعي | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | إنشاء أسرع للفيديو من النص | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | إنشاء أسرع للفيديو من الصور | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | إنشاء أسرع للفيديو بالاعتماد على المراجع | ## مقارنة سريعة | الميزة | النماذج القياسية | نماذج Fast | |---------|-----------------|-------------| | الجودة | جودة أعلى | محسّنة للسرعة | | وقت المعالجة | 3-8 دقائق | 1-4 دقائق | | نطاق المدة | 4-15 ثانية | 4-15 ثانية | | خيارات الدقة | 480p, 720p, 1080p, 4k | 480p, 720p | | الوسائط المرجعية | صور وفيديو وصوت لنموذج Reference-to-Video | صور وفيديو وصوت لنموذج Fast Reference-to-Video | ### نسب الأبعاد المدعومة `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### خيارات الدقة | الدقة | الوصف | |------------|-------------| | `480p` | دقة قياسية ومعالجة أسرع | | `720p` | دقة عالية وتوازن بين الجودة والسرعة | | `1080p` | Full HD، متاحة لجميع نماذج Seedance 2.0 القياسية | | `4k` | Ultra HD، متاحة لجميع نماذج Seedance 2.0 القياسية | ## Seedance 2.0 من النص إلى الفيديو ### نقطة النهاية ``` POST /api/v1/video/task ``` ### معلمات الطلب #### إلزامية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون `"seedance-v2.0-text-to-video"` | | `prompt` | string | وصف إنشاء الفيديو | | `duration` | integer | مدة الفيديو بالثواني الصحيحة (4-15)، بخطوة مقدارها 1 | | `resolution` | string | دقة الإخراج: `"480p"` أو `"720p"` أو `"1080p"` أو `"4k"` | | `aspect_ratio` | string | نسبة أبعاد الفيديو: `"21:9"` أو `"16:9"` أو `"9:16"` أو `"1:1"` أو `"4:3"` أو `"3:4"` | #### اختيارية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `sound` | boolean | تحديد ما إذا كان سيتم إنشاء الصوت. القيمة الافتراضية `true`؛ لا يؤثر في السعر | ### مثال على الطلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.0-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 من الصورة إلى الفيديو ### معلمات الطلب #### إلزامية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون `"seedance-v2.0-image-to-video"` | | `prompt` | string | وصف إنشاء الفيديو | | `duration` | integer | مدة الفيديو بالثواني الصحيحة (4-15)، بخطوة مقدارها 1 | | `resolution` | string | دقة الإخراج: `"480p"` أو `"720p"` أو `"1080p"` أو `"4k"` | | `aspect_ratio` | string | نسبة أبعاد الفيديو: `"21:9"` أو `"16:9"` أو `"9:16"` أو `"1:1"` أو `"4:3"` أو `"3:4"` | | `image_url` | string | الإطار الأول من الفيديو | #### اختيارية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `image_end_url` | string | رابط اختياري لصورة الإطار الأخير | | `sound` | boolean | تحديد ما إذا كان سيتم إنشاء الصوت. القيمة الافتراضية `true`؛ لا يؤثر في السعر | ### مثال على الطلب ```javascript { model_name: 'seedance-v2.0-image-to-video', image_url: 'https://example.com/image.jpg', image_end_url: 'https://example.com/end-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', duration: 6, resolution: '720p', aspect_ratio: '16:9' } ``` ## Seedance 2.0 من المراجع إلى الفيديو ### معلمات الطلب #### إلزامية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون `"seedance-v2.0-reference-to-video"` | | `prompt` | string | وصف إنشاء الفيديو. اكتب وصفًا عاديًا دون عناصر نائبة، أو استخدم ميزة الإشارة @ (AT) مع `<<>>` و`<<>>` و`<<>>` للإشارة صراحةً إلى عناصر مصفوفات الوسائط المقابلة | | `duration` | integer | مدة الفيديو بالثواني الصحيحة (4-15)، بخطوة مقدارها 1 | | `resolution` | string | دقة الإخراج: `"480p"` أو `"720p"` أو `"1080p"` أو `"4k"` | | `aspect_ratio` | string | نسبة أبعاد الفيديو: `"21:9"` أو `"16:9"` أو `"9:16"` أو `"1:1"` أو `"4:3"` أو `"3:4"` | #### الوسائط المرجعية أرسل 1-9 صور. يمكن إغفال الصور فقط عند توفير فيديو مرجعي واحد على الأقل. | المعلمة | النوع | الوصف | |-----------|------|-------------| | `images` | string[] | 1-9 روابط لصور مرجعية، أو مصفوفة فارغة عندما تكون `videos` غير فارغة | | `videos` | string[] | حتى 3 روابط لفيديوهات مرجعية؛ يجب أن تكون مدة كل فيديو 2-15 ثانية، بمدة إجمالية لا تتجاوز 15 ثانية | | `audios` | string[] | حتى 3 روابط لمقاطع صوتية مرجعية؛ مدة كل مقطع 2-15 ثانية، بمدة إجمالية لا تتجاوز 15 ثانية؛ WAV أو MP3، وبحد أقصى 15 MB لكل مقطع؛ يتطلب صورة أو فيديو واحدًا على الأقل | #### العناصر النائبة للإشارة @ (AT) تربط ميزة @ (AT) الوسائط المرجعية بالوصف عبر عناصر نائبة مرقمة `<<<...>>>`. يبدأ الترقيم من `1` بصورة مستقلة لكل نوع من الوسائط، ويتبع ترتيب المصفوفة المقابلة: | العنصر النائب | القيمة المشار إليها | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | على سبيل المثال، إذا كانت الصورة الأولى مرجعًا للشخصية والثانية مرجعًا للمشهد، فاستخدم `<<>>` للشخصية و`<<>>` للمشهد في `prompt`. يجب أن يشير كل عنصر نائب إلى عنصر موجود في مصفوفتِه المقابلة. #### اختيارية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `sound` | boolean | تحديد ما إذا كان سيتم إنشاء صوت متزامن. القيمة الافتراضية `true` | ### مثال على الطلب ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### مثال طلب من المراجع إلى الفيديو باستخدام @ (AT) ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.jpg' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## إصدارات Fast تعطي إصدارات Fast الأولوية لسرعة المعالجة. تدعم جميع نماذج Fast الإخراج بدقتي `"480p"` و`"720p"` فقط. وفيما عدا ذلك، تتبع نماذج Fast من النص إلى الفيديو ومن الصورة إلى الفيديو بنية الطلبات القياسية المقابلة، بينما يستخدم Fast من المراجع إلى الفيديو حدود الوسائط المرجعية نفسها الخاصة بالنموذج القياسي. ### مثال طلب Fast ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### مثال طلب Fast من المراجع إلى الفيديو باستخدام @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### معلمات Seedance 2.0 Fast من المراجع إلى الفيديو #### إلزامية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | وصف إنشاء الفيديو. اكتب وصفًا عاديًا دون عناصر نائبة، أو استخدم ميزة الإشارة @ (AT) مع `<<>>` و`<<>>` و`<<>>` للإشارة صراحةً إلى عناصر مصفوفات الوسائط المقابلة | | `duration` | integer | مدة الفيديو بالثواني الصحيحة (4-15)، بخطوة مقدارها 1 | | `resolution` | string | دقة الإخراج: `"480p"` أو `"720p"` | | `aspect_ratio` | string | نسبة أبعاد الفيديو: `"21:9"` أو `"16:9"` أو `"9:16"` أو `"1:1"` أو `"4:3"` أو `"3:4"` | #### الوسائط المرجعية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `images` | string[] | 1-9 روابط لصور مرجعية، أو مصفوفة فارغة عندما تكون `videos` غير فارغة | | `videos` | string[] | حتى 3 روابط لفيديوهات مرجعية؛ يجب أن تكون مدة كل فيديو 2-15 ثانية، بمدة إجمالية لا تتجاوز 15 ثانية | | `audios` | string[] | حتى 3 روابط لمقاطع صوتية مرجعية؛ مدة كل مقطع 2-15 ثانية، بمدة إجمالية لا تتجاوز 15 ثانية؛ WAV أو MP3، وبحد أقصى 15 MB لكل مقطع؛ يتطلب صورة أو فيديو واحدًا على الأقل | تنطبق قاعدة ترقيم العناصر النائبة من 1 الموضحة أعلاه أيضًا على نموذج Fast من المراجع إلى الفيديو. #### اختيارية | المعلمة | النوع | الوصف | |-----------|------|-------------| | `sound` | boolean | تحديد ما إذا كان سيتم إنشاء صوت متزامن. القيمة الافتراضية `true` | ## حدود الوسائط تنطبق هذه الحدود على صور الإطار الأول والأخير والوسائط المرجعية للنماذج الواردة في هذه الصفحة. | الوسائط | الصيغ | الحدود | |-------|---------|--------| | الصور | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | يجب أن يكون حجم كل صورة أقل من 30 MB؛ العرض والارتفاع كل منهما 300-6000 px؛ نسبة العرض إلى الارتفاع 0.4-2.5 | | الفيديو | MP4, MOV | بحد أقصى 200 MB لكل ملف؛ العرض والارتفاع كل منهما 300-6000 px؛ نسبة العرض إلى الارتفاع 0.4-2.5؛ معدل الإطارات 24-60 FPS | | الصوت | WAV, MP3 | بحد أقصى 15 MB لكل ملف | | جسم الطلب | — | بحد أقصى 64 MB | للصوت المرجعي والفيديو المرجعي حد إجمالي مستقل للمدة قدره 15 ثانية لكل نوع. الأعداد مستقلة: حتى 9 صور و3 فيديوهات و3 مقاطع صوتية. لا تؤدي إضافة الفيديوهات إلى تقليل عدد الصور المسموح به. تستخدم جميع النماذج `720p` افتراضيًا، لكن يجب تقديم `resolution` مع ذلك. القيمة الافتراضية لمفتاح الصوت هي `true`؛ ولا يغيّر هذا المفتاح ولا الصوت المرجعي السعر. يتطلب نموذج من المراجع إلى الفيديو صورة أو فيديو واحدًا على الأقل؛ ولا يدعم الطلبات التي تحتوي على الصوت فقط. تؤدي إضافة فيديوهات مرجعية إلى مضاعفة تكلفة الإنشاء بغض النظر عن عددها أو مدتها. ## تنسيق الاستجابة ### الاستجابة الأولية تعيد جميع النماذج `task_id` للاستعلام الدوري: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### استجابة الاستعلام الدوري استعلم دوريًا عن `GET /api/v1/video/{taskId}` للتحقق من الحالة: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### قيم الحالة - `submitted`: تم قبول المهمة وهي تنتظر المعالجة - `processing`: جارٍ إنشاء الفيديو - `succeed`: اكتمل إنشاء الفيديو - `failed`: فشل إنشاء الفيديو ## وقت المعالجة **النماذج القياسية**: 3-8 دقائق بحسب المدة والدقة. **نماذج Fast**: 1-4 دقائق لمعظم الإعدادات. تحقق من الحالة كل 5-10 ثوانٍ. ## أفضل الممارسات 1. **اختر الإصدار المناسب**: استخدم نماذج Fast للتجارب المتكررة والنماذج القياسية للإخراج النهائي 2. **صِف الحركة بوضوح**: أدرج أوصافًا محددة للحركة في الأوصاف النصية 3. **اختيار الدقة**: تدعم جميع نماذج Seedance 2.0 القياسية `480p` و`720p` و`1080p` و`4k`؛ وتدعم جميع نماذج Fast دقتي `480p` و`720p` فقط 4. **ترتيب المراجع**: رتّب `images` و`videos` و`audios` بشكل مقصود، وأشر إليها باتساق في الوصف 5. **طلبات الفيديو فقط**: استخدم مصفوفة `images` فارغة فقط عند توفير فيديو مرجعي واحد على الأقل 6. **مدة الوسائط**: اجعل مدة كل مقطع صوتي وفيديو مرجعي بين 2 و15 ثانية 7. **استخدام الصوت**: أغفل `sound` لاستخدام قيمته الافتراضية `true`، أو اضبطه على `false` لتعطيل الصوت المُنشأ