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 תנאים: התאמה אוטומטית מתועדת במפורש עבור 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: לא צוין כאשר נבחר מצב 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; האינדקס חייב לזהות פלט ממשי שהוחזר.

כשצריך לבדוק את התגובה המקורית

יש לשמור את התגובה המקורית, הכותרות והמזהה ולבדוק במחזוריות את הפעולה הזו; אין לשלוח שוב בקשת יצירה שמצבה אינו ידוע.

שדות התגובה

שדה	סוג
שדה`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/model, טיפוסים של שדות חובה או אינדקס תוכן לא תקפים.	השלב הבא
תגובה⁦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