تعليمات تكامل واجهة برمجة تطبيقات إنشاء فيديوهات SeeDance

ستقدم هذه المقالة تعليمات لتكامل واجهة برمجة تطبيقات إنشاء فيديوهات SeeDance، والتي يمكنها إنشاء مقاطع الفيديو الرسمية لـ SeeDance من خلال إدخال معلمات مخصصة.

عملية التقديم

لاستخدام واجهة برمجة تطبيقات إنشاء فيديوهات SeeDance، انتقل أولًا إلى وحدة تحكم Ace Data Cloud للحصول على API Token الخاص بك، واحتفظ به للاستخدام لاحقًا.

إذا لم تكن قد سجلت الدخول أو أنشأت حسابًا بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد الإكمال ستعود تلقائيًا إلى الصفحة الحالية. يمكن لـ API Token واحد استدعاء جميع خدمات المنصة، ولا حاجة للتقديم بشكل منفصل لكل خدمة. ستحصل على رصيد مجاني عند أول تقديم، ويمكنك التجربة مجانًا؛ وعند عدم كفاية الرصيد، يمكنك شحن الرصيد العام من وحدة التحكم.

📘 الوثائق الكاملة: SeeDance Videos Generation API →

الاستخدام الأساسي

لنلقِ أولًا نظرة على طريقة الاستخدام الأساسية، وهي إدخال نص التلميح content.text، والنوع content.type=text، والنموذج model، ثم يمكنك الحصول على النتيجة بعد المعالجة، والمحتوى المحدد كما يلي:

يمكن ملاحظة أننا قمنا هنا بإعداد Request Headers، بما في ذلك:

accept: تنسيق نتيجة الاستجابة التي ترغب في تلقيها، يتم تعبئته هنا بـ application/json، أي بتنسيق JSON.
authorization: المفتاح لاستدعاء API، ويمكن اختياره مباشرة من القائمة المنسدلة بعد التقديم.

كما قمنا بإعداد Request Body، بما في ذلك:

model: النموذج لإنشاء الفيديو.
- سلسلة Seedance 1.x: doubao-seedance-1-0-pro-250528، doubao-seedance-1-0-pro-fast-251015، doubao-seedance-1-5-pro-251215، doubao-seedance-1-0-lite-t2v-250428، doubao-seedance-1-0-lite-i2v-250428.
- سلسلة Seedance 2.0 (تدعم مرجعًا متعدد الوسائط للشخصيات والصوت والفيديو): doubao-seedance-2-0-260128 (قياسي)، doubao-seedance-2-0-fast-260128 (سريع)، doubao-seedance-2-0-mini-260615 (خفيف).
- Seedance 2.5: doubao-seedance-2-5-260628، يدعم مدة تصل إلى 30 ثانية، ومرجع الصوت فقط، ومواد أكثر، وتحرير الفيديو وتمديده.
content: مصفوفة محتوى الإدخال، يمكن أن يكون type هو text (نص التلميح)، أو image_url (صورة مرجعية)، أو audio_url (صوت مرجعي)، أو video_url (فيديو مرجعي). يمكن للصور تحديد الاستخدام عبر role: first_frame (الإطار الأول) / last_frame (الإطار الأخير) / reference_image (مرجع الشخصية / العنصر الرئيسي).
resolution: دقة الإخراج، يمكن اختيار 480p / 720p / 1080p / 4k. يدعم 2.5 دقة 480p و720p و1080p؛ ويدعم 2.0 Fast/Mini دقة 480p و720p؛ ويدعم 2.0 Standard حتى 4k.
ratio: نسبة العرض إلى الارتفاع، يمكن اختيار 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive.
duration: مدة الفيديو (بالثواني، عدد صحيح). سلسلة 1.0 من 2–12؛ و1.5 Pro من 4–12؛ وسلسلة 2.0 من 4–15؛ و2.5 من 4–30. يدعم 1.5/2.x القيمة -1 (مدة تلقائية).
seed: البذرة العشوائية، عدد صحيح، من -1 إلى 4294967295.
camerafixed: ما إذا كانت الكاميرا ثابتة، true / false.
watermark: ما إذا كانت ستتم إضافة علامة مائية، true / false.
generate_audio: ما إذا كان سيتم إنشاء فيديو بصوت، true / false، تدعمه سلسلة Seedance 1.5 Pro و2.x.
return_last_frame: ما إذا كان سيتم إرجاع رابط URL لصورة الإطار الأخير للفيديو في النتيجة.
omni_reference_task_type: لـ 2.5 فقط؛ auto / reference / edit / extend.
output_format: لـ 2.5 فقط؛ mp4 / mov، والافتراضي هو mp4.
tools: لـ 2.5 فقط؛ يدعم حاليًا أداة البحث عبر الإنترنت web_search، ويمكن تقييد عدد النتائج وعدد الكلمات المفتاحية ومصادر البحث.
priority: أولوية المهمة الاختيارية لـ 2.5، عدد صحيح من 0–9، والافتراضي هو 0.
safety_identifier: معرّف مستخدم نهائي مستقر ومجهول الهوية بطول لا يتجاوز 64 حرفًا؛ يرجى استخدام تجزئة أو معرّف مجهول داخلي، ولا تمرر الاسم أو البريد الإلكتروني أو رقم الهاتف.
execution_expires_after: مهلة المهمة (بالثواني)، النطاق 3600–259200.
callback_url: عنوان الاستدعاء غير المتزامن، بعد الإعداد يعيد API task_id فورًا، وعند اكتمال المهمة سيتم إرسال النتيجة عبر POST إلى هذا العنوان.
async: اختياري، عند تعيينه إلى true تعيد الواجهة task_id فورًا، دون الحاجة إلى توفير callback_url، ثم يتم الحصول على النتيجة عبر الاستعلام الدوري باستخدام واجهة الاستعلام عن المهمة المقابلة.

