كيفية استخدام Seedance 2.0 API 2026

ملخص

تم إطلاق واجهة برمجة تطبيقات Seedance 2.0 في 2 أبريل 2026، عبر Volcengine Ark. يمكنك إرسال مهمة إنشاء فيديو باستخدام طلب POST، ثم استقصاء نقطة نهاية GET حتى تصل الحالة إلى "succeeded" (نجحت). تدعم واجهة برمجة التطبيقات تحويل النص إلى فيديو، والصورة إلى فيديو، والتحكم في الإطار الأول والأخير، والمراجع متعددة الوسائط، وإنشاء الصوت الأصلي. يكلف فيديو بدقة 1080p ومدته 5 ثوانٍ حوالي 0.93 دولارًا أمريكيًا. قم بتنزيل الفيديو في غضون 24 ساعة. تنتهي صلاحية الرابط بعد ذلك.

Hypereal AI

جرب Hypereal AI

مقدمة

في 2 أبريل 2026، أطلقت منصة Volcengine Ark التابعة لشركة ByteDance واجهة برمجة تطبيقات Seedance 2.0 الرسمية. قبل هذا التاريخ، كانت الطريقة الوحيدة لإنشاء مقاطع فيديو Seedance 2.0 هي عبر وحدة تحكم الويب. إذا رأيت دروسًا تعليمية توضح طريقة استخدام واجهة المستخدم، فقد تمت كتابتها لوحدة التحكم. يغطي هذا الدليل واجهة برمجة التطبيقات الحقيقية التي يمكن للمطورين استدعائها برمجيًا.

💡

تتبع واجهة برمجة التطبيقات نمط المهام غير المتزامنة: طلب POST لإنشاء مهمة، استلام معرّف المهمة، ثم استقصاء نقطة نهاية GET حتى تنتهي المهمة. هذا النمط يستحق الاختبار الشامل قبل النشر. تتيح لك سيناريوهات اختبار Apidog ربط إرسال POST، استخراج معرّف المهمة، تكرار استقصاء GET، والتأكد من أن الاستجابة النهائية تحتوي على عنوان URL صالح للفيديو. قم بتنزيل Apidog مجانًا لاتباع خطوات الاختبار في قسم Apidog أدناه.

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

ما هو Seedance 2.0؟

Seedance 2.0 هو نموذج لإنشاء الفيديو من ByteDance. يعمل على Volcengine Ark تحت معرّفات النموذج doubao-seedance-2-0-260128 (قياسي) و doubao-seedance-2-0-fast-260128 (أسرع، جودة أقل).

يدعم النموذج أنواع إدخال أكثر مما دعمته النسخة 1.5. تعاملت النسخة 1.5 مع تحويل النص إلى فيديو والصورة إلى فيديو. أضافت النسخة 2.0 ما يلي:

التحكم في الإطار الأول والأخير (توفر كلتا الصورتين المحدِّدتين)
مدخلات مرجعية متعددة الوسائط: صور ومقاطع فيديو وملفات صوتية مجمعة في طلب واحد
توليد الصوت الأصلي، بما في ذلك الحوارات والمؤثرات الصوتية والأصوات المحيطة والموسيقى
مزامنة الشفاه بأكثر من 8 لغات
التحكم في حركة الكاميرا عبر مطالبات اللغة الطبيعية (لقطات دولي، تتبع، كرين)
إخراج فيديو يصل طوله إلى 15 ثانية بدقة تصل إلى 2K

يُخرج النموذج فيديو بمعدل 24 إطارًا في الثانية بنسب عرض إلى ارتفاع تتراوح من 1:1 إلى 21:9. تختار الدقة وقت الطلب.

ما الذي تغير: الدليل مقابل واجهة برمجة التطبيقات الرسمية

وصفت المقالات السابقة حول Seedance 2.0، بما في ذلك دليل فبراير 2026 على هذا الموقع، وحدة تحكم الويب Seedance 2.0 على Volcengine. لم تكن هناك واجهة برمجة تطبيقات موجودة في تلك المرحلة. أوضحت تلك الأدلة كيفية ملء حقل مطالبة على صفحة ويب والنقر على زر الإنشاء.

