ByteDance: Seedance 1.0 Pro

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

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

על המודל

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

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

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

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

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

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

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

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

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

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

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות doubao-seedance-1-0-pro-250528	ברירת מחדל—
שדה`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.0044 לכל 1K טוקני וידאו
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.2112 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה 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-250528","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-250528

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

/v1/videos/generations

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

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

אילו קלטים ותוצאות זמינים?: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
באילו שדות הבקשה משתמשת?: POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
אילו מגבלות חלות?: POST /v1/videos · doubao-seedance-1-0-pro-250528: 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