ByteDance: Seedance 1.5 Pro
يولّد Seedance 1.5 Pro فيديو من نص أو صورة، ويمكنه إنشاء أصوات ومؤثرات وموسيقى خلفية متزامنة. يمكن تفعيل الصوت أو تعطيله؛ ويتيح الإصدار الموثّق مشاهد بطول 4–12 ثانية وتأطيرًا adaptive ومعالجة عبر الإنترنت أو flex.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
يولّد Seedance 1.5 Pro فيديو من نص أو صورة، ويمكنه توليد الصوت مع الصورة. معرّف الاختيار الدقيق هو doubao-seedance-1-5-pro-251215. يميّزه عنصر التحكم في الصوت عن إصدارات Seedance 1.0 الصامتة: يطلب generate_audio=true صوتًا متزامنًا، بينما يطلب false فيديو صامتًا. استخدم مشهدًا مكتوبًا لتصور جديد، أو صورة لتحديد الموضوع والتكوين الافتتاحيين.
صف الفعل البصري والصوت جزأين من المشهد نفسه. حدّد الموضوع والمكان والحركة والكاميرا، ثم اشرح الأصوات أو المؤثرات الصوتية أو موسيقى الخلفية المقصودة. قد يعرض مشهد لشخصية شخصًا يفتح عينيه بينما تتراجع الكاميرا ببطء، مع رياح في المحيط. ولمشهد منتج، اربط الصوت بالحدث الظاهر، مثل فتح غطاء أو ملامسة شيء لسطح، بدل إضافة قائمة مؤثرات غير مرتبطة.
يستطيع النموذج توليد أصوات ومؤثرات وموسيقى خلفية من الموجّه والمحتوى البصري. يوصي الدليل بوضع الحوار المنطوق داخل علامتي اقتباس مزدوجتين. اجعل الكلام قصيرًا بما يكفي للفعل والتوقفات المطلوبة، وميّز المتحدث عندما تكون عدة شخصيات حاضرة. راجع الكلمات الفعلية وإسناد الأصوات والتزامن مع الصورة. توجّه تعليمة الصوت الأداء المولّد؛ وهي ليست مدخلًا منفصلًا لمرجع صوتي مرفوع ضمن الطلب الموثّق لهذا الإصدار.
يستخدم تحويل الصورة إلى فيديو عنصر image_url إلى جانب النص. قدّم رابط صورة URL متاحًا أو data URL بصيغة Base64 في تنسيق JPEG أو PNG أو WEBP أو BMP أو TIFF أو GIF. حدود الصور الموثّقة أقل من 30 MB، وكلا البعدين حصرًا بين 300 و6000 بكسل، ونسبة العرض إلى الارتفاع حصرًا بين 0.4 و2.5. جهّز الاقتصاص والموضوع المقصودين بوضوح، ثم صف الحركة انطلاقًا من ذلك التكوين. يستخدم مثال الصورة نسبة adaptive لاتباع المرجع.
يذكر دليل المدة الخاص بالإصدار أعدادًا صحيحة من الثواني من أربع إلى اثنتي عشرة، أو -1 ليختار النموذج مدة ضمن ذلك النطاق. المدة الافتراضية خمس ثوانٍ. الدقة الافتراضية لـSeedance 1.5 Pro هي 720p، ويوثّق جدول الإصدار المحتفَظ به 480p و720p؛ ولا يتيح دليل العملية المخصص 1080p لـ1.5 Pro. تشمل خيارات النسبة الثابتة 16:9 و4:3 و1:1 و3:4 و9:16 و21:9، مع adaptive قيمة افتراضية موثّقة لـ1.5. افحص مدة المقطع الفعلي ونسبه بدل اعتبار القيم المطلوبة مخرجًا أُعيد بالفعل.
يتيح الطلب مستويين للمعالجة. يختار service_tier=default المعالجة عبر الإنترنت، بينما يختار flex المعالجة غير المتصلة للأعمال التي تتحمل تأخيرًا أطول. لا يمكن تغيير المستوى بعد إرسال المهمة. اختره وفق احتياجات توقيت سير العمل، واحتفظ بذلك الاختيار في سجل الطلب. نمط الصوت ومستوى المعالجة خياران منفصلان: المقطع الصامت ليس تلقائيًا مهمة غير متصلة، وتفعيل الصوت لا يختار مستوى معالجة.
اجعل تعليمات seed والعلامة المائية والكاميرا متسقة مع المشهد. تتقدم أوامر المعاملات المضمّنة في النص على المعاملات الاختيارية المنفصلة. يُستبعد عنصر تثبيت الكاميرا في سيناريو الصورة المرجعية، ولا يضمن تثبيتًا بصريًا حيث ينطبق. ولتحريك صورة، اشرح الحركة المقصودة مباشرةً بدل افتراض أن عنصر تحكم في الكاميرا يلغي الحاجة إلى وصف اللقطة.
يُقاس الاستخدام برموز الفيديو: عرض الفيديو الناتج × ارتفاع الفيديو الناتج × معدل الإطارات × مدة الفيديو الناتج / 1024. تُبلغ المهمة المكتملة عن هذه الكمية في usage.completion_tokens. احتفظ بالاستخدام المبلّغ عنه مع المقطع النهائي وإعداداته المطلوبة. تظل حالتا تفعيل الصوت وتعطيله والمعالجة عبر الإنترنت أو flex فئات متميزة في الرسوم القائمة على الاستخدام.
يُرجع الإرسال معرّف مهمة غير متزامنة. تابع المهمة حتى الإتمام، ثم احفظ الفيديو المقدّم في content.video_url. مدة الاحتفاظ الموثّقة بالملفات المولّدة سبعة أيام. يُقاس عنصر انتهاء الصلاحية من الإنشاء، وقيمته الافتراضية 172800 ثانية ويقبل قيمًا من 3600 إلى 259200 ثانية؛ وتصبح المهمة غير المكتملة منتهية الصلاحية بعد المهلة المهيأة لها. احتفظ بالمقطع النهائي والصورة الأصلية والموجز البصري والصوتي الدقيق معًا، ثم راجع النتيجة كاملة من حيث الفعل والهوية واستمرارية الكاميرا ومحاذاة الصوت.
Ailoot Ultra · فيديو POST /v1/videos doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215البداية
يولّد Seedance 1.5 Pro فيديو من نص أو صورة، ويمكنه إنشاء أصوات ومؤثرات وموسيقى خلفية متزامنة. يمكن تفعيل الصوت أو تعطيله؛ ويتيح الإصدار الموثّق مشاهد بطول 4–12 ثانية وتأطيرًا adaptive ومعالجة عبر الإنترنت أو flex.
- المدخلات المقبولة
- النص · الصور
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image- الإخراج
video
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود doubao-seedance-1-5-pro-251215 | القيمة الافتراضية— |
الحقلcontent | النوعarray | المتطلبمطلوب | القيم والحدود الشروط: كائنات نصية أو وسائط بصيغتها الأصلية؛ يجب ألا تكون المصفوفة الخارجية فارغة. لا يتحقق مُنشئ الطلبات العام هذا في Ailoot من أنواع العُقد المتداخلة. | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود الشروط: المخطط الأساسي للإصدار 1.x يحدد 2–12؛ ويصف نص مشترك لاحق الإصدار 1.5 بأنه 4–12 أو -1. يستخدم المثال القيمة 5 الموثّقة في الموضعين. | القيمة الافتراضية5 |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480p, 720p الشروط: يدعم Seedance 1.5 Pro الدقتين 480p و720p؛ وتُستبعد 1080p. الدقة الافتراضية الموثّقة هي 720p. | القيمة الافتراضية720p |
الحقلratio | النوعstring | المتطلباختياري | القيم والحدود 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive الشروط: نسبة الأبعاد الافتراضية الموثّقة في Seedance 1.5 Pro هي adaptive. تبقى خيارات نسب الأبعاد الثابتة كما هي. | القيمة الافتراضيةadaptive |
الحقلservice_tier | النوعstring | المتطلباختياري | القيم والحدود default, flex الشروط: default=online، flex=offline؛ اختر قبل الإنشاء. | القيمة الافتراضيةdefault |
الحقلseed | النوعinteger | المتطلبمطلوب | القيم والحدود الحد الأدنى: -1 الحد الأقصى: 4,294,967,295 | القيمة الافتراضية-1 |
الحقلcamerafixed | النوعboolean | المتطلبمطلوب | القيم والحدود الشروط: مطلوب من Ailoot؛ يوضح التوثيق أن التحكم بالكاميرا باستخدام صورة مرجعية غير مدعوم، ولا يُضمن تأثيره. | القيمة الافتراضيةfalse |
الحقلwatermark | النوعboolean | المتطلبمطلوب | القيم والحدود | القيمة الافتراضيةfalse |
الحقلexecution_expires_after | النوعinteger | المتطلبمطلوب | القيم والحدود الحد الأدنى: 3,600 الحد الأقصى: 259,200 الوحدة: ثوانٍ | القيمة الافتراضية172,800 |
الحقلgenerate_audio | النوعboolean | المتطلباختياري | القيم والحدود الشروط: صوت متزامن مضمّن في الفيديو المولَّد، خاص بـ1.5 فقط. | القيمة الافتراضيةtrue |
تركيبات مواد الإدخال
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتcamerafixed, content, execution_expires_after, model, seed, watermark |
المعلمةoptional | المواصفاتduration, resolution, ratio, service_tier, generate_audio |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةadditional_properties | المواصفاتtrue |
المعلمةvalidation_scope | المواصفاتتتحقق Ailoot من أنواع الحقول المطلوبة ومن أن قيمة model ومصفوفة content غير فارغتين. تُحفظ حقول الطلب الأخرى للنموذج المختار. |
المعلمةimage_constraints | المواصفات{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":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 من الرموز |
| الإعداداتمستوى خدمة للمعالجة غير المتصلة (flex). مخرجات بصوت مولّد متزامن. | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوتمع صوت | فئة الخدمةflex | وحدة الفوترةلكل 1K من رموز الفيديو | الرسوم الإخراج · تقدير للمقارنة فقط $0.0024 لكل 1K من رموز الفيديو |
| الإعداداتمستوى خدمة للمعالجة غير المتصلة (flex). مخرجات دون صوت مولّد متزامن. | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوتمن دون صوت | فئة الخدمةflex | وحدة الفوترةلكل 1K من رموز الفيديو | الرسوم الإخراج · تقدير للمقارنة فقط $0.0012 لكل 1K من رموز الفيديو |
| الإعداداتمستوى خدمة للمعالجة المتصلة (default). مخرجات بصوت مولّد متزامن. | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوتمع صوت | فئة الخدمةdefault | وحدة الفوترةلكل 1K من رموز الفيديو | الرسوم الإخراج · تقدير للمقارنة فقط $0.0048 لكل 1K من رموز الفيديو |
| الإعداداتمستوى خدمة للمعالجة المتصلة (default). مخرجات دون صوت مولّد متزامن. | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوتمن دون صوت | فئة الخدمةdefault | وحدة الفوترةلكل 1K من رموز الفيديو | الرسوم الإخراج · تقدير للمقارنة فقط $0.0024 لكل 1K من رموز الفيديو |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | إنشاء الصوت— | فئة الخدمة— | وحدة الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.1152 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}
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}/contentGET /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-1-5-pro-251215
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · ByteDance: Seedance 1.5 Pro
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·doubao-seedance-1-5-pro-251215:text,image→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·doubao-seedance-1-5-pro-251215:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after,generate_audio- ما الحدود المطبقة؟
POST /v1/videos·doubao-seedance-1-5-pro-251215:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200