يغير إصدار واجهة برمجة التطبيقات في 2 أبريل 2026 ذلك تمامًا. يمكنك الآن استدعاء واجهة برمجة التطبيقات من أي لغة، وأتمتة مسارات إنشاء الفيديو، ودمج Seedance في منتجك الخاص. يحل هذا الدليل محل دليل واجهة المستخدم لأي حالة استخدام للمطورين.

المتطلبات الأساسية

تحتاج إلى حساب Volcengine للبدء. أنشئ حسابًا على volcengine.com. بمجرد تنشيط حسابك، انتقل إلى لوحة تحكم Ark على العنوان التالي:

https://console.volcengine.com/ark/region:ark+cn-beijing/apikey

أنشئ مفتاح API هناك. ثم قم بتصديره كمتغير بيئة:

export ARK_API_KEY="your-api-key-here"

يستخدم كل طلب إلى واجهة برمجة التطبيقات هذا المفتاح في عنوان رمز Bearer:

Authorization: Bearer YOUR_ARK_API_KEY

تتلقى الحسابات الجديدة أرصدة تجريبية مجانية. تغطي هذه الأرصدة ما يقرب من 8 عمليات إنشاء فيديو كاملة مدتها 15 ثانية بدقة 1080p قبل أن تدفع أي شيء.

النص إلى فيديو: طلبك الأول

عنوان URL الأساسي لجميع استدعاءات واجهة برمجة تطبيقات Seedance هو:

https://ark.cn-beijing.volces.com/api/v3

لإرسال مهمة تحويل النص إلى فيديو، أرسل طلب POST إلى /v1/contents/generations/tasks.

مثال cURL

curl -X POST "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
      }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

تُرجع واجهة برمجة التطبيقات معرّف مهمة على الفور:

{"id": "cgt-2025xxxxxxxx-xxxx"}

مثال بايثون (SDK الرسمي)

قم بتثبيت SDK أولاً:

pip install volcenginesdkarkruntime

ثم أرسل مهمة:

import os
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

print(resp.id)

احتفظ بمعرّف المهمة. ستحتاجه لخطوة الاستقصاء.

نمط المهام غير المتزامنة: إرسال، استقصاء، تنزيل

إنشاء Seedance ليس فوريًا. يستغرق فيديو بدقة 1080p ومدته 5 ثوانٍ عادةً من 60 إلى 120 ثانية. تتعامل واجهة برمجة التطبيقات مع هذا باستخدام دورة حياة مهام غير متزامنة:

queued (في قائمة الانتظار) -> running (قيد التشغيل) -> succeeded (نجحت)
                  -> failed (فشلت)
                  -> expired (انتهت صلاحيتها)
                  -> cancelled (ألغيت)

تستقصي نقطة نهاية GET حتى تتغير الحالة من `queued` (في قائمة الانتظار) أو `running` (قيد التشغيل).

حلقة استقصاء بايثون الكاملة

import os
import time
import requests
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

# Step 1: submit
resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {"type": "text", "text": "Aerial shot of a mountain lake at sunrise, slow dolly forward"}
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

task_id = resp.id
print(f"Task submitted: {task_id}")

# Step 2: poll with exponential backoff
wait = 10
while True:
    result = client.content_generation.tasks.get(task_id=task_id)
    status = result.status
    print(f"Status: {status}")

    if status == "succeeded":
        video_url = result.content.video_url
        print(f"Video URL: {video_url}")
        break
    elif status in ("failed", "expired", "cancelled"):
        print(f"Task ended with status: {status}")
        break

    time.sleep(wait)
    wait = min(wait * 2, 60)  # cap at 60 seconds

