كيف يتعامل Seedance 2.0 مع الصوت ومزامنة حركة الشفاه؟

يولد النموذج الصوت والفيديو بشكل مشترك، ما يوفر مزامنة صوتية-مرئية أصلية مع مزامنة شفاه على مستوى الفونيمات في 8+ لغات للكلام الطبيعي والمؤثرات الصوتية.

هل يتيح Seedance 2.0 تحرير وتمديد مقاطع الفيديو القائمة؟

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

ما أنواع المدخلات التي يدعمها Seedance 2.0 لتوليد مقاطع الفيديو؟

يدعم Seedance 2.0 مدخلات متعددة الوسائط تشمل مطالبات نصية، حتى 9 صور، وحتى 3 مقاطع فيديو قصيرة، وحتى 3 ملفات صوتية، ويمكن دمجها بحرية للحصول على توليد غني وقابل للتحكم.

ما المخرجات ومستويات الجودة التي يمكنني توقعها من مقاطع فيديو Seedance 2.0؟

يمكن لـ Seedance 2.0 توليد مقاطع فيديو بجودة سينمائية (بدقة تصل إلى 2K) مع صوت أصلي، وحوارات متزامنة، وتوليد حركة طبيعية، وعادة ما تكون بطول مقاطع من 5–60 ثانية.

ما القيود المعروفة أو أطوال التوليد النموذجية في Seedance 2.0؟

تتراوح أطوال المخرجات النموذجية من ~5 إلى ~60 ثانية لكل فيديو، ويمكن أن يؤدي دمج العديد من الأصول أو إعدادات الدقة العالية إلى زيادة زمن التوليد.

كيف تعمل الأصول المرجعية (الصور، مقاطع الفيديو) ضمن مطالبات Seedance 2.0؟

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

هل يستطيع Seedance 2.0 الحفاظ على اتساق الشخصيات والأسلوب عبر لقطات فيديو متعددة؟

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

هل يناسب Seedance 2.0 المشاريع الإبداعية الاحترافية مثل التسويق أو الأفلام القصيرة السردية؟

نعم — يجعل التحكم متعدد الوسائط واستمرارية اللقطات المتعددة والمخرجات عالية الدقة في Seedance 2.0 منه مناسبا لمقاطع التسويق، والأفلام السردية القصيرة، والإعلانات، وغيرها من التطبيقات الاحترافية.

Bytedance

متاح شائع

doubao-seedance-2-0

Seedance 2-0 API

Seedance 2.0 هو نموذج أساسي متعدد الوسائط للفيديو من ByteDance من الجيل التالي، يركز على توليد فيديو سردي سينمائي متعدد اللقطات. وعلى خلاف العروض التوضيحية لتحويل النص إلى فيديو أحادية اللقطة، يركز Seedance 2.0 على التحكم القائم على المراجع (صور، مقاطع قصيرة، صوت)، وعلى اتساق متماسك للشخصيات/الأسلوب عبر اللقطات، وعلى مزامنة أصلية للصوت/الفيديو — بهدف جعل الفيديو القائم على الذكاء الاصطناعي مفيدًا لمسارات العمل الإبداعية الاحترافية والتصوّر المسبق.

السعر الابتدائي

$0.056 / ثانية

فوترة حسب الاستخدام

حالة الواجهة

متاح

نقطة نهاية الإنتاج

زمن الاستجابة

جاهز للعمل غير المتزامن

زمن استجابة الواجهة المُلاحَظ

تاريخ الإصدار

Apr 19, 2026

Bytedance

Playground

جرّب Seedance 2-0 بطلب فعلي، راجع معلماته وتحقق من صحة الإخراج قبل دمج الواجهة.

نظرة عامة

نظرة عامة عملية على Seedance 2-0، تشمل السلوكيات المهمة واعتبارات التكامل.

المواصفات التقنية لـ Doubao Seedance 2.0

البند	التفاصيل
Product family	سلسلة توليد الفيديو ByteDance Seedance
CometAPI slug	doubao-seedance-2-0
Provider	ByteDance / BytePlus ModelArk
Model type	نموذج توليد فيديو
Input modalities	نص، صورة
Output type	فيديو MP4
Output resolution	480p, 720p, 1080p
Aspect ratios	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Output duration	4–15 ثانية
API style	توليد فيديو قائم على مهام غير متزامنة

ما هو Doubao Seedance 2.0؟

Doubao Seedance 2.0 هو نموذج توليد فيديو متعدد الوسائط رائد من ByteDance (صدر في فبراير 2026). يعتمد معمارية توليد مشتركة موحّدة للصوت والفيديو تتيح تحكماً دقيقاً على مستوى المخرج عبر الاستناد بالتزامن إلى عدة صور ومقاطع فيديو وملفات صوتية. يتفوق في إنتاج فيديوهات سينمائية مستقرة الحركة مع مزامنة صوت أصلية — مما يجعله مثالياً للمبدعين المحترفين الذين يحتاجون إلى فيزياء واقعية وشخصيات متسقة وتركيب مشاهد معقد.

الميزات الرئيسية لـ Doubao Seedance 2.0 على CometAPI

توليد متعدد الوسائط موحّد: يقبل مدخلات نصوص وصور وصوت وفيديو ضمن سير عمل واحد، ما يتيح للمستخدمين إخراج مشاهد بالاعتماد على مواد مرجعية أغنى مقارنة بمولد يعتمد على النص فقط.
تحكم بأسلوب المخرج: تم بناء النموذج لاتباع التعليمات المتعلقة بالأداء والإضاءة والظلال وحركة الكاميرا وإيقاع الحركة وخصائص الصوت.
تحرير الفيديو وتمديده: لا يقتصر Seedance 2.0 على التوليد الأولي؛ بل يدعم تحرير لقطات، وشخصيات، وحركات، وخطوط سرد محددة، بالإضافة إلى التمديد للأمام/للخلف.
مزامنة قوية بين الصوت والصورة: تُبرز ByteDance خرج ستيريو ثنائي القناة ومزامنة بين الموسيقى الخلفية والأصوات المحيطة وتصرفات التعليق الصوتي لنتائج أكثر غمراً.
قابلية تحكم عالية في المشاهد المعقدة: تؤكد على تحسين التعامل مع التفاعلات المعقدة، ومشاهد الحركة، ومعقولية الفيزياء مقارنة بـ Seedance 1.5.
مخرجات موجهة للإنتاج: تدعم الواجهة إعدادات النسبة والمدة والعلامة المائية، ما يجعل النموذج عملياً لسير عمل محتوى قابل للتكرار.

أداء الاختبارات المعيارية

تقول ByteDance إن Seedance 2.0 يستخدم التقييم الداخلي SeedVideoBench-2.0 ويحتل مرتبة متقدمة عبر أبعاد مهام نص-إلى-فيديو، وصورة-إلى-فيديو، ومتعددة الوسائط. يحسّن النموذج جودة التوليد والدقة الفيزيائية والواقعية وقابلية التحكم مقارنة بـ Seedance 1.5، خاصة في التفاعل المعقد ومشاهد الحركة.

أنماط Seedance 2.0 API وSeedance 2.0 Fast API على CometAPI

