ByteDance: Seedance 1.0 Lite Text-to-Video
Seedance 1.0 Lite Text-to-Video הופך סצנה כתובה לווידאו ללא קול. מזהה Lite המסוים הזה משתמש בטקסט ולא בתמונת ייחוס, עם משך של 2–12 שניות, 24 fps ומסגור אופקי, אנכי, מרובע או קולנועי.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Seedance 1.0 Lite Text-to-Video יוצר וידאו מסצנה כתובה. המזהה המדויק doubao-seedance-1-0-lite-t2v-250428 הוא דגם הטקסט לווידאו במהדורת Lite. השתמשו בו כשאפשר לתאר ישירות את נושא הצילום, הסביבה והתנועה: מוצר על שולחן, מבט כללי לביסוס המיקום או פעולה קצרה של דמות. הפלט הוא קליפ וידאו; פרופיל 1.0 אינו יוצר שמע מסונכרן.
כתבו את הסצנה בסדר שבו הצופה אמור לראות אותה. זהו את נושא הצילום ואת מראהו, את המיקום, הפעולה, גודל השוט ותנועת המצלמה, ואז תארו את הקומפוזיציה הסופית. הנחיות מועילות למוצר יכולות להציג בקבוק על כן אבן בהיר, אור שמש העובר על התווית והתקרבות איטית אל הפקק. אלו הוראות לסצנה חדשה, ולא טענה שהמודל משחזר צילום מוצר שסופק. התאימו את הפעולה הגלויה לאורך הקליפ שנבחר.
מזהה הטקסט לווידאו הזה נפרד ממזהה Lite לתמונה לווידאו בעל השם הנפרד. התוכן שלו מסופק כפריט text במערך content. משפט יכול לתאר אדם, אובייקט או סגנון, אך אינו מצרף תמונת ייחוס ואינו קובע זהות חזותית מדויקת מתוך קובץ שלא נראה. לסצנה שהקומפוזיציה הפותחת שלה צריכה להגיע מתמונה קיימת, בחרו פרופיל התומך בתמונות, במקום להניח שזהות Lite t2v מחליפה מצב כשמוסיפים שדה מדיה.
טווח המשך המתועד של 1.0 הוא שתיים עד שתים עשרה שניות, עם ברירת מחדל של חמש שניות וקצב פריימים קבוע של 24 fps. Lite מציע רמות רזולוציה 480p, 720p ו-1080p, כש-720p היא ברירת המחדל המתועדת. יחסי הממדים הקבועים כוללים 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. שמרו את מזהה המשימה כשהיא ממתינה בתור או פועלת, ושמרו את הקליפ שהושלם לגרסה הבאה. תקופת השמירה המתועדת של הקבצים שנוצרו היא שבעה ימים. לבקשה יש גם פרק זמן עד לפקיעה, הנמדד מיצירת המשימה, שאחריו משימה שלא הושלמה עוברת לסטטוס פג תוקף; ברירת המחדל המתועדת היא 172800 שניות, עם ערכים מ-3600 עד 259200 שניות.
בדקו את הקליפ כולו מול ההנחיות: האם נושא הצילום המיועד מופיע, הפעולה מתרחשת בסדר הנכון, המצלמה נעה בכיוון שהתבקש והפריים הסופי שימושי. שנו הוראה מסוימת בגרסה הבאה ושמרו את מבנה הסצנה שהצליח. לסדרת שוטים, שמרו כל פרומפט, את ההגדרות שהתבקשו ואת הווידאו שהושלם, כדי לתכנן את הסצנה הבאה מהתוצאה בפועל.
Ailoot Ultra · וידאו POST /v1/videos doubao-seedance-1-0-lite-t2v-250428
doubao-seedance-1-0-lite-t2v-250428
doubao-seedance-1-0-lite-t2v-250428התחלה
Seedance 1.0 Lite Text-to-Video הופך סצנה כתובה לווידאו ללא קול. מזהה Lite המסוים הזה משתמש בטקסט ולא בתמונת ייחוס, עם משך של 2–12 שניות, 24 fps ומסגור אופקי, אנכי, מרובע או קולנועי.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות doubao-seedance-1-0-lite-t2v-250428 | ברירת מחדל— |
שדהcontent | סוגarray | דרישהחובה | ערכים ומגבלות תנאים: אובייקטי טקסט ומדיה בפורמט המקורי; המערך החיצוני חייב להיות לא ריק. הבנאי הכללי הזה של Ailoot אינו מאמת את הטיפוסים של הצמתים המקוננים. | ברירת מחדל— |
שדהduration | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 2 מקסימום: 12 תנאים: הסכמה הראשית של 1.x מציינת 2–12; תיאור משותף מאוחר יותר מציין עבור 1.5 את הטווח 4–12 או -1. הדוגמה משתמשת ב־5, המתועד בשניהם. | ברירת מחדל5 |
שדהresolution | סוגstring | דרישהרשות | ערכים ומגבלות 480p, 720p, 1080p תנאים: enum משותף; 1080p אינו נכלל עם תמונות עזר ועם 1.5. התיאור המוטמע של pro מונה 480p/1080p, בעוד שה־enum ברמה העליונה כולל 720p; אין הכרעה המבטיחה תמיכת pro ב־720p. | ברירת מחדל720p |
שדה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 |
פרמטרadditional_properties | מפרטtrue |
פרמטרvalidation_scope | מפרטAiloot בודקת את הטיפוסים של שדות החובה ושמערך model/content אינו ריק. יתר שדות הבקשה נשמרים עבור המודל שנבחר. |
כינויים לשיטה: /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.003 לכל 1K טוקני וידאו |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.144 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-lite-t2v-250428","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}/contentGET /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-lite-t2v-250428
כינויים לנתיבי שיטות
/v1/videos/generations
מזהי מודלים קשורים IDs
FAQ · ByteDance: Seedance 1.0 Lite Text-to-Video
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:text→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- אילו מגבלות חלות?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200