ByteDance: Seedance 2.0 Mini
Seedance 2.0 Mini יוצר סרטונים קצרים עם צליל שנוצר באופן אופציונלי, מתוך טקסט ודוגמאות ייחוס של תמונות, וידאו ושמע. הוא תומך ביצירת סצנות, בעריכות וידאו ממוקדות ובהמשך, עם פרופיל פלט מתועד של 480p או 720p.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Seedance 2.0 Mini הוא מודל בעל שם נפרד במשפחת השמע־וידאו Seedance 2.0 של ByteDance. היצרן מתעד טקסט־לווידאו, תמונה־לווידאו מפריים ראשון או מפריים ראשון ואחרון, יצירה לפי ייחוס רב־מודאלי, עריכת וידאו והארכת וידאו. אפשר ליצור צליל יחד עם התמונה. בחרו מצב יצירה בהתאם לחומר שכבר יש בידיכם: בריף כתוב, תמונת פתיחה קבועה, שתי תמונות גבול או קטע הזקוק לעריכה או להמשך.
ל־Mini יש פרופיל פלט משלו. היצרן מפרט וידאו ב־480p וב־720p עם צבע של 8 סיביות, 24 פריימים לשנייה ופלט MP4. יחסי הממדים הנתמכים הם 21:9, 16:9, 4:3, 1:1, 3:4 ו־9:16; משך היצירה המתועד הוא 4–15 שניות. בקרת משך הסרטון של היצרן מאפשרת גם בחירה אוטומטית בטווח הזה. אפשרויות 1080p ו־4K של מודל Seedance 2.0 המלא נפרדות; הן אינן הגדרות של Mini. טבלת יכולות המשפחה מפרטת החזרת הפריים האחרון שנוצר, ואילו מצב Draft אינו נתמך.
Omni reference יוצר סצנה חדשה באמצעות מידע נבחר מהחומר שסופק. תמונה יכולה להגדיר מראה של נושא, קומפוזיציה או טיפול חזותי. סרטון יכול לקבוע פעולה, תנועת מצלמה או אפקט; דוגמת שמע יכולה לקבוע גוון קול, מנגינה או תוכן מדובר. אמרו למודל מה לקחת מכל דוגמה במקום לבקש להעתיק כל תכונה. לדוגמה, השתמשו בתצלום מוצר לצורה ולצבע, בקטע קצר של תנועת מצלמה להתקרבות ובדוגמת צליל לאווירה.
תהליך המשפחה מאפשר עד תשע תמונות ייחוס, שלושה קטעי וידאו ושלושה קטעי שמע. דוגמאות וידאו הן באורך 2–15 שניות כל אחת, ועד 15 שניות בסך הכול; דוגמאות שמע משתמשות באותן מגבלות משך לכל קטע ולסך הכול. שמע בלבד וטקסט עם שמע ללא דוגמה חזותית אינם שילובי ייחוס נתמכים. יצירה מטקסט בלבד היא מצב נתמך נפרד. לרצף, ספקו נכסים בסדר המיועד והתייחסו אליהם בעקביות כ־Image 1, Video 1 או Audio 1, לפי הסדר בתוך כל סוג מדיה. אל תחליפו דוגמה ממוספרת במזהה נכס בתוך ההנחיה הכתובה.
תמונת פריים ראשון מגדירה את פתיחת השוט המונחה תמונה. מצב פריים ראשון ואחרון מגדיר את שני הגבולות. אם תמונות הגבול המדויקות חשובות, בחרו במצב הייעודי במקום לתאר דוגמאות כפתיחה וסיום בתוך הנחיית omni-reference. האחרון הוא אפקט המונחה בטקסט ואינו שקול לבחירת פריימי גבול קשיחה. הכינו את התמונות לקומפוזיציית הפלט וציינו את הפעולה המחברת בין מצבי ההתחלה והסיום.
עריכת וידאו משנה קטע קיים במקום להשתמש בו רק כהשראה. זהו את הסרטון לעריכה, את החפץ או האזור לשינוי, את זמן הופעתו ואת מיקומו, ואת הפרטים לשימור. בריף שימושי הוא: ״ב־Video 1, החליפו את הספל בכלי המופיע ב־Image 1; שמרו על תנועת היד, המסגור, התאורה וסידור השולחן.״ להסרה, ציינו את החפץ הלא רצוי ואת המרכיבים שסביבו שחייבים להישאר. היצרן ממליץ להתייחס ישירות לסרטון היעד בעריכה או בהארכה; ניסוחו כדוגמת ייחוס עלול במקום זאת להעביר בקשה לסצנה חדשה שנוצרת.
הארכת וידאו מוסיפה אירועים לפני קטע קיים או אחריו. תארו את כיוון ההמשך ומה קורה לאחר מכן או קודם לכן. התהליך המתועד יכול גם לחבר שניים או שלושה קטעים באמצעות מעברים שנוצרים; שלושת סרטוני הקלט יחד עדיין צריכים לעמוד בתקציב הייחוס של 15 שניות. ההדרכה מבחינה בין המשך הכולל בעיקר את חומר הגבול של הקטע המקורי לבין בקשה השומרת במפורש על התוכן המקורי. ציינו את הרכב התוצאה הרצוי: רק ההמשך, או סצנה המכילה את הקטע שסופק ואת הפעולה החדשה.
לבימוי ברור, הפרידו בין תיאור הסצנה הקבוע לבין רצף האירועים. הגדירו כל נושא באמצעות שניים או שלושה מאפיינים חזותיים מבחינים ותווית עקבית. אחר כך תארו פעולות, סביבה, תאורה, תנועת מצלמה, סגנון חזותי ואילוצים. בדיאלוג, קשרו כל שורה לדובר ולפעולה הרלוונטית. השתמשו בתוויות שוטים מסודרות במקום להתייחס לחותמות זמן מדויקות כבקרות אמינות: היצרן מציין שתזמון מדויק עשוי להיות לא יציב. בריף מוצר מבוים יכול להיות: ״Image 1 מגדירה את מוצר A. שוט 1: התקרבו לאט למוצר A שעל הדלפק. שוט 2: יד מסובבת אותו לעבר האור. שוט 3: התייצבו על התווית הקדמית. צלילי סביבה עדינים של החדר; שמרו על האותיות המודפסות.״
הכינו דוגמאות בהתאם לכללי הקלט המתועדים של המשפחה. פורמטי תמונה נתמכים כוללים JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ו־HEIF; כל תמונה קטנה מ־30 MB. המדריך קובע רוחב וגובה תמונה הגדולים ממש מ־300 וקטנים ממש מ־6,000 פיקסלים, ויחס ממדים הגדול ממש מ־0.4 וקטן ממש מ־2.5. דוגמאות וידאו משתמשות ב־MP4 או MOV, עם וידאו H.264 או H.265 ושמע AAC או MP3, מוגבלות ל־200 MB כל אחת ובעלות 24–60 פריימים לשנייה. רוחבן וגובהן 300–6,000 פיקסלים, יחס הממדים 0.4–2.5 ומספר הפיקסלים הכולל 407,696–8,295,044. דוגמאות שמע משתמשות ב־WAV או MP3 ומוגבלות ל־15 MB כל אחת. אלו מפרטי הכנת הקלט של היצרן, הנפרדים מבקרות העלאה של יישום מסוים.
תהליך הדיוקנאות של היצרן דורש הכנה מסוימת לתמונות או לסרטונים המכילים פנים של אנשים אמיתיים: העלאת דוגמאות ישירה אינה הנתיב התקני הנתמך. הוא מתעד פלטי מודל מהימנים, דמויות דיגיטליות מוגדרות מראש ותהליך נכס של אדם אמיתי שאושר כפתרונות נפרדים. גם התאמת קול, הגייה והצליל בגבול הקטע דורשים בדיקה. מדריך ההנחיות ממליץ לתאר את מאפייני הקול המיועדים ולשמור על סגנון דיאלוג הקרוב לדוגמת השמע. בדקו בתוצר הסופי עקביות נושאים, מילים מדוברות מדויקות, תזמון פעולה, מעברי פריימים וצליל סיום; שפרו את המרכיב המסוים השונה מהבריף.
Ailoot Ultra · וידאו POST /v1/videos bytedance/seedance-2.0-mini
bytedance/seedance-2.0-miniהתחלה
Seedance 2.0 Mini יוצר סרטונים קצרים עם צליל שנוצר באופן אופציונלי, מתוך טקסט ודוגמאות ייחוס של תמונות, וידאו ושמע. הוא תומך ביצירת סצנות, בעריכות וידאו ממוקדות ובהמשך, עם פרופיל פלט מתועד של 480p או 720p.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio- סוגי פלט
video- פורמט פלט
- הבתים המקוריים של MP4; ללא נרמול או המרת קידוד
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות bytedance/seedance-2.0-mini | ברירת מחדל— |
שדה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-mini
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-mini
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-mini
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.007 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובקלט: with_video_input | חיוב reference · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.0042 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל 1K טוקני וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר טוקן וידאו · אומדן להשוואה בלבד $0.007 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.1512 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר טוקן וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר טוקן וידאו $0.007 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר טוקן וידאו $0.007 לכל 1K טוקני וידאו התעריף לטוקן וידאו הוא מחיר הייחוס העיקרי. האומדנים הראשיים לשנייה הם נתוני ייחוס נפרדים, ואינם חיוב נוסף. |
| תצורהמחיר טוקן וידאו | תנאי חיובקלט: with_video_input | חיוב reference · מחיר טוקן וידאו $0.0042 לכל 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-mini","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-mini
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · ByteDance: Seedance 2.0 Mini
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·bytedance/seedance-2.0-mini:text,image,audio→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·bytedance/seedance-2.0-mini: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-mini:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807