النموذج	اسم النموذج في CometAPI	أفضل استخدام	الاختلاف الرئيسي
Seedance 2.0	doubao-seedance-2-0	إنشاء فيديو متعدد الوسائط بأعلى جودة	أوسع مجموعة مراجع وأقوى قابلية تحكم ضمن عائلة Seedance 2.0.
Seedance 2.0 fast	doubao-seedance-2-0-fast	إنتاج أسرع عندما يمكن التنازل قليلاً عن الجودة	تقول ByteDance إنه يحتفظ بالقدرات نفسها مثل Seedance 2.0، لكنه يولد بشكل أسرع.
Seedance 1.5 Pro	doubao-seedance-1-5-pro	إنشاء صوت-فيديو من جيل سابق	يتموضع Seedance 1.5 Pro كنموذج مشترك صوت-فيديو أصيل، بينما يوسّع Seedance 2.0 رزمة المراجع والتحرير متعددة الوسائط.

نقاط القوة مقابل المنافسين:

مقابل Kling 3.0: تحكم أفضل بالمراجع متعددة الوسائط وصوت أصيل.
مقابل Sora 2: دقة مرجعية أعلى وقدرة على اللقطات المتعددة؛ مدة قصوى أقل قليلاً.
مقابل Veo 3.1: تفوق في اتساق الشخصيات والالتزام بالموجهات في سير العمل المعتمد على المراجع بكثافة؛ تتفوق Veo في التصحيح السينمائي الخام والمقاطع الأطول.

يتفوق في الفيديوهات المتمحورة حول الإنسان والموجهة بالأداء.

جرّب مُولِّد الفيديو بالذكاء الاصطناعي Seedance 2.0 على CometAPI

الخطوة 1: الخطوة 1: اشترك للحصول على مفتاح API

ابدأ مباشرة في CometAPI Playground لتجربة Doubao Seedance 2.0 دون أي إعداد أو برمجة. ما عليك سوى تسجيل الدخول إلى حساب CometAPI، والانتقال إلى صفحة النموذج doubao-seedance-2-0، ورفع صورك المرجعية أو مقاطع الفيديو القصيرة أو الملفات الصوتية، وإضافة موجه وصفي، وتوليد فيديوهات معاينة فوراً. هذه أسرع طريقة لفهم كيفية تعامل Seedance 2.0 مع اتساق الحركة، ومظهر الشخصيات، وحركات الكاميرا، والمزامنة الصوتية الأصلية.

الخطوة 2: احصل على وصول API لـ Seedance 2.0 على CometAPI

أنشئ مفتاح CometAPI جديداً أو استخدم مفتاحك الحالي لتمكين الوصول الكامل إلى Doubao Seedance 2.0. بعد تسجيل الدخول، انتقل إلى قسم API Token في لوحتك، وأنشئ مفتاحاً جديداً ثم انسخه. بعد ذلك زر صفحة تفاصيل نموذج Seedance 2.0 ووثائق API على CometAPI لمراجعة المعلمات المدعومة ودمجها في مشاريعك.

الخطوة 3: أرسل أول طلب باستخدام Seedance 2.0 API

استخدم نقطة نهاية CometAPI لإرسال أول طلب توليد فيديو بموجه نصي واضح وملفات مرجعية اختيارية (صور أو فيديو أو صوت). سيعالج النظام المهمة بشكل غير متزامن، ويعيد معرّف مهمة، ويوفر ملف فيديو MP4 قابلًا للتنزيل عند اكتمالها. يمكنك بعدها تحسين موجهاتك، وضبط الإعدادات، والتوسّع لإنتاج فيديوهات تسويقية أو محتوى منصات اجتماعية أو خطوط أنابيب فيديو مؤتمتة أو تطبيقات إبداعية تعمل بواسطة Seedance 2.0.

يوفّر هذا التدفق لك تجربة سريعة في الـ Playground وانتقالاً سلساً إلى الاستخدام الإنتاجي عبر CometAPI.

أهم الأسباب لاختيار Seedance 2.0 على CometAPI

لماذا تستخدم CometAPI مع Seedance 2.0

وصول مباشر عبر API أو Playground
تحكم سهل بالمعاملات (المدة، الدقة، الصيغة)
يدعم كلّاً من مسارات نص-إلى-فيديو وصورة-إلى-فيديو
معالجة مهام مدمجة لتوليد الفيديو غير المتزامن

واجهة API موحّدة وملائمة للمطورين

تقدم CometAPI نقطة نهاية نظيفة وموحدة تعمل بسلاسة مع تنسيقات على نمط OpenAI أو نقاط نهاية مخصصة لمهام الفيديو. ستحصل على إنشاء مهام بسيط، واستطلاع حالة، وتنزيلات MP4 من دون التعامل مع مصادقة Volcengine المعقدة أو القيود الإقليمية.

تسعير اقتصادي

توفر CometAPI عادةً أسعاراً أكثر تنافسية لكل ثانية مقارنة بالمزودين المباشرين، مما يتيح لك توليد فيديوهات عالية الجودة على نطاق واسع للتسويق ووسائل التواصل الاجتماعي أو خطوط الأنابيب المؤتمتة دون تجاوز ميزانيتك.

اختبار سريع عبر Playground

جرّب فوراً في CometAPI Playground. ارفع صوراً مرجعية ومقاطع فيديو وملفات صوتية، وعدّل الموجهات، وشاهد المعاينات خلال دقائق — مثالي لتكرار الأسلوب والحركة والمزامنة الصوتية قبل الانتقال إلى الإنتاج.

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

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

التسعير

استخدم التقدير السريع أعلاه لعملية تشغيل واحدة، ثم راجع المقارنة الكاملة بين أسعار CometAPI والأسعار الرسمية.

اختبار 5 ثانية

$0.28

التكلفة التقديرية لاستخدام CometAPI

اختبار 10 ثانية

$0.56

التكلفة التقديرية لاستخدام CometAPI

اختبار 15 ثانية

$0.84

التكلفة التقديرية لاستخدام CometAPI

التسعير لـ Seedance 2-0

استكشف الأسعار التنافسية لـ Seedance 2-0، المصمم ليناسب الميزانيات المختلفة واحتياجات الاستخدام المتنوعة. تضمن خططنا المرنة أن تدفع فقط مقابل ما تستخدمه، مما يجعل من السهل التوسع مع نمو متطلباتك. اكتشف كيف يمكن لـ Seedance 2-0 تحسين مشاريعك مع الحفاظ على التكاليف قابلة للإدارة.

doubao-seedance Video Generation Pricing

Parameters

Parameter	Description
Duration (seconds)	4–15 seconds, default 5 seconds
size	Refer to documentation

*1080p is unavailable for doubao-seedance-2-0-fast and doubao-seedance-2-0-mini.

Pricing (Per Second)

Model	480p	720p	1080p	4k
`doubao-seedance-2-0`	$0.056	$0.1216	$0.2992	$0.624
`doubao-seedance-2-0-fast`	$0.0448	$0.096	—	—
`doubao-seedance-2-0-mini`	$0.032	$0.064	—	—
`doubao-seedance-1-5-pro`	$0.0192	$0.0416	$0.0928	—

💡 Billed per second. Total cost = price per second × video duration (seconds). Duration range: 4–15 seconds.

API

انسخ نقطة نهاية ونموذج كود يعملان، ثم افتح المرجع الكامل للواجهة عند الحاجة إلى جميع المعلمات.

واجهة برمجة تطبيقات واحدة، وصول للنماذج جاهز للإنتاج

قم بالمصادقة مرة واحدة، واستدعِ نقطة نهاية النموذج، وحافظ على نفس سير عمل الفوترة والمراقبة عبر جميع المزودين.