# Step 3: download immediately
if status == "succeeded":
    response = requests.get(video_url, stream=True)
    with open("output.mp4", "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)
    print("Downloaded: output.mp4")

يمنع التراجع الأسي إرهاق واجهة برمجة التطبيقات. يضمن الحد الأقصى عند 60 ثانية أن يكون الاستقصاء متكررًا بما يكفي للاستخدام العملي.

الصورة إلى فيديو (I2V): تحريك صورة ثابتة

لتحريك صورة، أضف كائن image_url إلى مصفوفة content جنبًا إلى جنب مع مطالباتك النصية. تصبح الصورة الإطار الأول للفيديو.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The woman slowly turns her head and smiles at the camera"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/portrait.jpg"}
        }
    ],
    ratio="adaptive",
    duration=5,
    watermark=False,
)

يخبر تعيين ratio إلى "adaptive" (تكييفي) النموذج باستخدام نسبة العرض إلى الارتفاع الأصلية للصورة المدخلة. وهذا يتجنب الاقتصاص غير المرغوب فيه أو إطارات الشريط الأسود.

يجب أن يكون حجم كل صورة أقل من 30 ميجابايت. يمكنك توفير ما يصل إلى 9 صور في طلب واحد.

الإطار الأول والأخير: التحكم في نقاط البداية والنهاية

تدعم Seedance 2.0 التحكم في الإطارات المحدِّدة. توفر صورة الإطار الأول، وصورة الإطار الأخير، ومطالبة نصية. يقوم النموذج بإنشاء الحركة بينهما.

هذا مفيد لانتقالات المنتجات، وتأثيرات التحويل (morphing)، أو أي تسلسل تعرف فيه حالات البداية والنهاية.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The flower blooms from bud to full open, macro lens, soft light"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-bud.jpg"}
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-open.jpg"}
        }
    ],
    ratio="adaptive",
    duration=8,
    watermark=False,
)

يستنتج النموذج أن صورتين تعنيان وضع الإطار الأول والأخير عندما تكون هناك مطالبة نصية أيضًا. قم بتضمين كلتا الصورتين بالترتيب: الإطار الأول أولاً، ثم الإطار الأخير ثانيًا.

يمكنك أيضًا استخدام return_last_frame: true عند إنشاء مقطع. تُرجع هذه الخاصية صورة للإطار الأخير بجانب عنوان URL للفيديو. استخدم هذه الصورة كإطار أول لطلبك التالي لربط مقاطع متعددة في تسلسل أطول.

مرجع متعدد الوسائط: دمج الصور والفيديو والصوت

إحدى أقوى الإضافات في Seedance 2.0 هي قبول الفيديو والصوت كمدخلات مرجعية في نفس الطلب مثل الصور والنصوص.

يمكن لمصفوفة المحتوى أن تحتوي على:

{"type": "text", "text": "..."} للمطالبة
{"type": "image_url", "image_url": {"url": "..."}} للصور
{"type": "video_url", "video_url": {"url": "..."}} لمراجع الفيديو
{"type": "audio_url", "audio_url": {"url": "..."}} لمراجع الصوت

الحدود لكل طلب:

ما يصل إلى 9 صور (بحد أقصى 30 ميجابايت لكل منها)
ما يصل إلى 3 مقاطع فيديو (من 2 إلى 15 ثانية لكل منها، بحد أقصى 50 ميجابايت لكل منها)
ما يصل إلى 3 ملفات صوتية (MP3، بحد أقصى 15 ميجابايت لكل منها)

مثال على مرجع مجمع:

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "Match the visual style of the reference clip and add the provided background audio"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/style-reference.jpg"}
        },
        {
            "type": "video_url",
            "video_url": {"url": "https://example.com/motion-reference.mp4"}
        },
        {
            "type": "audio_url",
            "audio_url": {"url": "https://example.com/background-music.mp3"}
        }
    ],
    duration=10,
    ratio="16:9",
    watermark=False,
)

عند تضمين مرجع فيديو، ينخفض سعر الفوترة إلى فئة V2V: حوالي 3.90 دولار أمريكي لكل مليون رمز مميز بدلاً من 6.40 دولار أمريكي.

