ByteDance: Seedance 1.0 Pro Fast

Seedance 1.0 Pro Fast הוא פרופיל Fast בעל שם נפרד ליצירת וידאו ללא קול מטקסט ומתמונה. הוא מקבל הנחיות לסצנה או קומפוזיציה המונחית בתמונה, עם פלט של 2–12 שניות, 24 fps ובקרות מסגור מפורשות.

Ailoot Ultra · וידאו POST /v1/videos doubao-seedance-1-0-pro-fast-251015

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

Seedance 1.0 Pro Fast הוא פרופיל Fast המזוהה באמצעות doubao-seedance-1-0-pro-fast-251015. הוא יוצר וידאו ללא קול מסצנה כתובה או מקומפוזיציית פתיחה המונחית באמצעות תמונה. המזהה המדויק מבדיל בין הפרופיל הזה לבין Seedance 1.0 Pro; המילה Fast אינה מגדירה זמן השלמה מובטח למשימה מסוימת. בחרו את מצב הקלט לפי מה שצריך לבסס את הסצנה, ואז העריכו את הקליפ שהוחזר מול ההנחיות האלה.

שוט המובל בטקסט מתחיל ברצף תמציתי: נושא הצילום והסביבה, הפעולה, מסלול המצלמה והמבט הסופי. לחשיפת מוצר, תארו את האובייקט על המשטח שלו, את האור על החומר ותנועה קצרה המסתיימת במאפיין המוצג. לרעיון למיקום, עברו ממבט רחב המבסס את הסביבה לנקודת מוקד מזוהה. הימנעו מבקשה מקליפ קצר אחד לבצע כמה סצנות לא קשורות שצריך להציג בהן את כל הנושאים והסביבות מהתחלה.

שוט המובל בתמונה מתחיל בפריט image_url במערך content ובהוראת טקסט לתנועה. הכינו בתמונה הזאת את החיתוך, הרקע וסידור נושא הצילום, ואז ציינו אילו רכיבים נעים וכיצד המצלמה מתנהגת. כך קומפוזיציה דוממת יכולה להפוך לסצנה מונפשת קצרה. הדבר מועיל לדיוקן, לאובייקט על שולחן או לרעיון חזותי שהוכן מראש, אך עדיין צריך לבדוק בתוצאה בפועל את הזהות, הצורה והתנועה לאורך הקליפ.

קלט תמונה יכול להשתמש בכתובת URL נגישה או ב-data URL ב-Base64. הפורמטים המתועדים הם JPEG, PNG, WEBP, BMP, TIFF ו-GIF; התמונה צריכה להיות קטנה מ-30 MB, כששני הממדים נמצאים ממש בין 300 ל-6000 פיקסלים ויחס הרוחב חלקי הגובה ממש בין 0.4 ל-2.5, ללא ערכי הגבול. בחרו מקור נקי עם פרטים גלויים של נושא הצילום. מדריך התמונות ממליץ על מסגור adaptive, ולכן יחסי הממדים של המקור שהוכן צריכים להתאים לקומפוזיציה שברצונכם להנפיש.

פרופיל 1.0 מתעד משך של שתיים עד שתים עשרה שניות ב-24 fps. רזולוציית ברירת המחדל של Pro Fast היא 1080p, וטבלת הפלט שנשמרה מונה את הרמות 480p, 720p ו-1080p. מדריך הפעולה שולל 1080p בתרחיש תמונת הייחוס. יחסי הממדים הקבועים כוללים 16:9, 4:3, 1:1, 3:4, 9:16 ו-21:9. בחרו רזולוציה וצורה המתאימות למצב הקלט שנבחר, במקום להניח שכל שילוב ניתן להחלפה באחר.