POST/v1/videos

نموذج الكود وواجهة برمجة التطبيقات لـ Seedance 2-0

احصل على أكواد نماذجية شاملة وموارد API لـ Seedance 2-0 لتبسيط عملية التكامل الخاصة بك. توفر وثائقنا التفصيلية إرشادات خطوة بخطوة، مما يساعدك على الاستفادة من الإمكانات الكاملة لـ Seedance 2-0 في مشاريعك.

POST

/v1/videos

set -euo pipefail

# Get your CometAPI key from https://www.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"
OUTPUT_DIR="./output"
POLL_INTERVAL_SECONDS=10
RETRY_DELAY_SECONDS=5
MAX_CREATE_ATTEMPTS=5
MAX_QUERY_ATTEMPTS=3

is_progress_complete() {
  local progress="$1"
  local normalized="${progress%%%}"

  if [[ -z "$normalized" ]]; then
    return 1
  fi

  [[ "$normalized" =~ ^[0-9]+([.][0-9]+)?$ ]] || return 1
  awk -v value="$normalized" 'BEGIN { exit !(value >= 100) }'
}

create_task() {
  local attempt=1
  while (( attempt <= MAX_CREATE_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'
%{http_code}' "https://api.cometapi.com/v1/videos" \
      -H "Authorization: Bearer $COMETAPI_KEY" \
      -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
      -F 'model="doubao-seedance-2-0"' \
      -F 'seconds="5"' \
      -F 'size="16:9"')

    status_code=$(echo "$response" | tail -n 1)
    CREATE_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_CREATE_ATTEMPTS )); then
      echo "Create request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$CREATE_RESPONSE"
    return 1
  done
}

get_task() {
  local task_id="$1"
  local attempt=1
  while (( attempt <= MAX_QUERY_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'
%{http_code}' "https://api.cometapi.com/v1/videos/${task_id}" \
      -H "Authorization: Bearer $COMETAPI_KEY")

    status_code=$(echo "$response" | tail -n 1)
    TASK_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_QUERY_ATTEMPTS )); then
      echo "Status request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$TASK_RESPONSE"
    return 1
  done
}

create_task

TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id // .task_id // empty')

if [[ -z "$TASK_ID" ]]; then
  echo "$CREATE_RESPONSE" | jq .
  echo "No task id returned."
  exit 1
fi

echo "Task created: $TASK_ID"
echo "Initial status: $(echo "$CREATE_RESPONSE" | jq -r '.status // empty')"

while true; do
  get_task "$TASK_ID"

  STATUS=$(echo "$TASK_RESPONSE" | jq -r '.status // empty')
  NORMALIZED_STATUS=$(echo "$STATUS" | tr '[:upper:]' '[:lower:]')
  PROGRESS=$(echo "$TASK_RESPONSE" | jq -r '.progress // empty')
  SHOULD_TRY_DOWNLOAD=0

  if [[ "$NORMALIZED_STATUS" == "success" || "$NORMALIZED_STATUS" == "completed" ]]; then
    SHOULD_TRY_DOWNLOAD=1
  elif [[ "$NORMALIZED_STATUS" == "unknown" ]] && is_progress_complete "$PROGRESS"; then
    SHOULD_TRY_DOWNLOAD=1
  fi

  echo "Status: ${STATUS}, progress: ${PROGRESS}"

  if [[ "$SHOULD_TRY_DOWNLOAD" == "1" || "$NORMALIZED_STATUS" == "failed" || "$NORMALIZED_STATUS" == "error" ]]; then
    if [[ "$SHOULD_TRY_DOWNLOAD" == "1" ]]; then
      VIDEO_URL=$(echo "$TASK_RESPONSE" | jq -r '.video_url // empty')

      OUTPUT_PATH="${OUTPUT_DIR}/${TASK_ID}.mp4"

      mkdir -p "$OUTPUT_DIR"
      curl -fsS "https://api.cometapi.com/v1/videos/${TASK_ID}/content" \
        -H "Authorization: Bearer $COMETAPI_KEY" \
        -o "$OUTPUT_PATH"

      if [[ ! -s "$OUTPUT_PATH" ]]; then
        echo "Failed to download video"
        exit 1
      fi

      echo "Video URL: ${VIDEO_URL}"
      echo "Content endpoint: https://api.cometapi.com/v1/videos/${TASK_ID}/content"
      echo "Saved to ${OUTPUT_PATH}"
      echo "File size: $(wc -c < "$OUTPUT_PATH" | tr -d ' ') bytes"
    else
      echo "$TASK_RESPONSE" | jq .
      exit 1
    fi
    break
  fi

  sleep "$POLL_INTERVAL_SECONDS"
done

cURL Code Example

set -euo pipefail

# Get your CometAPI key from https://www.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"
OUTPUT_DIR="./output"
POLL_INTERVAL_SECONDS=10
RETRY_DELAY_SECONDS=5
MAX_CREATE_ATTEMPTS=5
MAX_QUERY_ATTEMPTS=3

is_progress_complete() {
  local progress="$1"
  local normalized="${progress%%%}"

  if [[ -z "$normalized" ]]; then
    return 1
  fi

  [[ "$normalized" =~ ^[0-9]+([.][0-9]+)?$ ]] || return 1
  awk -v value="$normalized" 'BEGIN { exit !(value >= 100) }'
}

create_task() {
  local attempt=1
  while (( attempt <= MAX_CREATE_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'\n%{http_code}' "https://api.cometapi.com/v1/videos" \
      -H "Authorization: Bearer $COMETAPI_KEY" \
      -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
      -F 'model="doubao-seedance-2-0"' \
      -F 'seconds="5"' \
      -F 'size="16:9"')

    status_code=$(echo "$response" | tail -n 1)
    CREATE_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_CREATE_ATTEMPTS )); then
      echo "Create request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$CREATE_RESPONSE"
    return 1
  done
}

get_task() {
  local task_id="$1"
  local attempt=1
  while (( attempt <= MAX_QUERY_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'\n%{http_code}' "https://api.cometapi.com/v1/videos/${task_id}" \
      -H "Authorization: Bearer $COMETAPI_KEY")

    status_code=$(echo "$response" | tail -n 1)
    TASK_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_QUERY_ATTEMPTS )); then
      echo "Status request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$TASK_RESPONSE"
    return 1
  done
}

create_task

TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id // .task_id // empty')

if [[ -z "$TASK_ID" ]]; then
  echo "$CREATE_RESPONSE" | jq .
  echo "No task id returned."
  exit 1
fi

echo "Task created: $TASK_ID"
echo "Initial status: $(echo "$CREATE_RESPONSE" | jq -r '.status // empty')"

