SeeDance Videos Generation API توصيل الشرح

ستتناول هذه المقالة شرح توصيل SeeDance Videos Generation API، والتي يمكن من خلالها إنشاء مقاطع الفيديو الرسمية من SeeDance عن طريق إدخال معلمات مخصصة.

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

لاستخدام SeeDance Videos Generation API، يجب أولاً الذهاب إلى لوحة تحكم Ace Data Cloud للحصول على رمز API الخاص بك، احتفظ به للاستخدام لاحقًا.

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

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

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

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

يمكننا أن نرى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:

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

بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:

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://platform2.cdn.acedata.cloud/seedance/036f24ed-a9b1-49b3-92c4-30049a3bc152.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":"فنجان قهوة سيراميك أبيض على سطح رخام لامع مع ضوء نافذة الصباح الناعم. الكاميرا تدور ببطء 360 درجة حول الفنجان، والبخار يرتفع برفق."}],
  "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`	عدد إطارات الفيديو	عدد صحيح يحقق 25+4n في [29, 289] (يدعم فقط سلسلة 1.0)
`--fps`	`framespersecond`	معدل الإطارات	يدعم فقط `24`
`--seed`	`seed`	البذور العشوائية	-1 إلى 4294967295
`--cf`	`camerafixed`	هل تثبيت الكاميرا	`true` / `false`
`--wm`	`watermark`	هل إضافة علامة مائية	`true` / `false`

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

توليد فيديو صوتي

يدعم Seedance 1.5 Pro وسلسلة 2.x توليد فيديوهات مع صوت من خلال معلمة generate_audio:

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "فتاة تحمل ثعلبًا، والرياح تهب على شعرها، يمكنك سماع صوت الرياح"
    }
  ],
  "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": "استبدل السماء بغروب دافئ مع الحفاظ على الموضوع وحركة الكاميرا."},
    {"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: يجب تمرير صورة مرجعية واحدة على الأقل أو فيديو مرجعي أو صوت مرجعي؛ تدعم 2.5 تمرير الصوت المرجعي فقط.
edit: يجب استخدام ratio: adaptive و duration: -1؛ يتم احتساب مدة الإخراج بناءً على النتيجة الفعلية.
extend: يجب استخدام ratio: adaptive؛ يمكن أن تكون duration من 4 إلى 30 أو -1.
auto: يختار النموذج تلقائيًا التوليد أو التحرير أو التمديد بناءً على الكلمات الدلالية والمواد.
عند عدم تطابق نوع المهمة مع المواد أو الكلمات الدلالية، ستفشل المهمة وتعيد خطأ معلمات يمكن تحديده؛ يرجى ضبطه وفقًا للقيود المذكورة أعلاه وإعادة تقديمه.

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

إذا كنت ترغب في توليد فيديو من صورة، يجب أن تحتوي معلمة content أولاً على عنصر من النوع 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": "فتاة تحمل ثعلبًا في ذراعيها. تفتح عينيها وتنظر برفق إلى الكاميرا، بينما الثعلب يحتضنها بحب. بينما تسحب الكاميرا ببطء، يتم نفخ شعرها برفق بواسطة الرياح. --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 ككلمات دلالية.

```python
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 درجة"
        },
        {
            "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؛ يرجى استخدام first_frame / last_frame (إطارات البداية والنهاية للفيديو المولد).
إطارات البداية والنهاية للفيديو المولد، وإطارات البداية والنهاية الكاملة، والمرجع متعدد الوسائط هي ثلاثة سيناريوهات متعارضة: لا يمكن استخدام first_frame / last_frame مع reference_image / reference_video / reference_audio.
إذا كنت ترغب في تحديد إطارات البداية والنهاية في المرجع متعدد الوسائط، يرجى وضع علامة على الصورة كـ reference_image، وذكر في النص “الصورة 1 كإطار بداية” أو “الصورة 2 كإطار نهاية”؛ إذا كنت بحاجة إلى قفل إطارات البداية والنهاية بدقة، استخدم فقط first_frame / last_frame.
الحد الأقصى لعدد المراجع متعددة الوسائط: image_url بحد أقصى 9 صور؛ تدعم 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": "المرأة تنظر إلى الكاميرا، تعطي ابتسامة طبيعية دافئة وتلوح بيدها، إضاءة استوديو ناعمة، دفع الكاميرا بلطف."
        },
        {
            "type": "image_url",
            "role": "reference_image",
            "image_url": {
                "url": "https://platform2.cdn.acedata.cloud/nanobanana/8e075897-0f50-4443-8500-666751791c6c.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://platform2.cdn.acedata.cloud/seedance/e71d3cc5-27e7-4719-be34-1f0e254eccaf.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": "نفس المرأة ترتدي معطف بيج تسير في حديقة خريف مشمسة، أوراق ذهبية تتساقط من حولها، تبتسم برفق إلى الكاميرا، لقطة تتبع سينمائية."
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://platform2.cdn.acedata.cloud/nanobanana/8e075897-0f50-4443-8500-666751791c6c.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://platform2.cdn.acedata.cloud/seedance/44f47593-556b-4fda-afa5-7a71eefcd228.mp4",
    "model": "doubao-seedance-2-0-fast-260128",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5
  }
}

💡 إذا كنت ترغب في جعل الشخص يعيد إنتاج التكوين الموجود في الصورة بدقة (بدلاً من “نفس الشخص في مشهد مختلف”)، يمكنك استخدام first_frame (الإطار الأول للفيديو) لبدء الفيديو من هذه الصورة.

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

نظرًا لأن واجهة برمجة تطبيقات توليد فيديوهات SeeDance تستغرق وقتًا طويلاً (حوالي 1-2 دقيقة)، يمكنك استخدام حقل callback_url في وضع غير متزامن، لتجنب احتلال اتصال HTTP لفترة طويلة. العملية الكلية: عند بدء العميل الطلب، يتم تحديد callback_url، وتقوم واجهة برمجة التطبيقات بإرجاع استجابة تحتوي على 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 في النتائج يتطابق مع ما تم إرجاعه عند الطلب، ومن خلال هذا الحقل يمكن تحقيق الربط بين المهام.

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

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

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 لإنشاء فيديوهات من النصوص، والإطارات الأولى والأخيرة، والمرجع متعدد الوسائط، بالإضافة إلى استخدام Seedance 2.5 لتحرير أو تمديد الفيديو. نأمل أن تساعدك هذه الوثيقة في إتمام تكامل واجهة برمجة التطبيقات؛ إذا كانت لديك أي أسئلة، يرجى الاتصال بالدعم الفني.

البداية

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

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

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

الصوت الذكي

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

CAPTCHA

الهوية

وكيل

متقدم

Coding

SeeDance Videos Generation API توصيل الشرح

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

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

شرح المعلمات المضمنة

توليد فيديو صوتي

توليد وتحرير وتمديد Seedance 2.5

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

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

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

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

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

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

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

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

الخاتمة

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

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

​شرح المعلمات المضمنة

​توليد فيديو صوتي

​توليد وتحرير وتمديد Seedance 2.5

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

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

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

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

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

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

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

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

​الخاتمة

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

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

شرح المعلمات المضمنة

توليد فيديو صوتي

توليد وتحرير وتمديد Seedance 2.5

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

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

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

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

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

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

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

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

الخاتمة