ByteDance: Seedance 2.0 Fast
ByteDance Seedance 2.0 Fast יוצר סצנות שמע־וידאו מטקסט ומדוגמאות של תמונות, וידאו וצליל. הגרסה המכוונת למהירות תומכת בהעברת תנועה וסגנון, בעריכות וידאו ובהארכות קדימה או אחורה, עם פלט מתועד של 480p ו־720p.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Seedance 2.0 Fast הוא גרסת משפחת Seedance 2.0 של ByteDance Seed המכוונת למהירות. הוא תומך ביצירה משותפת של וידאו ושמע ובבריף רב־מודאלי הבנוי מטקסט, תמונות, וידאו וצליל. יכולותיו היצירתיות כוללות סצנות חדשות מונחות ייחוס, עריכת חומר קיים והארכת סצנה, בעוד רמות הפלט המתועדות הן 480p ו־720p.
ייחוס רב־מודאלי: הקצאת תפקידים לחומר
תמונה יכולה לספק דמות, מוצר, קומפוזיציה או טיפול חזותי. סרטון ייחוס יכול לספק פעולה, תנועת מצלמה או אפקט. שמע ייחוס יכול לספק גוון קול, מנגינה מוזיקלית או תוכן דיאלוג. הסבירו איזה חלק מכל מקור ברצונכם להעביר לסצנה החדשה; דוגמה מועילה יותר כאשר יש לה תפקיד יצירתי מוגדר.
לדוגמה: ״השתמשו במנורה הקרמית שב־Image 1 כמוצר. עקבו אחר תנועת המצלמה הסיבובית האיטית שב־Video 1, אך הציבו את המנורה בפינת קריאה שקטה. השתמשו ב־Audio 1 לאווירה המוזיקלית.״ הפלט המיועד הוא סצנה חדשה המשלבת את המראה, התנועה והכיוון הקולי שנבחרו, ולא חיקוי לא מוגדר של כל פרט בדוגמאות.
השילובים המתועדים כוללים תמונות עם שמע, תמונות עם וידאו, וידאו עם שמע וכל השלושה יחד. טקסט עם שמע בלבד וקלט שמע בלבד אינם נתמכים. המודל תומך גם בטקסט־לווידאו וביצירה מונחית תמונה מפריים ראשון או מצמד פריים ראשון ואחרון. כאשר נקודת סיום מדויקת מרכזית לבריף, השתמשו בתהליך נקודות הקצה הייעודי; תיאור תמונת ייחוס כנקודת קצה בהנחיית omni-reference הוא שליטה עקיפה.
עריכת סרטון קיים
המודל יכול להוסיף, להסיר או לשנות מרכיבים, להחליף נושא ולצייר מחדש או לתקן חלקים מסצנה. זהו את סרטון המקור, את החפץ לשינוי ואת המרכיבים שצריכים להישאר. בהוספה, תארו היכן הוא מופיע ומתי. בהסרה, זהו את החפץ בעקביות לאורך הקטע.
בריף עריכה מעשי יכול להחליף בקבוק פשוט בהדגמה בבקבוק שב־Image 1, תוך בקשה לשמר את תנועת היד, הרקע ומסלול המצלמה של Video 1. בדקו את ההחלפה ואת האזורים שנועדו להישאר יציבים. הוראות שימור ברורות מקלות על הערכת העריכה המיועדת יותר מבקשה כללית ״לשפר״ את החומר.
הארכה וחיבור של קטעים
Seedance 2.0 Fast תומך בהארכה קדימה או אחורה ובחיבור שניים או שלושה קטעים באמצעות מעברים שנוצרים. בהארכה, ציינו אם הפעולה החדשה מתרחשת לפני הסרטון שסופק או אחריו ותארו אותה. בחיבור, ספקו את הקטעים בסדר המיועד והסבירו את האירוע החזותי שמחבר ביניהם.
הארכה פשוטה מחזירה בדרך כלל את ההמשך החדש שהתפתח סביב חומר המקור, במקום להניח שכל קטע המקור חוזר. אם הפלט צריך להכיל את המקטע המקורי, אמרו זאת בבריף. במילוי מעבר בין שניים או שלושה סרטונים, התהליך המתועד יכול לשלב תוכן מקורי וחדש. הדבר מועיל לקישור מבט רחב על מוצר לשוט פרט באמצעות תנועת מצלמה בעלת מטרה.
פלט והבדלים בין גרסאות
פלט Fast המתועד הוא MP4 ב־24 fps, עם 480p או 720p, עומק צבע של 8 סיביות וקטעים באורך 4–15 שניות. היחסים הנתמכים הם 21:9, 16:9, 4:3, 1:1, 3:4 ו־9:16. גרסת Seedance 2.0 הרגילה מפרטת בנפרד פלט 1080p ו־4K; רמות אלה אינן חלק ממפרט Fast. משפחת 2.0 תומכת בהחזרת הפריים האחרון שנוצר, אך אינה תומכת במצב תצוגת Draft הנפרד.
אפשר ליצור שמע עם החומר או להשמיטו לקבלת קטע אילם. השמע שנוצר הוא מונו. שפות ההנחיה המתועדות כוללות אנגלית, ספרדית, אינדונזית, פורטוגזית ויפנית. שמרו על שפה מדוברת עקבית בדיאלוג; המדריך ממליץ שלא לערבב שפות למעט שמות פרטיים. בסצנה מדוברת, ציינו את הדובר וכתבו את השורה במירכאות, ואז ציינו את אופן ההגשה ואת אפקטי הצליל הרלוונטיים. התאימו את הביצוע הדרוש לאורך הקטע שנבחר.
הכנת דוגמאות ושמירה על מגבלות קלט
מגבלות הייחוס המתועדות הן עד תשע תמונות, שלושה סרטונים ושלושה קטעי שמע. העלאות ישירות של תמונות או סרטוני ייחוס המכילים פנים אנושיות אמיתיות אינן מתקבלות בפרופיל היצרן המתועד הזה; עבודת דיוקנאות משתמשת בתהליך נכסי הדיוקן הנתמך שלו. כל קטע וידאו או שמע חייב להיות באורך 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-fast
bytedance/seedance-2.0-fastהתחלה
ByteDance Seedance 2.0 Fast יוצר סצנות שמע־וידאו מטקסט ומדוגמאות של תמונות, וידאו וצליל. הגרסה המכוונת למהירות תומכת בהעברת תנועה וסגנון, בעריכות וידאו ובהארכות קדימה או אחורה, עם פלט מתועד של 480p ו־720p.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio- סוגי פלט
video- פורמט פלט
- הבתים המקוריים של MP4; ללא נרמול או המרת קידוד
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות bytedance/seedance-2.0-fast | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 מינימום: 1 מקסימום: 600 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהרשות | ערכים ומגבלות 480p, 720p | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהרשות | ערכים ומגבלות false, true תנאים: השמטת generate_audio בוחרת במחיר הכולל אודיו; false בוחר במחיר ללא אודיו. יש לבדוק את 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 תבנית: ^[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-fast
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-fast
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-fast
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.0084 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובקלט: with_video_input | חיוב reference · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.00495 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.0084 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.18144 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר טוקן וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר טוקן וידאו $0.0084 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר טוקן וידאו $0.0084 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובקלט: with_video_input | חיוב reference · מחיר טוקן וידאו $0.00495 לכל 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-fast","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-fast
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · ByteDance: Seedance 2.0 Fast
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·bytedance/seedance-2.0-fast:text,image,audio→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·bytedance/seedance-2.0-fast: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-fast:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807