while true; do
  get_task "$TASK_ID"

  STATUS=$(echo "$TASK_RESPONSE" | jq -r '.status // empty')
  NORMALIZED_STATUS=$(echo "$STATUS" | tr '[:upper:]' '[:lower:]')
  PROGRESS=$(echo "$TASK_RESPONSE" | jq -r '.progress // empty')
  SHOULD_TRY_DOWNLOAD=0

  if [[ "$NORMALIZED_STATUS" == "success" || "$NORMALIZED_STATUS" == "completed" ]]; then
    SHOULD_TRY_DOWNLOAD=1
  elif [[ "$NORMALIZED_STATUS" == "unknown" ]] && is_progress_complete "$PROGRESS"; then
    SHOULD_TRY_DOWNLOAD=1
  fi

  echo "Status: ${STATUS}, progress: ${PROGRESS}"

  if [[ "$SHOULD_TRY_DOWNLOAD" == "1" || "$NORMALIZED_STATUS" == "failed" || "$NORMALIZED_STATUS" == "error" ]]; then
    if [[ "$SHOULD_TRY_DOWNLOAD" == "1" ]]; then
      VIDEO_URL=$(echo "$TASK_RESPONSE" | jq -r '.video_url // empty')

      OUTPUT_PATH="${OUTPUT_DIR}/${TASK_ID}.mp4"

      mkdir -p "$OUTPUT_DIR"
      curl -fsS "https://api.cometapi.com/v1/videos/${TASK_ID}/content" \
        -H "Authorization: Bearer $COMETAPI_KEY" \
        -o "$OUTPUT_PATH"

      if [[ ! -s "$OUTPUT_PATH" ]]; then
        echo "Failed to download video"
        exit 1
      fi

      echo "Video URL: ${VIDEO_URL}"
      echo "Content endpoint: https://api.cometapi.com/v1/videos/${TASK_ID}/content"
      echo "Saved to ${OUTPUT_PATH}"
      echo "File size: $(wc -c < "$OUTPUT_PATH" | tr -d ' ') bytes"
    else
      echo "$TASK_RESPONSE" | jq .
      exit 1
    fi
    break
  fi

  sleep "$POLL_INTERVAL_SECONDS"
done

Python Code Example

import json
import os
import time

import requests

# Get your CometAPI key from https://www.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com"
OUTPUT_DIR = "./output"
POLL_INTERVAL_SECONDS = 10
RETRY_DELAY_SECONDS = 5
MAX_CREATE_ATTEMPTS = 5
MAX_QUERY_ATTEMPTS = 3
TERMINAL_STATUSES = {"success", "completed", "failed", "error"}
SUCCESS_STATUSES = {"success", "completed"}


def is_progress_complete(progress):
    if isinstance(progress, int):
        return progress >= 100
    if isinstance(progress, float):
        return progress >= 100
    if isinstance(progress, str):
        try:
            return float(progress.rstrip("%")) >= 100
        except ValueError:
            return False
    return False


def is_transient_status(status_code):
    return status_code == 429 or 500 <= status_code < 600


def create_task(files):
    for attempt in range(1, MAX_CREATE_ATTEMPTS + 1):
        response = requests.post(
            f"{BASE_URL}/v1/videos",
            headers=headers,
            files=files,
            timeout=30,
        )
        if response.ok:
            return response
        if not is_transient_status(response.status_code) or attempt == MAX_CREATE_ATTEMPTS:
            response.raise_for_status()
        print(f"Create request returned {response.status_code}, retrying...")
        time.sleep(RETRY_DELAY_SECONDS)

    raise SystemExit("Failed to create task.")


def get_task(task_id):
    for attempt in range(1, MAX_QUERY_ATTEMPTS + 1):
        response = requests.get(
            f"{BASE_URL}/v1/videos/{task_id}",
            headers=headers,
            timeout=15,
        )
        if response.ok:
            return response
        if not is_transient_status(response.status_code) or attempt == MAX_QUERY_ATTEMPTS:
            response.raise_for_status()
        print(f"Status request returned {response.status_code}, retrying...")
        time.sleep(RETRY_DELAY_SECONDS)

    raise SystemExit("Failed to query task.")

if COMETAPI_KEY == "<YOUR_COMETAPI_KEY>":
    print("Set COMETAPI_KEY before running this example.")
    raise SystemExit(0)

headers = {"Authorization": f"Bearer {COMETAPI_KEY}"}

create_response = create_task(
    {
        "prompt": (None, "A slow cinematic camera push across a coastal landscape at sunrise."),
        "model": (None, "doubao-seedance-2-0"),
        "seconds": (None, "5"),
        "size": (None, "16:9"),
    }
)
create_response.raise_for_status()
create_result = create_response.json()

task_id = create_result.get("id") or create_result.get("task_id")
if not task_id:
    print(json.dumps(create_result, indent=2))
    raise SystemExit("No task id returned.")

print(f"Task created: {task_id}")
print(f"Initial status: {create_result.get('status')}")

while True:
    task_response = get_task(task_id)
    task_response.raise_for_status()
    task = task_response.json()
    status = str(task.get("status") or "unknown")
    normalized_status = status.lower()
    progress = task.get("progress")
    should_try_download = normalized_status in SUCCESS_STATUSES or (
        normalized_status == "unknown" and is_progress_complete(progress)
    )

    print(f"Status: {status}, progress: {progress}")

    if should_try_download or normalized_status in TERMINAL_STATUSES:
        if should_try_download:
            video_url = task.get("video_url") or ""
            content_url = f"{BASE_URL}/v1/videos/{task_id}/content"
            output_path = os.path.join(OUTPUT_DIR, f"{task_id}.mp4")

            os.makedirs(OUTPUT_DIR, exist_ok=True)
            with requests.get(
                content_url,
                headers=headers,
                timeout=120,
                stream=True,
            ) as video_response:
                video_response.raise_for_status()
                with open(output_path, "wb") as output_file:
                    for chunk in video_response.iter_content(chunk_size=8192):
                        if chunk:
                            output_file.write(chunk)

            print(f"Video URL: {video_url}")
            print(f"Content endpoint: {content_url}")
            print(f"Saved to {output_path}")
            print(f"File size: {os.path.getsize(output_path)} bytes")
        else:
            print(json.dumps(task, indent=2))
            raise SystemExit(1)
        break

    time.sleep(POLL_INTERVAL_SECONDS)

JavaScript Code Example

import fs from "fs";
import path from "path";

// Get your CometAPI key from https://www.cometapi.com/console/token, and paste it here
const api_key = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const base_url = "https://api.cometapi.com";
const output_dir = "./output";
const poll_interval_ms = 10_000;
const retry_delay_ms = 5_000;
const max_create_attempts = 5;
const max_query_attempts = 3;
const terminal_statuses = new Set(["success", "completed", "failed", "error"]);
const success_statuses = new Set(["success", "completed"]);

function is_progress_complete(progress) {
  if (typeof progress === "number") {
    return progress >= 100;
  }

  if (typeof progress === "string") {
    const numeric = Number(progress.replace(/%$/, ""));
    return Number.isFinite(numeric) && numeric >= 100;
  }

  return false;
}

function is_transient_status(status) {
  return status === 429 || status >= 500;
}

async function fetch_with_retry(url, options, attempts, label) {
  for (let attempt = 1; attempt <= attempts; attempt += 1) {
    const response = await fetch(url, options);
    if (response.ok) {
      return response;
    }

    if (!is_transient_status(response.status) || attempt === attempts) {
      return response;
    }

    console.log(`${label} returned ${response.status}, retrying...`);
    await new Promise((resolve) => setTimeout(resolve, retry_delay_ms));
  }

  throw new Error(`${label} failed`);
}

if (api_key === "<YOUR_COMETAPI_KEY>") {
  console.log("Set COMETAPI_KEY before running this example.");
  process.exit(0);
}

const headers = {
  Authorization: `Bearer ${api_key}`,
};

const form = new FormData();
form.set("prompt", "A slow cinematic camera push across a coastal landscape at sunrise.");
form.set("model", "doubao-seedance-2-0");
form.set("seconds", "5");
form.set("size", "16:9");

