ByteDance: Seedance 2.0 Fast

Seedance 2.0 Fast هو إصدار Fast متعدد الوسائط لتوليد الفيديو وتحريره وتمديده. يقبل مراجع نصية وصورًا ومراجع فيديو وصوت، ويدعم مخرجات متزامنة الصوت أو صامتة، ويوثّق مقاطع بطول 4–15 ثانية بدقة 480p أو 720p.

Ailoot Ultra · فيديو POST /v1/videos doubao-seedance-2-0-fast-260128

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Seedance 2.0 Fast هو إصدار Fast المسمّى منفصلًا، ويُختار باستخدام doubao-seedance-2-0-fast-260128. يدعم توليد الفيديو وتحريره وتمديده باستخدام النصوص والصور ومراجع الفيديو والصوت. يكون الإصدار مفيدًا عندما يحتاج موجز المشهد إلى أكثر من وصف المظهر: يمكن للوسائط الموجودة أيضًا توصيل الأداء واللغة السينمائية للكاميرا والصوت. يميّز اسم Fast هوية الطلب؛ وليس وعدًا بأن مهمة غير متزامنة بعينها تكتمل خلال وقت ثابت.

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

اجعل أدوار المراجع صريحة في مصفوفة content وفي الموجز. يمكن لعناصر image_url وvideo_url وaudio_url أن تحمل أدوار reference_image وreference_video وreference_audio. صف الصورة التي توفر الموضوع، والفيديو الذي يوفر الكاميرا أو الفعل، والصوت الذي يوفر المسار الصوتي. في لقطة منتج، قد تحدد صورة العبوة، بينما يوضح فيديو حركة تمر بجانب الشيء. حدّد النهاية المطلوبة لكي يكون للتسلسل القصير منظر ختامي مفيد بدل التوقف في منتصف فعل.

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

نطاق 2.0 Fast الموثّق من أربع إلى خمس عشرة ثانية كاملة، مع إتاحة -1 ليختار النموذج مدة ضمن ذلك النطاق. المدة الافتراضية خمس ثوانٍ. دقة المخرجات 480p أو 720p، مع 720p افتراضيًا واستبعاد 1080p. اختر بين الأشكال الثابتة 16:9 و4:3 و1:1 و3:4 و9:16 و21:9، أو التأطير adaptive. يتبع التأطير adaptive سياق الموجّه أو المرجع ذي الصلة؛ وتتبع لقطة الإطار الأول صورتها الافتتاحية، بينما قد يعطي التأطير متعدد الوسائط أولوية للفيديو على الصور. اقرأ حقول المهمة المعادة لمعرفة المدة والنسبة الفعليتين.

استخدم generate_audio لاختيار ما إذا كان الفيديو المولّد يتضمن صوتًا متزامنًا. القيمة الافتراضية الموثّقة true؛ ويطلب false الصمت. عند تفعيل الصوت، يولّد الإصدار أصواتًا أو مؤثرات أو موسيقى خلفية من الموجّه والمحتوى البصري، ويوصي الدليل بإحاطة الحوار بعلامتي اقتباس مزدوجتين. حدّد المتحدث والعلاقة المقصودة بين الصوت والفعل. راجع الكلام مع مستمع متمكن من اللغة، وتحقّق من محاذاة الصوت طوال المقطع، بما في ذلك أي جزء محرر أو ممدد.

يستبعد دليل 2.0 Fast عنصري التحكم الأقدم frames وcamera_fixed ولا يدعم معالجة flex غير المتصلة. صف سلوك الكاميرا ضمن المشهد واستخدم duration لطول المقطع. تظل خيارات seed والعلامة المائية موثّقة. لا تضمن قيمة seed نفسها مخرجات متطابقة، لذا احتفظ بالمخرج المكتمل عند مقارنة المراجعات بدل الاعتماد فقط على إعدادات الطلب.

يُحسب استخدام رموز الفيديو وفق الصيغة: (مدة فيديو الإدخال + مدة الفيديو الناتج) × عرض الفيديو الناتج × ارتفاع الفيديو الناتج × معدل إطارات الفيديو الناتج / 1024. للطلبات التي تتضمن فيديو إدخال وتلك التي لا تتضمنه فئات فوترة متميزة. يُبلغ الاستعلام عن المهمة عن usage.completion_tokens وusage.total_tokens؛ احتفظ بهذه الكميات المبلّغ عنها مع المقطع المكتمل.