بعد الاختيار، يمكن ملاحظة أنه تم أيضًا إنشاء الكود المقابل على الجانب الأيمن، كما هو موضح في الصورة:

انقر فوق زر «Try» لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتيجة التالية:

{
  "success": true,
  "task_id": "9777f36b-4f44-47ff-962d-45cd2f7aeaa8",
  "trace_id": "ce5da2ca-6695-4459-9d2c-2ef9f86db752",
  "data": {
    "task_id": "7e4e1773-510a-4a73-9ab4-98dd1a0b2a7f",
    "status": "succeeded",
    "model": "doubao-seedance-2-0-fast-260128",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "video_url": "https://cdn.acedata.cloud/assets/examples/seedance/036f24ed-a9b1-49b3-92c4-30049a3bc152-102bf9f98e35.mp4"
  }
}

تتضمن النتيجة المعادة عدة حقول، ويُعرّف عنها كما يلي:

success، حالة مهمة إنشاء الفيديو في هذا الوقت.
task_id، معرّف مهمة إنشاء الفيديو في هذا الوقت.
trace_id، معرّف تتبع إنشاء الفيديو في هذا الوقت.
data، قائمة نتائج مهمة إنشاء الفيديو في هذا الوقت.
- task_id، معرّف جهة الخادم لمهمة إنشاء الفيديو في هذا الوقت.
- video_url، رابط الفيديو لمهمة إنشاء الفيديو في هذا الوقت.
- status، حالة مهمة إنشاء الفيديو في هذا الوقت.
  - model، النموذج المستخدم لإنشاء الفيديو.

يمكن ملاحظة أننا حصلنا على معلومات فيديو مُرضية، وما علينا سوى الحصول على فيديو SeeDance المُنشأ وفقًا لعنوان رابط الفيديو في data ضمن النتيجة. بالإضافة إلى ذلك، إذا كنت ترغب في إنشاء كود التكامل المقابل، فيمكنك نسخه مباشرةً، على سبيل المثال كود CURL كما يلي:

curl -X POST 'https://api.acedata.cloud/seedance/videos' \
-H 'authorization: Bearer ${bearer_token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "content": [{"type":"text","text":"A white ceramic coffee mug on a glossy marble countertop with soft morning window light. The camera slowly orbits 360 degrees around the mug, steam gently rising."}],
  "model": "doubao-seedance-2-0-fast-260128",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}'

وصف المعلمات المضمنة

في نهاية مطالبة content[].text، يمكن تمرير معلمات التوليد عبر إضافتها بصيغة --parameter value (الطريقة القديمة، تحقق ضعيف، وعند وجود خطأ في التعبئة تُستخدم القيمة الافتراضية تلقائيًا). قائمة المعلمات الكاملة كما يلي:

المعلمة المضمنة	الحقل المقابل	الوصف	نطاق القيم
`--rs`	`resolution`	دقة الإخراج	`480p` / `720p` / `1080p`
`--rt`	`ratio`	نسبة العرض إلى الارتفاع	`16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`
`--dur`	`duration`	مدة الفيديو (بالثواني)	2–12
`--frames`	`frames`	عدد إطارات الفيديو	أعداد صحيحة ضمن [29, 289] تحقق 25+4n (مدعوم فقط في سلسلة 1.0)
`--fps`	`framespersecond`	معدل الإطارات	يدعم `24` فقط
`--seed`	`seed`	البذرة العشوائية	من -1 إلى 4294967295
`--cf`	`camerafixed`	ما إذا كانت الكاميرا ثابتة	`true` / `false`
`--wm`	`watermark`	ما إذا كانت ستتم إضافة علامة مائية	`true` / `false`

الممارسة الموصى بها: استخدم الحقول العليا المقابلة مباشرةً في Request Body (مثل resolution وratio وغيرها)، فهذا وضع تحقق صارم، وعند وجود خطأ في تعبئة المعلمات سيُرجع تنبيه خطأ واضحًا، مما يسهل استكشاف المشكلات وإصلاحها.

إنشاء فيديو مع صوت

تدعم Seedance 1.5 Pro وسلسلة 2.x إنشاء فيديوهات صوتية عبر المعلمة generate_audio:

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A girl holds a fox, the wind blows her hair, you can hear the sound of the wind"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 5
}

لا تدعم سلسلة 1.0 هذه المعلمة.

التوليد والتحرير والتمديد متعدد الوسائط الكامل في Seedance 2.5

يدعم doubao-seedance-2-5-260628 دقة 480p / 720p / 1080p، ومدة 4–30 ثانية أو مدة تلقائية، ويرفع حد المواد إلى 30 صورة مرجعية، و10 مقاطع فيديو مرجعية، و10 مقاطع صوتية مرجعية (بإجمالي يصل إلى 50 عنصرًا). كما يدعم الإصدار 2.5 تمرير صوت مرجعي فقط، ولم يعد يتطلب توفير صور أو فيديوهات في الوقت نفسه. يمكن للتوليد العادي متعدد الوسائط الكامل حذف omni_reference_task_type، أو تعيينه إلى auto، أو تعيينه صراحةً إلى reference. يجب أن يمرر تحرير الفيديو وتمديده reference_video:

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {"type": "text", "text": "Replace the sky with a warm sunset while preserving the subject and camera motion."},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://cdn.acedata.cloud/input.mp4"}}
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": -1,
  "omni_reference_task_type": "edit",
  "output_format": "mov"
}

reference: مرر على الأقل عنصرًا واحدًا من reference_image أو reference_video أو reference_audio؛ يدعم الإصدار 2.5 تمرير الصوت المرجعي فقط.
edit: يجب استخدام ratio: adaptive وduration: -1؛ تُحتسب رسوم مدة الإخراج وفقًا للنتيجة الفعلية.
extend: يجب استخدام ratio: adaptive؛ يمكن أن تكون duration من 4–30 أو -1.
auto: يختار النموذج تلقائيًا التوليد أو التحرير أو التمديد وفقًا للمطالبة والمواد.
عند عدم تطابق نوع المهمة مع المواد أو المطالبة، ستفشل المهمة وتُرجع خطأ معلمة يمكن تحديد موضعه؛ يرجى التعديل وفقًا للقيود المذكورة أعلاه ثم إعادة الإرسال.

الإطار الأول لفيديو من صورة

إذا أردت مهمة فيديو من صورة، فيجب أولًا أن تحتوي معلمة content على عنصر يكون type فيه هو image_url، ويجب أن يكون الحقل image_url بتنسيق كائن: {"url": "https://..."} أو بتنسيق Base64: {"url": "data:image/png;base64,..."}.

ملاحظة: لا يدعم image_url تمرير تنسيق سلسلة مباشرةً (مثل "image_url": "https://cdn.acedata.cloud/e724d7f13d.png")، ويجب استخدام تنسيق الكائن "image_url": {"url": "https://..."}، وإلا فسيُرجع خطأ 400.