const create_response = await fetch_with_retry(`${base_url}/v1/videos`, {
  method: "POST",
  headers,
  body: form,
}, max_create_attempts, "Create request");

if (!create_response.ok) {
  console.log(await create_response.text());
  process.exit(1);
}

const create_result = await create_response.json();
const task_id = create_result.id || create_result.task_id;

if (!task_id) {
  console.log(JSON.stringify(create_result, null, 2));
  process.exit(1);
}

console.log(`Task created: ${task_id}`);
console.log(`Initial status: ${create_result.status}`);

while (true) {
  const task_response = await fetch_with_retry(`${base_url}/v1/videos/${task_id}`, {
    headers,
  }, max_query_attempts, "Status request");

  if (!task_response.ok) {
    console.log(await task_response.text());
    process.exit(1);
  }

  const task = await task_response.json();
  const status = String(task.status || "unknown");
  const normalized_status = status.toLowerCase();
  const progress = task.progress;
  const should_try_download = success_statuses.has(normalized_status) || (
    normalized_status === "unknown" && is_progress_complete(progress)
  );

  console.log(`Status: ${status}, progress: ${progress}`);

  if (should_try_download || terminal_statuses.has(normalized_status)) {
    if (should_try_download) {
      const video_url = task.video_url || "";
      const content_url = `${base_url}/v1/videos/${task_id}/content`;
      const output_path = path.join(output_dir, `${task_id}.mp4`);

      if (!fs.existsSync(output_dir)) {
        fs.mkdirSync(output_dir, { recursive: true });
      }

      const video_response = await fetch(content_url, { headers });
      if (!video_response.ok) {
        console.log(await video_response.text());
        process.exit(1);
      }

      const video_buffer = Buffer.from(await video_response.arrayBuffer());
      fs.writeFileSync(output_path, video_buffer);

      console.log(`Video URL: ${video_url}`);
      console.log(`Content endpoint: ${content_url}`);
      console.log(`Saved to ${output_path}`);
      console.log(`File size: ${fs.statSync(output_path).size} bytes`);
    } else {
      console.log(JSON.stringify(task, null, 2));
      process.exit(1);
    }
    break;
  }

  await new Promise((resolve) => setTimeout(resolve, poll_interval_ms));
}

الإمكانيات

راجع أهم بيانات النموذج قبل اختيار البنية أو تقدير حِمل الإنتاج.

الإمكانيات المدعومة

الميزات التي تُعيدها واجهة برمجة تطبيقات النموذج الحالية.

text-to-video

image-to-video

الإدخال والإخراج

المدخلات

text

المخرجات

video

ملف تعريف الإنتاج

المزود: Bytedance
سياق: يعتمد على النموذج
الاستخدام التجاري: مدعوم

حالات الاستخدام

استخدم Seedance 2-0 في سير عمل إنتاجي يناسب إمكانياته في video، ثم قارن البدائل قبل الالتزام بتكامل طويل الأمد.

تحويل النص إلى مفاهيم فيديو ومحتوى اجتماعي

عروض توضيحية للمنتجات ولوحات قصصية سينمائية

تحويل الصورة إلى حركة فيديو والتكرار الإبداعي

نماذج أخرى

قارن نماذج أخرى متاحة عبر CometAPI من حيث الجودة وزمن الاستجابة والإمكانيات والسعر.

فتح مقارنة النماذج →

Aliyun

Wan3.0

From fast verification to cinematic output, billing is based on the generated video duration, selecting the appropriate resolution, and turning every generation into a planned creative investment activity rule

عرض النموذج

Flux

Flux 3

FLUX 3 - Real World Models: Towards Multimodal Flow Models as the Backbone of Visual Intelligence.

عرض النموذج

Aliyun

Happy Horse 1.1

HappyHorse 1.1 هو نموذج توليد فيديو متعدد الوسائط مُصمَّم لإنتاج المحتوى الاحترافي والإعلان والأفلام القصيرة وإنتاج محتوى وسائل التواصل الاجتماعي وسرد القصص. وهو يوسّع إمكانات HappyHorse 1.0 — التي حظيت باهتمام كبير بعد حصوله على ترتيب مرتفع في تقييمات مستقلة لتوليد الفيديو — مع ترابط أقوى بين المشاهد ودقة بصرية محسّنة.

عرض النموذج

Google

Gemini omni fast

Gemini Omni Fast is a lightweight multimodal video generation model designed for fast and flexible content creation. It enables efficient video generation with support for multiple input types, making it suitable for interactive and iterative workflows.

عرض النموذج

OpenAI

Sora 2 Pro

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

عرض النموذج

Aliyun

Happy Horse 1.0

Happy Horse 1.0 — A high-quality audio-video generation model that supports text-to-video and image-to-video creation. It can generate synchronized visuals, audio, and lip movements, making it suitable for short films, advertising creatives, and product showcases.

عرض النموذج

Uptime

راجع بيانات النبض الحي وتوفر نقطة النهاية وأزمنة الاستجابة المُلاحَظة قبل الانتقال إلى الإنتاج.

الإصدارات

راجع معرّفات النماذج المتاحة قبل تثبيت تكامل الإنتاج.

doubao-seedance-2-0

doubao-seedance-2-0-fast

doubao-seedance-2-0-mini

واصل الاستكشاف

قارن النماذج وتابع بحثك

Bytedance

متاح شائع

doubao-seedance-2-0

Seedance 2-0 API

السعر الابتدائي

$0.056 / ثانية

فوترة حسب الاستخدام

حالة الواجهة

متاح

نقطة نهاية الإنتاج

زمن الاستجابة

جاهز للعمل غير المتزامن

زمن استجابة الواجهة المُلاحَظ

تاريخ الإصدار

Apr 19, 2026

Bytedance

Playground

جرّب Seedance 2-0 بطلب فعلي، راجع معلماته وتحقق من صحة الإخراج قبل دمج الواجهة.

نظرة عامة

نظرة عامة عملية على Seedance 2-0، تشمل السلوكيات المهمة واعتبارات التكامل.

المواصفات التقنية لـ Doubao Seedance 2.0

البند	التفاصيل
Product family	سلسلة توليد الفيديو ByteDance Seedance
CometAPI slug	doubao-seedance-2-0
Provider	ByteDance / BytePlus ModelArk
Model type	نموذج توليد فيديو
Input modalities	نص، صورة
Output type	فيديو MP4
Output resolution	480p, 720p, 1080p
Aspect ratios	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Output duration	4–15 ثانية
API style	توليد فيديو قائم على مهام غير متزامنة

ما هو Doubao Seedance 2.0؟

الميزات الرئيسية لـ Doubao Seedance 2.0 على CometAPI