يُرجع الإرسال معرّف مهمة قبل إتاحة الفيديو المكتمل. تابع حالة المعالجة، ثم استرجع content.video_url بعد النجاح، واحتفظ بالمدة والدقة والنسبة ومعدل الإطارات والاستخدام المبلّغ عنها مع النتيجة. تُقاس مهلة انتهاء الصلاحية من إنشاء المهمة، وقيمتها الافتراضية 172800 ثانية وتتراوح من 3600 إلى 259200 ثانية. احفظ المقطع النهائي مع مراجعه وموجّهه، ثم تحقّق من هوية الموضوع وتلامس الأشياء واستمرارية الكاميرا وتوقيت الصوت عبر التسلسل كاملًا.

Ailoot Ultra · فيديو POST /v1/videos doubao-seedance-2-0-fast-260128

doubao-seedance-2-0-fast-260128

ByteDance /doubao-seedance-2-0-fast-260128

البداية

المدخلات المقبولة: النص · الصور · فيديو · الصوت
النتائج: فيديو

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · فيديو POST /v1/videos

الإدخال: text, image, video, audio
الإخراج: video

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود doubao-seedance-2-0-fast-260128	القيمة الافتراضية—
الحقل`content`	النوع`array`	المتطلبمطلوب	القيم والحدود الشروط: كائنات نصية أو وسائط بصيغتها الأصلية؛ يجب ألا تكون المصفوفة الخارجية فارغة. لا يتحقق مُنشئ الطلبات العام هذا في Ailoot من أنواع العُقد المتداخلة.	القيمة الافتراضية—
الحقل`generate_audio`	النوع`boolean`	المتطلباختياري	القيم والحدود الشروط: صوت متزامن مضمّن في الفيديو.	القيمة الافتراضيةtrue
الحقل`duration`	النوع`integer`	المتطلباختياري	القيم والحدود الشروط: عدد صحيح 4–15 أو -1؛ تُعاد مدة المخرجات الفعلية.	القيمة الافتراضية⁦5⁩
الحقل`resolution`	النوع`string`	المتطلباختياري	القيم والحدود 480p, 720p الشروط: يُنصّ صراحةً على عدم دعم دقة 1080p في 2.0/fast.	القيمة الافتراضية720p
الحقل`ratio`	النوع`string`	المتطلباختياري	القيم والحدود 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive الشروط: يقتصر نطاق adaptive صراحةً على 2.0/fast/1.5؛ ويستخدم مثال 2.5 نسبة 16:9 فقط.	القيمة الافتراضيةadaptive
الحقل`watermark`	النوع`boolean`	المتطلباختياري	القيم والحدود	القيمة الافتراضيةfalse
الحقل`seed`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦‎-1⁩ الحد الأقصى: ⁦4,294,967,295⁩	القيمة الافتراضية⁦‎-1⁩
الحقل`execution_expires_after`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦3,600⁩ الحد الأقصى: ⁦259,200⁩ الوحدة: ثوانٍ	القيمة الافتراضية⁦172,800⁩
الحقل`service_tier`	النوع`string`	المتطلباختياري	القيم والحدود default الشروط: يستبعد 2.0/fast نمط flex غير المتصل؛ ولم يُحدَّد نطاق 2.5.	القيمة الافتراضيةdefault
الحقل`safety_identifier`	النوع`string`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—
الحقل`tools`	النوع`object`	المتطلباختياري	القيم والحدود الشروط: خاص بـ2.0/fast فقط؛ والقيمة الموثّقة هي type=web_search.	القيمة الافتراضية—

تركيبات مواد الإدخال

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتcontent, model
المعلمة`optional`	المواصفاتgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier, tools
المعلمة`material_types`	المواصفاتtext, image, video, audio
المعلمة`additional_properties`	المواصفاتtrue
المعلمة`validation_scope`	المواصفاتتتحقق Ailoot من أنواع الحقول المطلوبة ومن أن قيمة model ومصفوفة content غير فارغتين. تُحفظ حقول الطلب الأخرى للنموذج المختار.
المعلمة`material_combinations`	المواصفاتtext, image, video, image, audio, image, video, video, audio, image, video, audio
المعلمة`optional_text_with_media`	المواصفاتtrue
المعلمة`reference_media_count_and_size_limits`	المواصفاتnull

