ByteDance: Seedance 2.0
ByteDance Seedance 2.0 משלב יצירת שמע־וידאו מקורית עם דוגמאות ייחוס של תמונה, וידאו וצליל. ביימו סצנות חדשות, ערכו חומר קיים או האריכו רצף; הגרסה הרגילה כוללת פלט מתועד של 1080p ו־4K בעומק 10 סיביות.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Seedance 2.0 הוא המודל הרגיל של ByteDance Seed ליצירת שמע־וידאו רב־מודאלית. הוא משלב טקסט, תמונות, סרטונים ושמע בארכיטקטורת יצירה משותפת, עם תהליכים יצירתיים נפרדים לסצנות מונחות ייחוס, לעריכת וידאו ולהארכת וידאו. הוא מועיל כאשר הבריף זקוק גם לביצוע מגובש וגם למידע חזותי או קולי מסוים מחומרים מוכנים.
ייחוס רב־מודאלי ושליטת בימוי
תמונות יכולות להגדיר את מראה הנושא, את הסגנון החזותי ואת הקומפוזיציה. דוגמאות וידאו יכולות להנחות פעולה, תנועת מצלמה ואפקטים. שמע יכול להנחות גוון קול, מוזיקה או דיאלוג. הגדירו את תפקידו של כל חומר ואז תארו את הסצנה שצריכה להתקבל. היצרן מדגיש שליטה בביצוע, בתאורה, בצללים ובשפה קולנועית.
לסיפור מוצר, הכינו תמונת מוצר, דוגמת תנועת מצלמה ורמז קולי. בריף יכול להיות: ״שמרו על אגרטל הזכוכית הכחול מ־Image 1. השתמשו בתנועת המעקב הצדית האיטית מ־Video 1. האגרטל ניצב על מדף שטוף שמש, עם מוזיקה אינסטרומנטלית רכה המבוססת על Audio 1.״ הפלט המיועד הוא סצנה מבוימת חדשה המשלבת מידע ייחוס נבחר.
קלטי ייחוס יכולים לשלב תמונה ושמע, תמונה ווידאו, וידאו ושמע או את כל השלושה. קלט שמע בלבד וטקסט עם שמע ללא תמונה או וידאו אינם נתמכים. מתועדים גם טקסט־לווידאו מסורתי, יצירה מפריים ראשון ויצירה מפריים ראשון ואחרון. אם קומפוזיציות פתיחה וסיום קבועות חשובות, השתמשו בתהליך נקודות הקצה הייעודי: הגדרת תמונת ייחוס כנקודת קצה בתוך הנחיית omni-reference היא רק דרך עקיפה להנחותו.
עריכת חומר מצולם
המודל יכול להחליף נושא, להוסיף או להסיר חפצים, לשנות מרכיבים ולצייר מחדש או לתקן חלקים מסרטון. תארו את השינוי המסוים וזהו את חומר המקור. בהוספה, כללו זמן הופעה ומיקום; בהסרה או בהחלפה, ציינו את החפץ במדויק ונקבו במה שצריך להישאר.
לדוגמה: ״החליפו את מנורת השולחן ב־Video 1 במנורת הפליז מ־Image 1. שמרו על תנועת המצלמה, סידור השולחן וכיוון התאורה.״ התוצאה הרצויה היא גרסה ערוכה של הסצנה עם ההחלפה המיועדת. בדקו את האזורים שלא שונו וגם את החפץ החדש, במיוחד בעת הסתרה, תנועה וחילופי שוטים.
הארכה וחיבור של רצף
Seedance 2.0 יכול להאריך סרטון קדימה או אחורה, ולחבר עד שלושה קטעים שסופקו עם מעברים שנוצרים. ציינו את הכיוון בזמן ואת האירוע החדש. לגישור, סדרו את הקטעים ותארו את המעבר בין כל זוג, כגון מצלמה הנכנסת דרך פתח בשוט אחד ומגיעה לסביבה הבאה.
הארכה פשוטה מחזירה בדרך כלל את ההמשך שפותח סביב חומר המקור; כללו הוראה ברורה אם התוצאה הסופית צריכה גם לחזור על המקטע המקורי. בהשלמת חיבור בין שניים או שלושה קטעים, התהליך המתועד יכול לכלול גם חומר מקורי וגם תוכן מעבר חדש. הדבר מועיל לפיתוח פתיחה או סיום, או לחיבור סצנות מוכנות בלי להשאיר את פעולת החיבור לא מוגדרת.
פלט הגרסה הרגילה ו־4K
הגרסה הרגילה מתעדת MP4 ב־24 fps ומשכים של 4 עד 15 שניות. רמות הפלט הן 480p, 720p ו־1080p עם עומק צבע של 8 סיביות, וכן 4K עם עומק צבע של 10 סיביות. היחסים הנתמכים הם 21:9, 16:9, 4:3, 1:1, 3:4 ו־9:16. מתועדים גם מסגור מסתגל ובחירת משך אוטומטית. לגרסת Fast יש מפרט פלט מצומצם משלה של 480p/720p.
פלט 4K משתמש בקידוד H.265/HEVC. קידוד של עשר סיביות משמר מדרגות גוון נוספות ומעברי צבע חלקים יותר, דבר החשוב בחומר עם מעברי אור או צבע עדינים. בדקו שסביבת ההשמעה והעריכה המיועדת יכולה לפענח את הפורמט; יש דפדפנים ומכשירים שאינם מנגנים אותו ישירות. קונטיינר תואם אינה מבטיחה כשלעצמה פענוח וידאו תואם.
המודל יכול ליצור צליל מסונכרן או סרטון אילם, ויכול להחזיר את הפריים האחרון שנוצר לסצנה עוקבת. השמע שנוצר הוא מונו. משפחת 2.0 אינה תומכת במצב תצוגת Draft הנפרד בעל שני השלבים, ולכן אין להסיק תכונת תצוגה זו מגרסת Seedance אחרת.
הכנת דוגמאות ומגבלות מהותיות
קיבולת הייחוס המתועדת היא עד תשע תמונות, שלושה סרטונים ושלושה קטעי שמע. העלאות ישירות של תמונות או סרטוני ייחוס המכילים פנים אנושיות אמיתיות אינן מתקבלות בפרופיל היצרן המתועד הזה; עבודת דיוקנאות משתמשת בתהליך נכסי הדיוקן הנתמך שלו. כל קטע וידאו ושמע חייב להיות באורך 2–15 שניות. כל דוגמאות הווידאו יחד חייבות לעמוד ב־15 שניות, ולכל דוגמאות השמע יחד יש סך נפרד של 15 שניות. קובצי וידאו משתמשים ב־MP4 או MOV ב־24–60 fps, עד 200 MB לכל אחד; קובצי שמע משתמשים ב־WAV או MP3, עד 15 MB לכל אחד. פורמטי התמונה המפורטים הם JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ו־HEIF. כל תמונה חייבת להיות קטנה מ־30 MB, וגוף הבקשה לא יעלה על 64 MB. בפרופיל קלט הייחוס המתועד, רוחב וגובה התמונה חייבים להיות גדולים ממש מ־300 וקטנים ממש מ־6,000 פיקסלים, עם יחס רוחב לגובה הגדול ממש מ־0.4 וקטן ממש מ־2.5. סרטוני ייחוס מאפשרים 300–6,000 פיקסלים בכל ממד ויחסים של 0.4–2.5, כולל הגבולות, עם 407,696–8,295,044 פיקסלים בסך הכול. סרטוני MP4 או MOV משתמשים בווידאו H.264/AVC או H.265/HEVC ובשמע AAC או MP3.
סדרו את הקבצים במכוון והתייחסו לכל אחד לפי סוג המדיה ומספרו: Image 1, Video 1 ו־Audio 1. המספר עוקב אחר הסדר בין קבצים מאותו סוג. הסבירו אילו מאפיינים להעביר ואיזה תוכן מקור לא צריך להגדיר את הסצנה החדשה. שפות ההנחיה המתועדות כוללות אנגלית, ספרדית, אינדונזית, פורטוגזית ויפנית. שמרו על שפה מדוברת עקבית בתוך דיאלוג; המדריך ממליץ שלא לערבב שפות למעט שמות פרטיים. בעבודה מונחית קול, הפרידו בין הדובר, השורה המדויקת והוראת ההגשה.
הכינו תמונות ראשונה ואחרונה בעלות מסגור תואם. אי־התאמה בין תמונת הקלט לממדי הפלט יכולה לגרום לחיתוך או לשינוי חזותי פתאומי; ממדים תואמים ומסגור מסתגל הם פתרונות מתועדים. מקדו את התיאור באירוע ובתפקידי הדוגמאות. היצרן מזהיר שהנחיות ארוכות יכולות לפזר מידע ולגרום להתעלמות מפרטים. בדקו את התנועה שהתקבלה, המשכיות הייחוס, ביצוע השמע והחיבורים בין סצנות כחלקים נפרדים של התוצאה היצירתית.
תכנון שוטים והנחיית טקסט
בסצנה מורכבת, ארגנו את הבריף כשוט 1, שוט 2 ושוט 3, וציינו לפי הסדר את המצלמה, פעולת הנושא, המיקום והצליל. המדריך ממליץ על תנועת מצלמה אחת לכל שוט ועל העדפת פעולות איטיות ומחוברות. חותמות זמן מדויקות לכל שוט אינן יציבות, ולכן רצף אירועים הוא בקרה טובה יותר מכפיית כמה חלונות זמן מדויקים.
המודל יוצר גם טקסט נפוץ, לרבות סיסמאות, כתוביות ובועות דיבור. אפשר להנחות צבע, טיפול חזותי, מיקום וכניסה של טקסט. השתמשו בתווים נפוצים ולא בתווים נדירים או בסמלים מיוחדים, ובדקו את הנוסח בתנועה. בדוגמאות נושאים, קשרו בבירור כל נכס לדמות או לחפץ המיועדים. זוויות מוצר יכולות לספק מידע חזותי שונה; קולאז'ים של סיבוב דמות עלולים לבלבל את זהות הפנים. ההמלצה המתועדת לדוגמאות דמות היא תמונת ראש ברורה ותמונת גוף מלא נפרדות.
התנהגויות לבדיקה לפני עריכה
המדריך מתעד כתוביות לא רצויות, לוגואים, דמויות כפולות וסטיית סגנון. חומר מקור נקי, תוויות עקביות ואילוצים מפורשים מפחיתים סיכונים אלה, אך אינם מבטיחים שטקסט לא רצוי או דמויות כפולות ייעלמו. יותר מארבעה אנשים המופיעים בחומרי הייחוס מדווחים כסיכון ליציבות, בנפרד ממספר הקבצים שהמודל מקבל.
הארכת וידאו יכולה ליצור קפיצה או חזרה אחורה בחיבור, והמשכים חוזרים יכולים לצבור ירידת איכות תמונה. בדקו את פריימי הגבול והגבילו הארכות מצטברות. קול ייחוס עשוי להיות שונה מגוון המקור; קריינות עשויה להסתיים בקליק או בחיתוך פתאומי, שדעיכת שמע היא פתרון מתועד עבורם. תווים סיניים רב־הגייתיים, לא נפוצים או דומים בצורתם עלולים להיהגות באופן שגוי. באפקט אנימציה מדויק, כגון ספירה לאחור, דוגמת תנועה מעבירה יותר מידע מבקשה מילולית בלבד. אלו סיבות קונקרטיות לבדוק בנפרד זהות, טקסט, תנועה וצליל בעת בחירת הקטע.
Ailoot Ultra · וידאו POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0התחלה
ByteDance Seedance 2.0 משלב יצירת שמע־וידאו מקורית עם דוגמאות ייחוס של תמונה, וידאו וצליל. ביימו סצנות חדשות, ערכו חומר קיים או האריכו רצף; הגרסה הרגילה כוללת פלט מתועד של 1080p ו־4K בעומק 10 סיביות.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio- סוגי פלט
video- פורמט פלט
- הבתים המקוריים של MP4; ללא נרמול או המרת קידוד
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות bytedance/seedance-2.0 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 מינימום: 1 מקסימום: 600 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהרשות | ערכים ומגבלות 480p, 720p, 1080p, 4K | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהרשות | ערכים ומגבלות false, true תנאים: ברזולוציות 480p ו־720p, השמטת generate_audio בוחרת במחיר הכולל אודיו, ו־false בוחר במחיר ללא אודיו. ברזולוציות 1080p ו־4K, מחיר הרזולוציה חל על שתי האפשרויות. יש לבדוק את has_audio בתוצאה כדי לזהות את רצועת האודיו שהוחזרה. | ברירת מחדל— |
שדהframe_images | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 1 מספר פריטים מרבי: 2 תוכן הקלט: מערך אובייקטים של פריימים. כל אובייקט כולל type=image_url, שדה image_url המכיל url ו־frame_type=first_frame או last_frame. כל תפקיד מופיע פעם אחת לכל היותר. יש להשתמש בכתובות HTTPS ציבוריות. מפתחות מדויקים: type, image_url, frame_type תנאים: המפתחות האלה חלים על כל אובייקט פריים. יש להשמיט frame_images בבקשה המבוססת על טקסט בלבד. | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות תוכן הקלט: מערך אובייקטים של תמונות או אודיו כחומרי עזר. יש להגדיר type לערך image_url או audio_url ולספק אובייקט URL תואם המכיל url. עדיין לא ניתן לתמחר חומרי עזר מסוג וידאו. תנאים: יש להשמיט frame_images כדי להשתמש במצב חומרי עזר. יש להשתמש בכתובות HTTPS ציבוריות. | ברירת מחדל— |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 תבנית: ^[1-9][0-9]*x[1-9][0-9]*$ | ברירת מחדל— |
שדהseed | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: -9,223,372,036,854,775,808 מקסימום: 9,223,372,036,854,775,807 | ברירת מחדל— |
שדהcallback_url | סוגstring | דרישהרשות | ערכים ומגבלות תבנית: ^https:// | ברירת מחדל— |
שדהsession_id | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהtrace | סוגobject | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהuser | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שילובים של חומרי קלט
מטקסט לווידאו · הנחיה כתובה. · נדרש: model, prompt, duration
יש לספק הנחיית טקסט ומשך נתמך בשניות שלמות. יש להשתמש בגודל מדויק מהרשימה, או ברזולוציה וביחס גובה־רוחב המתאימים לממדים מהרשימה.
model: סוג: string · bytedance/seedance-2.0
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
מתמונה לווידאו · הנחיה כתובה ותמונת פריים. · נדרש: model, prompt, duration, frame_images
frame_images הוא מערך אובייקטים עם type=image_url, שדה image_url המכיל url, ו־frame_type. יש להשתמש בכתובת URL ציבורית של תמונה ב־HTTPS; כל אחד מהערכים first_frame ו־last_frame יכול להופיע פעם אחת. יש להשתמש בגודל פלט מהרשימה או בממדים תואמים. אין להוסיף חומרי עזר מסוג וידאו.
המפתחות המדויקים: type, image_url, frame_type
model: סוג: string · bytedance/seedance-2.0
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
Reference to video · הנחיה כתובה ותמונות או אודיו כחומרי עזר. · נדרש: model, prompt, duration, input_references
input_references הוא מערך. כל אובייקט כולל type=image_url או type=audio_url ואובייקט URL תואם המכיל url. יש להשתמש בקישורי HTTPS ציבוריים. יש להשמיט frame_images כדי לבחור מצב חומרי עזר. לא ניתן לתמחר חומרי עזר מסוג וידאו.
model: סוג: string · bytedance/seedance-2.0
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration |
פרמטרmaterial_types | מפרטtext, image, audio |
פרמטרadditional_properties | מפרטfalse |
פרמטרoptional_controls | מפרטresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
מחזור חיים: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | יחידת חיוב | תנאי חיוב | חיוב |
|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יחידת חיוב— | תנאי חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.014 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובresolution: 1080p | חיוב פלט · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.0154 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובקלט: with_video_input; רזולוציה: 1080p | חיוב reference · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.0094 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובresolution: 4k | חיוב פלט · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.008 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובקלט: with_video_input; רזולוציה: 4k | חיוב reference · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.0048 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובקלט: with_video_input | חיוב reference · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.0086 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.014 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.3024 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר טוקן וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר טוקן וידאו $0.014 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובresolution: 4k | חיוב פלט · מחיר טוקן וידאו $0.008 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובresolution: 1080p | חיוב פלט · מחיר טוקן וידאו $0.0154 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר טוקן וידאו $0.014 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובקלט: with_video_input | חיוב reference · מחיר טוקן וידאו $0.0086 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובקלט: with_video_input; רזולוציה: 4k | חיוב reference · מחיר טוקן וידאו $0.0048 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובקלט: with_video_input; רזולוציה: 1080p | חיוב reference · מחיר טוקן וידאו $0.0094 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
כתובות חתומות לתוכן שבבעלותכם
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
בדיקת מצב המשימה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
יש לשמור כל פלט ממשי שבבעלותכם ואת המטא־נתונים המדודים שהוחזרו איתו.
כשצריך לבדוק את התגובה המקורית
503 result_pending_check + originalid + X-Should-Retry:false; אין לשלוח שוב את הבקשה המקורית
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהindex | סוגinteger | משמעותמיקום הווידאו הזה ברשימת הפלטים, בספירה המתחילה מאפס. |
שדהcontent_url | סוגstring | משמעותכתובת URL חתומה להורדת הווידאו שהושלם ב־HTTPS. |
שדהsha256 | סוגstring | null | משמעותתקציר SHA-256 של בתי הווידאו המקורי; null אם אינו זמין. |
שדהsize_bytes | סוגinteger | null | משמעותגודל קובץ הווידאו המקורי בבתים; null אם אינו זמין. |
שדהduration_ms | סוגinteger | null | משמעותמשך הווידאו המדוד באלפיות שנייה; null אם אינו זמין. |
שדהwidth | סוגinteger | null | משמעותרוחב הווידאו בפיקסלים; null אם אינו זמין. |
שדהheight | סוגinteger | null | משמעותגובה הווידאו בפיקסלים; null אם אינו זמין. |
שדהvideo_codec | סוגstring | null | משמעותמזהה מקודד הווידאו; null אם לא נרשם. |
שדהhas_audio | סוגboolean | null | משמעותהאם הווידאו מכיל רצועת אודיו; null אם לא נמדד. |
שדהaudio_codec | סוגstring | null | משמעותמזהה מקודד האודיו; null כאשר לא נרשם מזהה. |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה404 · not_found_error | תנאיהגישה לווידאו אינה זמינה, או שמזהה הווידאו הזה לא נמצא. | השלב הבאיש לבדוק את הגישה לווידאו. עבור וידאו קיים, יש להשתמש במזהה הציבורי המקורי שלו ובאותו מפתח API. |
תגובה401 · authentication_error | תנאימפתח ה־API אינו תואם לחשבון המאומת. | השלב הבאיש לבדוק את מפתח ה־API ואת הגישה לחשבון לפני השליחה. |
תגובה400 · invalid_request_error | תנאילא ניתן היה לקרוא את הבקשה, או שאינדקס ההורדה אינו תקף. | השלב הבאיש לתקן את גוף הבקשה. להורדה, יש לבחור אינדקס פלט שהוחזר על ידי המשימה המקורית. |
תגובה422 · price_unavailable | תנאילא ניתן לתמחר את תצורת הווידאו שנבחרה. | השלב הבאיש לבחור תצורת וידאו נתמכת ולהשלים את האפשרויות הנדרשות בה לפני שליחת בקשה מתוקנת. |
תגובה422 · invalid_request_error | תנאיקלט וידאו או משימת המשך מקורית אינם תקפים. | השלב הבאיש להשתמש בקלטי HTTPS תקפים. להמשך, יש להשתמש במזהה הציבורי של הווידאו המקורי שלכם שהושלם, עם אותו מפתח API. |
תגובה402 · billing_error | תנאיהיתרה הזמינה או המגבלות אינן מאפשרות לשריין סכום. | השלב הבאיש לבדוק את היתרה הזמינה ואת המגבלות לפני שליחת בקשה חדשה. |
תגובה503 · server_error | תנאיאימות הווידאו, האחסון או הגישה לשירות אינם זמינים זמנית. | השלב הבאיש להמתין לזמינות השירות. אם כבר יש לכם מזהה וידאו, יש לבדוק את המשימה המקורית הזו במקום ליצור וידאו נוסף. |
תגובה503 · result_pending_check | תנאייש לבדוק את תוצאת הווידאו המקורית ואת החיוב. | השלב הבאיש לשמור את מזהה הווידאו שהוחזר ולבדוק את המשימה הזו. אין לשלוח בקשת יצירה חלופית בזמן הבדיקה. |
תגובה503 · owned_result_unavailable | תנאיהורדת הווידאו הקיים אינה זמינה זמנית. | השלב הבאיש לבדוק את אותה משימת וידאו בהמשך ולהוריד את הפלט הקיים שלה. יצירה חדשה יוצרת פעולה נפרדת. |
תגובה409 · video_not_ready | תנאיתוכן הווידאו לא פורסם. | השלב הבאיש לבדוק את הסטטוס של המשימה המקורית. יש להוריד לאחר שהיא מדווחת completed; אם היא מדווחת failed, יש לפעול לפי ההודעה שלה על בדיקת החיוב. |
כינויים
כינויים למודל
Ailoot Ultra bytedance/seedance-2.0
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · ByteDance: Seedance 2.0
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- אילו מגבלות חלות?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807