توليد متعدد الوسائط موحّد: يقبل مدخلات نصوص وصور وصوت وفيديو ضمن سير عمل واحد، ما يتيح للمستخدمين إخراج مشاهد بالاعتماد على مواد مرجعية أغنى مقارنة بمولد يعتمد على النص فقط.
تحكم بأسلوب المخرج: تم بناء النموذج لاتباع التعليمات المتعلقة بالأداء والإضاءة والظلال وحركة الكاميرا وإيقاع الحركة وخصائص الصوت.
تحرير الفيديو وتمديده: لا يقتصر Seedance 2.0 على التوليد الأولي؛ بل يدعم تحرير لقطات، وشخصيات، وحركات، وخطوط سرد محددة، بالإضافة إلى التمديد للأمام/للخلف.
مزامنة قوية بين الصوت والصورة: تُبرز ByteDance خرج ستيريو ثنائي القناة ومزامنة بين الموسيقى الخلفية والأصوات المحيطة وتصرفات التعليق الصوتي لنتائج أكثر غمراً.
قابلية تحكم عالية في المشاهد المعقدة: تؤكد على تحسين التعامل مع التفاعلات المعقدة، ومشاهد الحركة، ومعقولية الفيزياء مقارنة بـ Seedance 1.5.
مخرجات موجهة للإنتاج: تدعم الواجهة إعدادات النسبة والمدة والعلامة المائية، ما يجعل النموذج عملياً لسير عمل محتوى قابل للتكرار.

أداء الاختبارات المعيارية

أنماط Seedance 2.0 API وSeedance 2.0 Fast API على CometAPI

النموذج	اسم النموذج في CometAPI	أفضل استخدام	الاختلاف الرئيسي
Seedance 2.0	doubao-seedance-2-0	إنشاء فيديو متعدد الوسائط بأعلى جودة	أوسع مجموعة مراجع وأقوى قابلية تحكم ضمن عائلة Seedance 2.0.
Seedance 2.0 fast	doubao-seedance-2-0-fast	إنتاج أسرع عندما يمكن التنازل قليلاً عن الجودة	تقول ByteDance إنه يحتفظ بالقدرات نفسها مثل Seedance 2.0، لكنه يولد بشكل أسرع.
Seedance 1.5 Pro	doubao-seedance-1-5-pro	إنشاء صوت-فيديو من جيل سابق	يتموضع Seedance 1.5 Pro كنموذج مشترك صوت-فيديو أصيل، بينما يوسّع Seedance 2.0 رزمة المراجع والتحرير متعددة الوسائط.

نقاط القوة مقابل المنافسين:

مقابل Kling 3.0: تحكم أفضل بالمراجع متعددة الوسائط وصوت أصيل.
مقابل Sora 2: دقة مرجعية أعلى وقدرة على اللقطات المتعددة؛ مدة قصوى أقل قليلاً.
مقابل Veo 3.1: تفوق في اتساق الشخصيات والالتزام بالموجهات في سير العمل المعتمد على المراجع بكثافة؛ تتفوق Veo في التصحيح السينمائي الخام والمقاطع الأطول.

يتفوق في الفيديوهات المتمحورة حول الإنسان والموجهة بالأداء.

جرّب مُولِّد الفيديو بالذكاء الاصطناعي Seedance 2.0 على CometAPI

الخطوة 1: الخطوة 1: اشترك للحصول على مفتاح API

الخطوة 2: احصل على وصول API لـ Seedance 2.0 على CometAPI

الخطوة 3: أرسل أول طلب باستخدام Seedance 2.0 API

يوفّر هذا التدفق لك تجربة سريعة في الـ Playground وانتقالاً سلساً إلى الاستخدام الإنتاجي عبر CometAPI.

أهم الأسباب لاختيار Seedance 2.0 على CometAPI

لماذا تستخدم CometAPI مع Seedance 2.0

وصول مباشر عبر API أو Playground
تحكم سهل بالمعاملات (المدة، الدقة، الصيغة)
يدعم كلّاً من مسارات نص-إلى-فيديو وصورة-إلى-فيديو
معالجة مهام مدمجة لتوليد الفيديو غير المتزامن

واجهة API موحّدة وملائمة للمطورين

تسعير اقتصادي

اختبار سريع عبر Playground

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

التسعير

استخدم التقدير السريع أعلاه لعملية تشغيل واحدة، ثم راجع المقارنة الكاملة بين أسعار CometAPI والأسعار الرسمية.

اختبار 5 ثانية

$0.28

التكلفة التقديرية لاستخدام CometAPI

اختبار 10 ثانية

$0.56

التكلفة التقديرية لاستخدام CometAPI

اختبار 15 ثانية

$0.84

التكلفة التقديرية لاستخدام CometAPI

التسعير لـ Seedance 2-0

doubao-seedance Video Generation Pricing

Parameters

Parameter	Description
Duration (seconds)	4–15 seconds, default 5 seconds
size	Refer to documentation

*1080p is unavailable for doubao-seedance-2-0-fast and doubao-seedance-2-0-mini.

Pricing (Per Second)

Model	480p	720p	1080p	4k
`doubao-seedance-2-0`	$0.056	$0.1216	$0.2992	$0.624
`doubao-seedance-2-0-fast`	$0.0448	$0.096	—	—
`doubao-seedance-2-0-mini`	$0.032	$0.064	—	—
`doubao-seedance-1-5-pro`	$0.0192	$0.0416	$0.0928	—

💡 Billed per second. Total cost = price per second × video duration (seconds). Duration range: 4–15 seconds.

API

انسخ نقطة نهاية ونموذج كود يعملان، ثم افتح المرجع الكامل للواجهة عند الحاجة إلى جميع المعلمات.

واجهة برمجة تطبيقات واحدة، وصول للنماذج جاهز للإنتاج

POST/v1/videos

نموذج الكود وواجهة برمجة التطبيقات لـ Seedance 2-0

POST

/v1/videos

set -euo pipefail

# Get your CometAPI key from https://www.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"
OUTPUT_DIR="./output"
POLL_INTERVAL_SECONDS=10
RETRY_DELAY_SECONDS=5
MAX_CREATE_ATTEMPTS=5
MAX_QUERY_ATTEMPTS=3

is_progress_complete() {
  local progress="$1"
  local normalized="${progress%%%}"

  if [[ -z "$normalized" ]]; then
    return 1
  fi

  [[ "$normalized" =~ ^[0-9]+([.][0-9]+)?$ ]] || return 1
  awk -v value="$normalized" 'BEGIN { exit !(value >= 100) }'
}

create_task() {
  local attempt=1
  while (( attempt <= MAX_CREATE_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'
%{http_code}' "https://api.cometapi.com/v1/videos" \
      -H "Authorization: Bearer $COMETAPI_KEY" \
      -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
      -F 'model="doubao-seedance-2-0"' \
      -F 'seconds="5"' \
      -F 'size="16:9"')

    status_code=$(echo "$response" | tail -n 1)
    CREATE_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_CREATE_ATTEMPTS )); then
      echo "Create request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$CREATE_RESPONSE"
    return 1
  done
}

get_task() {
  local task_id="$1"
  local attempt=1
  while (( attempt <= MAX_QUERY_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'
%{http_code}' "https://api.cometapi.com/v1/videos/${task_id}" \
      -H "Authorization: Bearer $COMETAPI_KEY")

    status_code=$(echo "$response" | tail -n 1)
    TASK_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_QUERY_ATTEMPTS )); then
      echo "Status request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$TASK_RESPONSE"
    return 1
  done
}

create_task

TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id // .task_id // empty')

if [[ -z "$TASK_ID" ]]; then
  echo "$CREATE_RESPONSE" | jq .
  echo "No task id returned."
  exit 1
fi

echo "Task created: $TASK_ID"
echo "Initial status: $(echo "$CREATE_RESPONSE" | jq -r '.status // empty')"