الكود المقابل:

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": [
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        },
        {
            "type": "text",
            "text": "A girl holds a fox in her arms. She opens her eyes and gazes tenderly at the camera, while the fox affectionately holds her back. As the camera slowly pulls away, her hair is gently blown by the wind. --ratio adaptive  --dur 5"
        }
    ],
    "model": "doubao-seedance-1-0-pro-250528"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

انقر للتشغيل، ويمكنك ملاحظة أنك ستحصل فورًا على نتيجة، كما يلي:

{
  "success": true,
  "task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
  "trace_id": "b3b09de3-b7fa-4bb0-88b5-aad4b4a96fd4",
  "data": {
    "task_id": "cgt-20251222072003-x2259",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/6afb78b8-5ba8-424f-adcd-69423a700b50.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

يمكنك ملاحظة أن التأثير المُنشأ هو فيديو من صورة، والنتيجة مشابهة لما ورد أعلاه.

الإطار الأول والأخير لفيديو من صورة

إذا أردت الإطار الأول والأخير لفيديو من صورة، فيجب أولًا أن تمرر المعلمة content النوع image_url، وأن تعيّن role إلى first_frame وlast_frame على التوالي، وبذلك يمكنك تحديد المحتوى التالي:

role: تحديد الإطار الأول أو الإطار الأخير.
image_url
- رابط صورة url وفي الوقت نفسه، تحتاج content أيضًا إلى إدخال النوع text كمطالبة prompt

الكود المقابل:

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
   "model": "doubao-seedance-1-0-pro-250528",
    "content": [
         {
            "type": "text",
            "text": "360-degree shot"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
            },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
            },
            "role": "last_frame"
        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

انقر على تشغيل، ويمكنك ملاحظة أنك ستحصل فورًا على نتيجة، كما يلي:

{
  "success": true,
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
  "trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
  "data": {
    "task_id": "cgt-20251222073134-54qcw",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

يمكن ملاحظة أن التأثير المُولَّد هو فيديو لشخصية، والنتيجة مشابهة لما سبق.

الشخصية والمرجع متعدد الوسائط للصوت والفيديو (Seedance 2.0)

تدعم سلسلة Seedance 2.0 (doubao-seedance-2-0-260128 وdoubao-seedance-2-0-fast-260128 وdoubao-seedance-2-0-mini-260615) reference_image وreference_audio وreference_video. يمكن استخدام مواد مملوكة ذاتيًا أو مصرح بها للحفاظ على اتساق الشخصية والموضوع والحركة وحركة الكاميرا والصوت والإيقاع.

يرجى رفع مواد الأشخاص الحقيقيين والشخصيات التي تملكها أو حصلت على تصريح لاستخدامها فقط. تختلف طريقة دعم مواد الأشخاص الحقيقيين بين النماذج المختلفة؛ يظل تنسيق الطلب دون تغيير، وسيتم إرجاع خطأ واضح إذا كانت المواد لا تستوفي المتطلبات.

نقاط الاستخدام:

تدعم نماذج سلسلة Seedance 2.0 فقط reference_image؛ بالنسبة إلى نماذج 1.x، يرجى استخدام first_frame / last_frame (الإطارين الأول والأخير لفيديو مُولَّد من صورة).
فيديو الصورة إلى الفيديو بالإطار الأول، وفيديو الصورة إلى الفيديو بالإطارين الأول والأخير، والمرجع متعدد الوسائط هي ثلاث حالات متنافية: لا يمكن استخدام first_frame / last_frame مع reference_image / reference_video / reference_audio معًا.
إذا أردت تحديد الإطارين الأول والأخير في المرجع متعدد الوسائط، فضع علامة reference_image على الصور، واكتب في الموجّه «الصورة 1 كإطار أول» أو «الصورة 2 كإطار أخير»؛ وإذا احتجت إلى تثبيت الإطارين الأول والأخير بشكل صارم، فاستخدم فقط first_frame / last_frame.
الحد الأقصى لعدد المراجع متعددة الوسائط: بحد أقصى 9 صور image_url؛ كما يدعم 2.0 audio_url (role هو reference_audio، بحد أقصى 3 مقاطع) وvideo_url (role هو reference_video، بحد أقصى 3 مقاطع).
متطلبات مواد الصوت المرجعي (audio_url): التنسيق wav / mp3؛ مدة المقطع الواحد من 2 إلى 15 ثانية، بحد أقصى 3 مقاطع وبمدة إجمالية لا تتجاوز 15 ثانية؛ وألا يتجاوز المقطع الواحد 15 ميغابايت. سيؤدي تجاوز نطاق المدة إلى الفشل في مرحلة معالجة المواد.
متطلبات مواد الفيديو المرجعي (video_url): التنسيق mp4 / mov؛ مدة المقطع الواحد من 2 إلى 15 ثانية، بحد أقصى 3 مقاطع وبمدة إجمالية لا تتجاوز 15 ثانية.
يُوصى بأن تكون الصور المرجعية لشخص واحد، بوجه أمامي، واضحة، ودون حجب؛ فكلما كان الوجه أوضح، زادت درجة التشابه.

المثال الأول: لقطة مقرّبة تحافظ على ملامح الشخص

مرّر صورة وجه واحدة، واجعل هذا الشخص يبتسم ويلوح بيده نحو الكاميرا. الكود المقابل:

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "The woman looks at the camera, gives a warm natural smile and waves her hand, soft studio lighting, gentle camera push-in."
        },
        {
            "type": "image_url",
            "role": "reference_image",
            "image_url": {
                "url": "https://cdn.acedata.cloud/assets/examples/nanobanana/8e075897-0f50-4443-8500-666751791c6c-4346f66287c0.jpg"
            }
        }
    ],
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

تكون النتيجة المُعادة كما يلي، ويحافظ الشخص في الفيديو المُولَّد على اتساقه مع الصورة المرجعية:

{
  "success": true,
  "task_id": "895eb5ea-bbe1-41a3-a9e9-48608e03f93a",
  "trace_id": "83544791-7a84-44de-b8d2-afe171a1c0e4",
  "data": {
    "task_id": "458abf29-cc39-4fd0-bcea-24f89a70d8de",
    "status": "succeeded",
    "video_url": "https://cdn.acedata.cloud/assets/examples/seedance/e71d3cc5-27e7-4719-be34-1f0e254eccaf-a56b2736a4e0.mp4",
    "model": "doubao-seedance-2-0-fast-260128",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5
  }
}

المثال الثاني: وضع الشخص نفسه في مشهد جديد كليًا

تكمن قوة reference_image في أنها تحتفظ فقط بهوية الشخص، بينما يحدد الموجّه المشهد والملابس والحركة بالكامل. فيما يلي، باستخدام صورة الوجه نفسها، نجعل هذا الشخص يرتدي معطفًا بيجًا ويمشي في حديقة خريفية:

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "The same woman wearing a beige coat walks through a sunny autumn park, golden leaves falling around her, she smiles softly at the camera, cinematic tracking shot."
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.acedata.cloud/assets/examples/nanobanana/8e075897-0f50-4443-8500-666751791c6c-4346f66287c0.jpg"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 5
}

تكون النتيجة المُعادة كما يلي، حيث تم الاحتفاظ بملامح الشخص، بينما تغيّر المشهد إلى حديقة خريفية:

{
  "success": true,
  "task_id": "00872de7-16b7-431f-b4f7-6bf38ae86157",
  "trace_id": "577a07c3-4f5f-4cc7-86fe-535bb8332614",
  "data": {
    "task_id": "32fe1537-ba3e-452a-8749-3ef8890d37fd",
    "status": "succeeded",
    "video_url": "https://cdn.acedata.cloud/assets/examples/seedance/44f47593-556b-4fda-afa5-7a71eefcd228-2161efa5dd09.mp4",
    "model": "doubao-seedance-2-0-fast-260128",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5
  }
}

💡 إذا كنت ترغب في أن تعيد الشخصية إنتاج التكوين في الصورة بدقة (بدلاً من «الشخص نفسه في مشهد مختلف»)، يمكنك استخدام first_frame (الإطار الأول لفيديو مُولَّد من صورة)، لجعل الفيديو يبدأ بالحركة من هذه الصورة.

الاستدعاء غير المتزامن

نظرًا لأن وقت إنشاء SeeDance Videos Generation API طويل نسبيًا (حوالي 1-2 دقيقة)، يمكن استخدام الوضع غير المتزامن عبر الحقل callback_url لتجنب انشغال اتصال HTTP لفترة طويلة. التدفق العام: يحدد العميل callback_url عند بدء الطلب، وتُرجع API فورًا استجابة تتضمن task_id؛ بعد اكتمال المهمة، ترسل المنصة نتيجة الإنشاء إلى callback_url بصيغة POST JSON، وتتضمن النتيجة أيضًا task_id لتسهيل الربط.

{
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd"
}

عند اكتمال المهمة، يكون المحتوى الذي تدفعه المنصة إلى callback_url كما يلي:

{
  "success": true,
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
  "trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
  "data": {
    "task_id": "cgt-20251222073134-54qcw",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

يتطابق حقل task_id في النتيجة مع الحقل المُعاد عند الطلب، ويمكن تحقيق ربط المهمة من خلال هذا الحقل.

معالجة الأخطاء

عند استدعاء API، إذا واجهت خطأً، فستُرجع API رمز الخطأ والمعلومات المقابلة. على سبيل المثال:

400 token_mismatched：طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صالحة.
400 api_not_implemented：طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صالحة.
401 invalid_token：غير مصرح به، رمز التفويض غير صالح أو مفقود.
429 too_many_requests：طلبات كثيرة جدًا، لقد تجاوزت حد المعدل.
500 api_error：خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

الخلاصة

من خلال هذا المستند، أصبحت تعرف كيفية استخدام Seedance Videos Generation API لإنشاء الفيديو من النص، وإنشاء الفيديو باستخدام الإطارين الأول والأخير والمراجع متعددة الوسائط، وكذلك استخدام Seedance 2.5 لتحرير الفيديو أو تمديده. نأمل أن يساعدك هذا المستند في إكمال تكامل API؛ إذا كانت لديك أي أسئلة، فيرجى الاتصال بالدعم الفني.

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

Coding

المزيد من الأدلة

تعليمات تكامل واجهة برمجة تطبيقات إنشاء فيديوهات SeeDance

عملية التقديم

الاستخدام الأساسي

وصف المعلمات المضمنة

إنشاء فيديو مع صوت

التوليد والتحرير والتمديد متعدد الوسائط الكامل في Seedance 2.5

الإطار الأول لفيديو من صورة

الإطار الأول والأخير لفيديو من صورة

الشخصية والمرجع متعدد الوسائط للصوت والفيديو (Seedance 2.0)

المثال الأول: لقطة مقرّبة تحافظ على ملامح الشخص

المثال الثاني: وضع الشخص نفسه في مشهد جديد كليًا

الاستدعاء غير المتزامن

معالجة الأخطاء

مثال على استجابة الخطأ

الخلاصة

​عملية التقديم

​الاستخدام الأساسي

​وصف المعلمات المضمنة

​إنشاء فيديو مع صوت

​التوليد والتحرير والتمديد متعدد الوسائط الكامل في Seedance 2.5

​الإطار الأول لفيديو من صورة

​الإطار الأول والأخير لفيديو من صورة

​الشخصية والمرجع متعدد الوسائط للصوت والفيديو (Seedance 2.0)

​المثال الأول: لقطة مقرّبة تحافظ على ملامح الشخص

​المثال الثاني: وضع الشخص نفسه في مشهد جديد كليًا

​الاستدعاء غير المتزامن

​معالجة الأخطاء

​مثال على استجابة الخطأ

​الخلاصة

عملية التقديم

الاستخدام الأساسي

وصف المعلمات المضمنة

إنشاء فيديو مع صوت

التوليد والتحرير والتمديد متعدد الوسائط الكامل في Seedance 2.5

الإطار الأول لفيديو من صورة

الإطار الأول والأخير لفيديو من صورة

الشخصية والمرجع متعدد الوسائط للصوت والفيديو (Seedance 2.0)

المثال الأول: لقطة مقرّبة تحافظ على ملامح الشخص

المثال الثاني: وضع الشخص نفسه في مشهد جديد كليًا

الاستدعاء غير المتزامن

معالجة الأخطاء

مثال على استجابة الخطأ

الخلاصة