توليد الصوت الأصلي

اضبط generate_audio: true لجعل Seedance تُنشئ مسارًا صوتيًا جنبًا إلى جنب مع الفيديو. يقوم النموذج بإجراء إنشاء صوتي-مرئي مشترك، لذا تتطابق الأصوات مع الحركة التي تظهر على الشاشة بدلاً من أن تُضاف لاحقًا.

يغطي توليد الصوت الحوارات والمؤثرات الصوتية والضوضاء المحيطة والموسيقى الخلفية. تعمل مزامنة الشفاه بأكثر من 8 لغات.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A street musician plays guitar outside a cafe in Paris, crowds passing by, city sounds"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=10,
    generate_audio=True,
    watermark=False,
)

يزيد توليد الصوت الأصلي من استهلاك الرموز المميزة قليلاً مقارنة بالفيديو الصامت. ضع هذا في الاعتبار عند تقدير التكاليف.

التحكم في الدقة والنسبة والمدة

ثلاثة معايير تشكل الإخراج:

تقبل resolution القيم "480p" أو "720p" أو "1080p" أو "2K". القيمة الافتراضية هي "1080p". تعني الدقة الأعلى استهلاك المزيد من الرموز المميزة وتكلفة أعلى.

تقبل ratio القيم "16:9" أو "9:16" أو "4:3" أو "3:4" أو "21:9" أو "1:1" أو "adaptive" (تكييفي). استخدم "adaptive" عندما تكون نسبة العرض إلى الارتفاع للصورة المدخلة غير عادية. يقرأ النموذج أبعاد الصورة ويحدد النسبة وفقًا لذلك.

تقبل duration أعدادًا صحيحة من 4 إلى 15. الوحدة هي الثواني. القيمة الافتراضية هي 5. تكلف مقاطع الفيديو الأطول أكثر بشكل متناسب.

ينشئ النموذج السريع (doubao-seedance-2-0-fast-260128) بجودة أقل ولكنه ينهي المهمة بشكل أسرع. استخدمه للنماذج الأولية أو عندما تكرر على المطالبات. انتقل إلى النموذج القياسي للإخراج الإنتاجي.

متى تختار Seedance 2.0 على واجهات برمجة تطبيقات الفيديو الأخرى: اختر Seedance عندما تحتاج إلى إنشاء صوت وفيديو مشترك أصلي، أو التحكم في الإطارات المحدِّدة، أو مدخلات مرجعية متعددة الوسائط. إذا كنت تحتاج فقط إلى تحويل نص إلى فيديو بسيط وكانت التكلفة هي الأولوية، فإن النموذج السريع بدقة 480p هو الخيار الأرخص في هذه الفئة.

قراءة التكلفة من الاستجابة

بعد نجاح المهمة، تتضمن الاستجابة حقل usage:

{
  "usage": {
    "completion_tokens": 246840,
    "total_tokens": 246840
  }
}

يتناسب استهلاك الرموز المميزة مع طول الفيديو ودقته. نقطة مرجعية من الوثائق الرسمية: فيديو بدقة 1080p ومدته 15 ثانية يستهلك ما يقرب من 308,880 رمزًا مميزًا. فيديو بدقة 1080p ومدته 5 ثوانٍ يستخدم ما يقرب من 102,960 رمزًا مميزًا.

تسعير T2V و I2V بدقة 1080p هو 46 يوانًا لكل مليون رمز مميز (حوالي 6.40 دولار أمريكي لكل مليون رمز مميز بأسعار الصرف الحالية).

تقديرات سريعة:

فيديو 1080p مدته 5 ثوانٍ: حوالي 102,960 رمزًا مميزًا = حوالي 0.47 يوان = حوالي 0.93 دولار أمريكي
فيديو 1080p مدته 10 ثوانٍ: حوالي 205,920 رمزًا مميزًا = حوالي 9.47 يوان = حوالي 1.97 دولار أمريكي