while true; do
  get_task "$TASK_ID"

  STATUS=$(echo "$TASK_RESPONSE" | jq -r '.status // empty')
  NORMALIZED_STATUS=$(echo "$STATUS" | tr '[:upper:]' '[:lower:]')
  PROGRESS=$(echo "$TASK_RESPONSE" | jq -r '.progress // empty')
  SHOULD_TRY_DOWNLOAD=0

  if [[ "$NORMALIZED_STATUS" == "success" || "$NORMALIZED_STATUS" == "completed" ]]; then
    SHOULD_TRY_DOWNLOAD=1
  elif [[ "$NORMALIZED_STATUS" == "unknown" ]] && is_progress_complete "$PROGRESS"; then
    SHOULD_TRY_DOWNLOAD=1
  fi

  echo "Status: ${STATUS}, progress: ${PROGRESS}"

  if [[ "$SHOULD_TRY_DOWNLOAD" == "1" || "$NORMALIZED_STATUS" == "failed" || "$NORMALIZED_STATUS" == "error" ]]; then
    if [[ "$SHOULD_TRY_DOWNLOAD" == "1" ]]; then
      VIDEO_URL=$(echo "$TASK_RESPONSE" | jq -r '.video_url // empty')

      OUTPUT_PATH="${OUTPUT_DIR}/${TASK_ID}.mp4"

      mkdir -p "$OUTPUT_DIR"
      curl -fsS "https://api.cometapi.com/v1/videos/${TASK_ID}/content" \
        -H "Authorization: Bearer $COMETAPI_KEY" \
        -o "$OUTPUT_PATH"

      if [[ ! -s "$OUTPUT_PATH" ]]; then
        echo "Failed to download video"
        exit 1
      fi

      echo "Video URL: ${VIDEO_URL}"
      echo "Content endpoint: https://api.cometapi.com/v1/videos/${TASK_ID}/content"
      echo "Saved to ${OUTPUT_PATH}"
      echo "File size: $(wc -c < "$OUTPUT_PATH" | tr -d ' ') bytes"
    else
      echo "$TASK_RESPONSE" | jq .
      exit 1
    fi
    break
  fi

  sleep "$POLL_INTERVAL_SECONDS"
done

cURL Code Example

set -euo pipefail

# Get your CometAPI key from https://www.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"
OUTPUT_DIR="./output"
POLL_INTERVAL_SECONDS=10
RETRY_DELAY_SECONDS=5
MAX_CREATE_ATTEMPTS=5
MAX_QUERY_ATTEMPTS=3

is_progress_complete() {
  local progress="$1"
  local normalized="${progress%%%}"

  if [[ -z "$normalized" ]]; then
    return 1
  fi

  [[ "$normalized" =~ ^[0-9]+([.][0-9]+)?$ ]] || return 1
  awk -v value="$normalized" 'BEGIN { exit !(value >= 100) }'
}

create_task() {
  local attempt=1
  while (( attempt <= MAX_CREATE_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'\n%{http_code}' "https://api.cometapi.com/v1/videos" \
      -H "Authorization: Bearer $COMETAPI_KEY" \
      -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
      -F 'model="doubao-seedance-2-0"' \
      -F 'seconds="5"' \
      -F 'size="16:9"')

    status_code=$(echo "$response" | tail -n 1)
    CREATE_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_CREATE_ATTEMPTS )); then
      echo "Create request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$CREATE_RESPONSE"
    return 1
  done
}

get_task() {
  local task_id="$1"
  local attempt=1
  while (( attempt <= MAX_QUERY_ATTEMPTS )); do
    local response
    local status_code
    response=$(curl -sS -w $'\n%{http_code}' "https://api.cometapi.com/v1/videos/${task_id}" \
      -H "Authorization: Bearer $COMETAPI_KEY")

    status_code=$(echo "$response" | tail -n 1)
    TASK_RESPONSE=$(echo "$response" | sed '$d')

    if [[ "$status_code" =~ ^2 ]]; then
      return 0
    fi

    if [[ "$status_code" == "429" || "$status_code" =~ ^5 ]] && (( attempt < MAX_QUERY_ATTEMPTS )); then
      echo "Status request returned ${status_code}, retrying..."
      sleep "$RETRY_DELAY_SECONDS"
      (( attempt += 1 ))
      continue
    fi

    echo "$TASK_RESPONSE"
    return 1
  done
}

create_task

TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id // .task_id // empty')

if [[ -z "$TASK_ID" ]]; then
  echo "$CREATE_RESPONSE" | jq .
  echo "No task id returned."
  exit 1
fi

echo "Task created: $TASK_ID"
echo "Initial status: $(echo "$CREATE_RESPONSE" | jq -r '.status // empty')"

while true; do
  get_task "$TASK_ID"

  STATUS=$(echo "$TASK_RESPONSE" | jq -r '.status // empty')
  NORMALIZED_STATUS=$(echo "$STATUS" | tr '[:upper:]' '[:lower:]')
  PROGRESS=$(echo "$TASK_RESPONSE" | jq -r '.progress // empty')
  SHOULD_TRY_DOWNLOAD=0

  if [[ "$NORMALIZED_STATUS" == "success" || "$NORMALIZED_STATUS" == "completed" ]]; then
    SHOULD_TRY_DOWNLOAD=1
  elif [[ "$NORMALIZED_STATUS" == "unknown" ]] && is_progress_complete "$PROGRESS"; then
    SHOULD_TRY_DOWNLOAD=1
  fi

  echo "Status: ${STATUS}, progress: ${PROGRESS}"

  if [[ "$SHOULD_TRY_DOWNLOAD" == "1" || "$NORMALIZED_STATUS" == "failed" || "$NORMALIZED_STATUS" == "error" ]]; then
    if [[ "$SHOULD_TRY_DOWNLOAD" == "1" ]]; then
      VIDEO_URL=$(echo "$TASK_RESPONSE" | jq -r '.video_url // empty')

      OUTPUT_PATH="${OUTPUT_DIR}/${TASK_ID}.mp4"

      mkdir -p "$OUTPUT_DIR"
      curl -fsS "https://api.cometapi.com/v1/videos/${TASK_ID}/content" \
        -H "Authorization: Bearer $COMETAPI_KEY" \
        -o "$OUTPUT_PATH"

      if [[ ! -s "$OUTPUT_PATH" ]]; then
        echo "Failed to download video"
        exit 1
      fi

      echo "Video URL: ${VIDEO_URL}"
      echo "Content endpoint: https://api.cometapi.com/v1/videos/${TASK_ID}/content"
      echo "Saved to ${OUTPUT_PATH}"
      echo "File size: $(wc -c < "$OUTPUT_PATH" | tr -d ' ') bytes"
    else
      echo "$TASK_RESPONSE" | jq .
      exit 1
    fi
    break
  fi

  sleep "$POLL_INTERVAL_SECONDS"
done

Python Code Example

import json
import os
import time

import requests

# Get your CometAPI key from https://www.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com"
OUTPUT_DIR = "./output"
POLL_INTERVAL_SECONDS = 10
RETRY_DELAY_SECONDS = 5
MAX_CREATE_ATTEMPTS = 5
MAX_QUERY_ATTEMPTS = 3
TERMINAL_STATUSES = {"success", "completed", "failed", "error"}
SUCCESS_STATUSES = {"success", "completed"}


def is_progress_complete(progress):
    if isinstance(progress, int):
        return progress >= 100
    if isinstance(progress, float):
        return progress >= 100
    if isinstance(progress, str):
        try:
            return float(progress.rstrip("%")) >= 100
        except ValueError:
            return False
    return False