الأسماء البديلة للطريقة: /v1/videos/generations

دورة الحياة: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

أنشئ مرة واحدة واحتفظ بالقيم المُعادة للحقلين العامين id/polling_url.

استعلم دورياً عن المهمة الأصلية؛ ونزّل المحتوى الفعلي المملوك لك في content.video_url بعد succeeded.

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	الكمية المتوقعة	وحدة الفوترة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	وحدة الفوترة—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتتتضمن المدخلات فيديو مرجعيًا.	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل 1K من رموز الفيديو	الرسوم الإخراج · تقدير للمقارنة فقط $0.007536 لكل 1K من رموز الفيديو
الإعداداتلا تتضمن المدخلات فيديو مرجعيًا.	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل 1K من رموز الفيديو	الرسوم الإخراج · تقدير للمقارنة فقط $0.013032 لكل 1K من رموز الفيديو
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.822402 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · فيديو

curl · أنشئ فيديوcurl · اقرأ المهمة الأصليةcurl · نزّل الفيديو الذي تملكه

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-2-0-fast-260128","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}]}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
    if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
    p=urlsplit(u)
    if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
  index=$((index + 1))
done < asset-urls.txt

استلام النتائج وحفظها

Ailoot Ultra · فيديو

JSON أصلي يتضمن id/polling_url عامين. بعد النشر، يحتوي content.video_url على عنوان URL موقّع أو أكثر تابع لـAiloot؛ وقبل النشر تُفرَّغ عناوين URL للمخرجات المختارة.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

الاحتفاظ بكل النتائج المكتملة

احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.

احتفظ بكل عنوان URL فعلي في content.video_url؛ ويجب أن يحدد index مخرجاً فعلياً مُعاداً.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بالاستجابة والترويسات والمعرّف الأصلية، واستعلم دورياً عن تلك العملية؛ ولا تعِد إرسال طلب إنشاء مجهول النتيجة مطلقاً.

حقول الاستجابة

الحقل	النوع
الحقل`id`	النوعstring
الحقل`provider_task_id`	النوعstring
الحقل`polling_url`	النوعstring
الحقل`status`	النوعstring when supplied
الحقل`content.video_url`	النوعstring\|string[]
الحقل`usage`	النوعobject when supplied

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطJSON أو النموذج أو أنواع الحقول المطلوبة أو فهرس المحتوى غير صالحة.	الخطوة التالية
الاستجابة⁦401⁩ · `authentication_error`	الشرطمفتاح API الخاص بـAiloot غير صالح.	الخطوة التالية
الاستجابة⁦404⁩ · `not_found_error`	الشرطالمهمة أو المخرج غير موجود، أو غير مملوك للمستخدم ومفتاح API والمجموعة نفسها.	الخطوة التالية
الاستجابة⁦502⁩ · `result_pending_check`	الشرطالإرسال الأصلي أو حالته غير مكتملين؛ احتفظ بالمعرّف الأصلي ولا تعِد الإرسال.	الخطوة التالية
الاستجابة⁦503⁩ · `result_pending_check`	الشرطالوسائط أو المسار أو التسوية الأصلية قيد التحقق؛ تابع العملية الأصلية.	الخطوة التالية

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra doubao-seedance-2-0-fast-260128

الأسماء البديلة لمسارات الطرائق

/v1/videos/generations

معرّفات النماذج ذات الصلة IDs

doubao-seedance-2-0-fast-260128

FAQ · ByteDance: Seedance 2.0 Fast

ما المدخلات والنتائج المتاحة؟: POST /v1/videos · doubao-seedance-2-0-fast-260128: text, image, video, audio → video
ما الحقول التي يستخدمها الطلب؟: POST /v1/videos · doubao-seedance-2-0-fast-260128: model, content, generate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier, tools
ما الحدود المطبقة؟: POST /v1/videos · doubao-seedance-2-0-fast-260128: seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 2.0 Fast