لمهام V2V (الطلبات التي تتضمن مرجع فيديو)، ينخفض السعر إلى 28 يوانًا لكل مليون رمز مميز (حوالي 3.90 دولار أمريكي لكل مليون رمز مميز).

يمكنك التحقق من العدد الدقيق للرموز المميزة في كل استجابة ودمج تتبع التكلفة في تطبيقك. اضرب completion_tokens في السعر الخاص بنوع مهمتك.

هام: قم بتنزيل الفيديو في غضون 24 ساعة

يشير video_url في الاستجابة الناجحة إلى تخزين كائنات Volcengine. ينتهي صلاحية عنوان URL هذا بعد 24 ساعة من نجاح المهمة. بعد ذلك، يُرجع عنوان URL خطأ 403 ويختفي الملف.

قم دائمًا بتنزيل الملف إلى مساحة التخزين الخاصة بك فورًا بعد أن تتغير الحالة إلى `succeeded` (نجحت). تتضمن حلقة الاستقصاء في القسم السابق خطوة التنزيل هذه كجزء من التدفق القياسي.

يؤكد حقل execution_expires_after نافذة انتهاء الصلاحية بالثواني. 172800 يعني 48 ساعة لسجل المهمة نفسه. لا يزال عنوان URL للفيديو تنتهي صلاحيته بعد 24 ساعة بغض النظر. ثق بقاعدة الـ 24 ساعة.

تاريخ المهام محدود أيضًا بآخر 7 أيام. لا يمكنك الاستعلام عن المهام الأقدم من ذلك.

كيف تختبر واجهة برمجة تطبيقات Seedance باستخدام Apidog

يحتوي نمط المهام غير المتزامنة على استدعاءين لواجهة برمجة التطبيقات يعتمدان على بعضهما البعض. لا يمكنك كتابة اختبار بطلب واحد له. تتعامل سيناريوهات اختبار Apidog مع هذا باستخدام تدفق متسلسل.

سيناريو اختبار Apidog يوضح الطلبات المتسلسلة.

إليك الإعداد الدقيق:

الخطوة 1: إنشاء سيناريو اختبار

في Apidog، انتقل إلى وحدة الاختبارات وأنشئ سيناريو جديدًا يسمى "إنشاء فيديو Seedance 2.0". قم بتعيين متغير البيئة ARK_API_KEY في إعدادات بيئة Apidog. استخدم {{ARK_API_KEY}} في أي مكان تشير فيه إلى المفتاح.

الخطوة 2: إضافة طلب الإرسال

أضف خطوة طلب POST مخصصة إلى https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks. اضبط رأس التخويل Authorization على Bearer {{ARK_API_KEY}}. أضف جسم JSON الخاص بك مع حقلي النموذج والمحتوى.

بعد هذه الخطوة، أضف معالج Extract Variable (استخراج متغير). اضبطه لاستخراج من نص الاستجابة باستخدام تعبير JSONPath $.id. احفظ القيمة في متغير بيئة يسمى TASK_ID.

الخطوة 3: إضافة معالج انتظار

أدخل معالج انتظار (Wait processor) بعد خطوة الاستخراج. اضبط التأخير على 30 ثانية. يمنح هذا النموذج وقتًا لبدء المعالجة قبل محاولة الاستقصاء الأولى.

الخطوة 4: إضافة طلب الاستقصاء في حلقة تكرار

أضف كتلة تحكم حلقة For بحد أقصى 20 تكرارًا. داخل الحلقة:

أضف خطوة طلب GET إلى https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{{TASK_ID}} بنفس رأس التخويل.
أضف معالج انتظار بتأخير 10 ثوانٍ بعد طلب GET.
اضبط شرط كسر الحلقة (Break If) على: $.status == "succeeded" أو $.status == "failed".

الخطوة 5: إضافة تأكيدات

بعد انتهاء الحلقة، أضف معالج تأكيد (Assertion processor) يتحقق من:

$.status يساوي "succeeded"
$.content.video_url ليس فارغًا

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

يمكنك أيضًا استيراد نقاط نهاية Seedance مباشرةً من أمر cURL إلى خطوات سيناريو الاختبار. يعمل هذا النهج جيدًا عندما ترغب في إضافة طلبات الإرسال والاستقصاء بسرعة دون إدخال كل رأس ومعامل يدويًا.

تفاصيل التسعير: تكلفة فيديو مدته 10 ثوانٍ

تستخدم واجهة برمجة تطبيقات Seedance تسعير الرموز المميزة بالدفع حسب الاستخدام. لا توجد مقاعد شهرية أو أرصدة لإدارتها بخلاف الرصيد التجريبي الأولي.

نوع المهمة	السعر (لكل مليون رمز مميز)
T2V / I2V بدقة 1080p	46 يوان (~6.40 دولار أمريكي)
V2V (إدخال مرجع فيديو)	28 يوان (~3.90 دولار أمريكي)

التكاليف التقريبية للمدد الشائعة بدقة 1080p:

المدة	الرموز المميزة التقريبية	التكلفة (T2V/I2V)
5 ثوانٍ	~103,000	~0.66 يوان / ~0.93 دولار أمريكي
10 ثوانٍ	~206,000	~9.48 يوان / ~1.32 دولار أمريكي
15 ثانية	~309,000	~14.21 يوان / ~1.97 دولار أمريكي

تبدأ الحسابات الجديدة بأرصدة تجريبية مجانية تغطي حوالي 8 عمليات إنشاء كاملة مدتها 15 ثانية. استخدم هذا الرصيد لتجربة المطالبات والإعدادات قبل الالتزام بعبء عمل إنتاجي.

تقلل الدقة الأقل من استهلاك الرموز المميزة بشكل كبير. يكلف فيديو بدقة 480p بنفس المدة أقل بكثير من فيديو بدقة 1080p. ابدأ التطوير بدقة 720p، ثم قم بترقية الدقة فقط لإخراجك النهائي.

الأخطاء الشائعة والحلول

429 عدد كبير جدًا من الطلبات

يعني هذا أنك تجاوزت حد التزامن، وليس حدًا لمعدل الطلبات في الدقيقة. هناك عدد كبير جدًا من المهام تعمل في نفس الوقت. استخدم التراجع الأسي (exponential backoff) عندما ترى رمز الحالة هذا. ابدأ بانتظار 10 ثوانٍ وضاعفه في كل إعادة محاولة، بحد أقصى 60 ثانية. تتضمن حلقة الاستقصاء الموضحة سابقًا هذا النمط.

الحالة: "فشلت"

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

الحالة: "انتهت صلاحيتها"

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

403 على video_url

انتهت صلاحية عنوان URL. مرت نافذة الـ 24 ساعة قبل أن تقوم بتنزيل الملف. قد يظل سجل المهمة موجودًا في واجهة برمجة التطبيقات لمدة تصل إلى 7 أيام، لكن ملف الفيديو قد اختفى. ستحتاج إلى إعادة إنشائه باستخدام نفس المعلمات وقيمة البذرة (seed value) إذا قمت بحفظها.

قابلية تكرار البذرة

إذا قمت بحفظ قيمة البذرة (seed value) من استجابة سابقة، قم بتمريرها مرة أخرى في الطلب التالي بنفس المعلمات. سيحاول النموذج إعادة إنتاج نفس الإخراج. هذا مفيد لإعادة إنشاء مقاطع الفيديو منتهية الصلاحية بنتائج متطابقة.

الخاتمة

توفر واجهة برمجة تطبيقات Seedance 2.0 وصولاً برمجيًا إلى أحد أكثر نماذج إنشاء الفيديو قدرة المتوفرة اليوم. نمط المهام غير المتزامنة بسيط ومباشر: طلب POST لإنشاء مهمة، استقصاء حتى تنجح، ثم تنزيل فوري. المدخلات متعددة الوسائط، وتوليد الصوت الأصلي، والتحكم في الإطارات المحدِّدة تجعل من الممكن بناء سير عمل للفيديو كان مستحيلًا من خلال وحدة تحكم الويب.