def is_transient_status(status_code):
    return status_code == 429 or 500 <= status_code < 600


def create_task(files):
    for attempt in range(1, MAX_CREATE_ATTEMPTS + 1):
        response = requests.post(
            f"{BASE_URL}/v1/videos",
            headers=headers,
            files=files,
            timeout=30,
        )
        if response.ok:
            return response
        if not is_transient_status(response.status_code) or attempt == MAX_CREATE_ATTEMPTS:
            response.raise_for_status()
        print(f"Create request returned {response.status_code}, retrying...")
        time.sleep(RETRY_DELAY_SECONDS)

    raise SystemExit("Failed to create task.")


def get_task(task_id):
    for attempt in range(1, MAX_QUERY_ATTEMPTS + 1):
        response = requests.get(
            f"{BASE_URL}/v1/videos/{task_id}",
            headers=headers,
            timeout=15,
        )
        if response.ok:
            return response
        if not is_transient_status(response.status_code) or attempt == MAX_QUERY_ATTEMPTS:
            response.raise_for_status()
        print(f"Status request returned {response.status_code}, retrying...")
        time.sleep(RETRY_DELAY_SECONDS)

    raise SystemExit("Failed to query task.")

if COMETAPI_KEY == "<YOUR_COMETAPI_KEY>":
    print("Set COMETAPI_KEY before running this example.")
    raise SystemExit(0)

headers = {"Authorization": f"Bearer {COMETAPI_KEY}"}

create_response = create_task(
    {
        "prompt": (None, "A slow cinematic camera push across a coastal landscape at sunrise."),
        "model": (None, "doubao-seedance-2-0"),
        "seconds": (None, "5"),
        "size": (None, "16:9"),
    }
)
create_response.raise_for_status()
create_result = create_response.json()

task_id = create_result.get("id") or create_result.get("task_id")
if not task_id:
    print(json.dumps(create_result, indent=2))
    raise SystemExit("No task id returned.")

print(f"Task created: {task_id}")
print(f"Initial status: {create_result.get('status')}")

while True:
    task_response = get_task(task_id)
    task_response.raise_for_status()
    task = task_response.json()
    status = str(task.get("status") or "unknown")
    normalized_status = status.lower()
    progress = task.get("progress")
    should_try_download = normalized_status in SUCCESS_STATUSES or (
        normalized_status == "unknown" and is_progress_complete(progress)
    )

    print(f"Status: {status}, progress: {progress}")

    if should_try_download or normalized_status in TERMINAL_STATUSES:
        if should_try_download:
            video_url = task.get("video_url") or ""
            content_url = f"{BASE_URL}/v1/videos/{task_id}/content"
            output_path = os.path.join(OUTPUT_DIR, f"{task_id}.mp4")

            os.makedirs(OUTPUT_DIR, exist_ok=True)
            with requests.get(
                content_url,
                headers=headers,
                timeout=120,
                stream=True,
            ) as video_response:
                video_response.raise_for_status()
                with open(output_path, "wb") as output_file:
                    for chunk in video_response.iter_content(chunk_size=8192):
                        if chunk:
                            output_file.write(chunk)

            print(f"Video URL: {video_url}")
            print(f"Content endpoint: {content_url}")
            print(f"Saved to {output_path}")
            print(f"File size: {os.path.getsize(output_path)} bytes")
        else:
            print(json.dumps(task, indent=2))
            raise SystemExit(1)
        break

    time.sleep(POLL_INTERVAL_SECONDS)

JavaScript Code Example

import fs from "fs";
import path from "path";

// Get your CometAPI key from https://www.cometapi.com/console/token, and paste it here
const api_key = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const base_url = "https://api.cometapi.com";
const output_dir = "./output";
const poll_interval_ms = 10_000;
const retry_delay_ms = 5_000;
const max_create_attempts = 5;
const max_query_attempts = 3;
const terminal_statuses = new Set(["success", "completed", "failed", "error"]);
const success_statuses = new Set(["success", "completed"]);

function is_progress_complete(progress) {
  if (typeof progress === "number") {
    return progress >= 100;
  }

  if (typeof progress === "string") {
    const numeric = Number(progress.replace(/%$/, ""));
    return Number.isFinite(numeric) && numeric >= 100;
  }

  return false;
}

function is_transient_status(status) {
  return status === 429 || status >= 500;
}

async function fetch_with_retry(url, options, attempts, label) {
  for (let attempt = 1; attempt <= attempts; attempt += 1) {
    const response = await fetch(url, options);
    if (response.ok) {
      return response;
    }

    if (!is_transient_status(response.status) || attempt === attempts) {
      return response;
    }

    console.log(`${label} returned ${response.status}, retrying...`);
    await new Promise((resolve) => setTimeout(resolve, retry_delay_ms));
  }

  throw new Error(`${label} failed`);
}

if (api_key === "<YOUR_COMETAPI_KEY>") {
  console.log("Set COMETAPI_KEY before running this example.");
  process.exit(0);
}

const headers = {
  Authorization: `Bearer ${api_key}`,
};

const form = new FormData();
form.set("prompt", "A slow cinematic camera push across a coastal landscape at sunrise.");
form.set("model", "doubao-seedance-2-0");
form.set("seconds", "5");
form.set("size", "16:9");

const create_response = await fetch_with_retry(`${base_url}/v1/videos`, {
  method: "POST",
  headers,
  body: form,
}, max_create_attempts, "Create request");

if (!create_response.ok) {
  console.log(await create_response.text());
  process.exit(1);
}

const create_result = await create_response.json();
const task_id = create_result.id || create_result.task_id;

if (!task_id) {
  console.log(JSON.stringify(create_result, null, 2));
  process.exit(1);
}

console.log(`Task created: ${task_id}`);
console.log(`Initial status: ${create_result.status}`);

while (true) {
  const task_response = await fetch_with_retry(`${base_url}/v1/videos/${task_id}`, {
    headers,
  }, max_query_attempts, "Status request");

  if (!task_response.ok) {
    console.log(await task_response.text());
    process.exit(1);
  }

  const task = await task_response.json();
  const status = String(task.status || "unknown");
  const normalized_status = status.toLowerCase();
  const progress = task.progress;
  const should_try_download = success_statuses.has(normalized_status) || (
    normalized_status === "unknown" && is_progress_complete(progress)
  );

  console.log(`Status: ${status}, progress: ${progress}`);

  if (should_try_download || terminal_statuses.has(normalized_status)) {
    if (should_try_download) {
      const video_url = task.video_url || "";
      const content_url = `${base_url}/v1/videos/${task_id}/content`;
      const output_path = path.join(output_dir, `${task_id}.mp4`);

      if (!fs.existsSync(output_dir)) {
        fs.mkdirSync(output_dir, { recursive: true });
      }

      const video_response = await fetch(content_url, { headers });
      if (!video_response.ok) {
        console.log(await video_response.text());
        process.exit(1);
      }

      const video_buffer = Buffer.from(await video_response.arrayBuffer());
      fs.writeFileSync(output_path, video_buffer);

      console.log(`Video URL: ${video_url}`);
      console.log(`Content endpoint: ${content_url}`);
      console.log(`Saved to ${output_path}`);
      console.log(`File size: ${fs.statSync(output_path).size} bytes`);
    } else {
      console.log(JSON.stringify(task, null, 2));
      process.exit(1);
    }
    break;
  }

  await new Promise((resolve) => setTimeout(resolve, poll_interval_ms));
}