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