قم بإعداد تغطية الاختبار الخاصة بك في Apidog قبل الانتقال إلى مرحلة الإنتاج. يكتشف تسلسل سيناريوهات الاختبار منطق الاستقصاء الخاطئ، وخطوات الاستخراج المفقودة، ومشكلات انتهاء صلاحية عنوان URL قبل أن تؤثر على المستخدمين الحقيقيين.

زر

الأسئلة الشائعة

س: ما الفرق بين doubao-seedance-2-0-260128 و doubao-seedance-2-0-fast-260128؟

ج: ينتج النموذج القياسي إخراجًا بجودة أعلى وهو الافتراضي للإنتاج. يكمل النموذج السريع المهام بسرعة أكبر بجودة بصرية أقل. استخدم النموذج السريع عند تكرار المطالبات وانتقل إلى النموذج القياسي لعمليات العرض النهائية.

س: هل يمكنني استخدام Seedance 2.0 خارج الصين؟

ج: يتم استضافة نقطة نهاية واجهة برمجة التطبيقات في منطقة بكين. يمكن للمطورين خارج الصين استدعائها، ولكن زمن الاستجابة سيكون أعلى. تحقق من شروط خدمة Volcengine لمعرفة أي قيود جغرافية على نوع حسابك.

س: كيف أربط عدة مقاطع فيديو معًا لإنشاء فيديو أطول؟

ج: عيّن return_last_frame: true لكل عملية إنشاء. ستتضمن الاستجابة صورة للإطار الأخير بجانب عنوان URL للفيديو. قم بتمرير تلك الصورة كإطار أول لطلبك التالي. كرر ذلك حتى تحصل على جميع المقاطع التي تحتاجها، ثم قم بدمجها باستخدام مكتبة تحرير الفيديو.

س: هل يكلف توليد الصوت الأصلي أكثر؟

ج: يزيد توليد الصوت الأصلي من استهلاك الرموز المميزة قليلاً لأن النموذج يدير توليد الصوت والفيديو المشترك بدلاً من الفيديو فقط. توقع زيادة متواضعة في completion_tokens مقارنة بنفس الطلب بدون generate_audio: true.

س: هل يمكنني تعيين webhook بدلاً من الاستقصاء؟

ج: نعم. قم بتمرير معلمة callback_url في طلب الإرسال الخاص بك. ستقوم واجهة برمجة التطبيقات بإرسال (POST) نتيجة المهمة المكتملة إلى عنوان URL هذا عندما تتغير الحالة. هذا أكثر كفاءة من الاستقصاء لخطوط الأنابيب ذات الحجم الكبير.

س: ماذا يحدث إذا تجاوزت حد الـ 9 صور؟

ج: تُرجع واجهة برمجة التطبيقات خطأ التحقق 400 قبل إنشاء المهمة. قلل عدد الصور في مصفوفة المحتوى لديك إلى 9 أو أقل.

س: هل يُضمن أن معلمة البذرة (seed parameter) ستُعيد إنتاج نفس الفيديو تمامًا؟

ج: تزيد معلمة البذرة (seed parameter) من قابلية تكرار المخرجات. لا يُضمن إعادة الإنتاج الدقيق إذا اختلفت المعلمات أو تغيرت إصدارات النموذج على جانب الخادم. إنه أقرب تقدير متاح.

س: كيف أتبع الإنفاق عبر مهام متعددة؟

ج: اقرأ حقل completion_tokens من استجابة كل مهمة واضربه في سعر الرموز المميزة لفئتك. سجل هذه القيم في قاعدة بيانات لتتبع التكلفة. لا توجد لوحة تحكم مدمجة للإنفاق في واجهة برمجة التطبيقات، لذا قم ببناء نظام التتبع الخاص بك من البداية.