אפשרויות seed וסימן מים עוזרות לשמור את הגדרות הבקשה מפורשות. טווח ה-seed במספרים שלמים הוא -1 עד 2^32-1; הערך -1 מבקש אקראיות. הוראה למצלמה קבועה היא מותנית: המדריך שולל אותה בתרחיש תמונת ייחוס ואינו מבטיח את ההשפעה החזותית במקום שבו היא נתמכת. פקודות פרמטרים המוטמעות בטקסט דורסות פרמטרים אופציונליים נפרדים. שמרו על התאמה בין ההוראות האלה, במיוחד בעת תיקון פרומפט שפקודה ישנה למשך או לרזולוציה עלולה להישאר בתיאור הסצנה שלו.

השימוש נמדד בטוקני וידאו: רוחב הפלט × גובה הפלט × קצב הפריימים × משך הפלט / 1024. המשימה שהושלמה מדווחת על הכמות הזאת ב-usage.completion_tokens. שמרו את השימוש שדווח עם הקליפ המוגמר וההגדרות שהתבקשו עבורו.

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

Ailoot Ultra · וידאו POST /v1/videos doubao-seedance-1-0-pro-fast-251015

doubao-seedance-1-0-pro-fast-251015

ByteDance /doubao-seedance-1-0-pro-fast-251015

התחלה

סוגי קלט נתמכים: טקסט · תמונות
תוצאות: וידאו

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · וידאו POST /v1/videos

סוגי קלט: text, image
סוגי פלט: video

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות doubao-seedance-1-0-pro-fast-251015	ברירת מחדל—
שדה`content`	סוג`array`	דרישהחובה	ערכים ומגבלות תנאים: אובייקטי טקסט ומדיה בפורמט המקורי; המערך החיצוני חייב להיות לא ריק. הבנאי הכללי הזה של Ailoot אינו מאמת את הטיפוסים של הצמתים המקוננים.	ברירת מחדל—
שדה`duration`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦2⁩ מקסימום: ⁦12⁩ תנאים: הסכמה הראשית של 1.x מציינת 2–12; תיאור משותף מאוחר יותר מציין עבור 1.5 את הטווח 4–12 או -1. הדוגמה משתמשת ב־5, המתועד בשניהם.	ברירת מחדל⁦5⁩
שדה`resolution`	סוג`string`	דרישהרשות	ערכים ומגבלות תנאים: הערכים המאושרים ליצירת וידאו מטקסט הם 480p ו־1080p. קלט של תמונת עזר אינו מאפשר 1080p. ערך ה־enum המשותף 720p סותר את התיאור הייחודי למודל, ולכן התמיכה ב־720p נותרת בלתי מוכרעת בשני המצבים.	ברירת מחדל1080p
שדה`ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 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⁩

שילובים של חומרי קלט

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטcamerafixed, content, execution_expires_after, model, seed, watermark
פרמטר`optional`	מפרטduration, resolution, ratio, service_tier
פרמטר`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: לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי: לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורה	טבלת תעריפים	כמות חזויה	יחידת חיוב	חיוב
תצורהתעריפי בסיס לטוקנים	טבלת תעריפיםתעריף בסיס	כמות חזויה—	יחידת חיוב—	חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהUltra	טבלת תעריפים—	כמות חזויה—	יחידת חיובלכל 1K טוקני וידאו	חיוב פלט · אומדן להשוואה בלבד $0.0012 לכל 1K טוקני וידאו
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.0576 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · וידאו

curl · צרו סרטוןcurl · קראו את המשימה המקוריתcurl · הורידו את הסרטון שבבעלותכם

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
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-1-0-pro-fast-251015

כינויים לנתיבי שיטות

/v1/videos/generations

מזהי מודלים קשורים IDs

doubao-seedance-1-0-pro-fast-251015

FAQ · ByteDance: Seedance 1.0 Pro Fast

אילו קלטים ותוצאות זמינים?: POST /v1/videos · doubao-seedance-1-0-pro-fast-251015: text, image → video
באילו שדות הבקשה משתמשת?: POST /v1/videos · doubao-seedance-1-0-pro-fast-251015: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
אילו מגבלות חלות?: POST /v1/videos · doubao-seedance-1-0-pro-fast-251015: duration.minimum: 2; duration.maximum: 12; seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 1.0 Pro Fast