דילוג לתיעוד
בעמוד זה

Seedance 2.5 Flash

צרו סרטונים עם Seedance 2.5 Flash באמצעות טקסט, פריים ראשון ואחרון, או קלטי התייחסות רב-מודאליים. עמוד זה מכסה את תהליך העבודה המלא מקבלת הבקשה ועד לקבלת התוצאה עבור דגם זה.

מזהה דגם ב-API: seedance-2-5-flash

תהליך היצירה הוא אסינכרוני. שמרו את ה-taskId שמוחזר בעת יצירת המשימה, ולאחר מכן בדקו את הסטטוס שלה או קבלו עדכון באמצעות Webhook.

יכולות

דגם Seedance 2.5 Flash תומך ב-480p וב-720p, כאשר 720p היא ברירת המחדל. הוא אינו תומך ב-1080p, 4k, תצוגות מקדימות מסוג Draft או יצירת סרטון סופי מתוך Draft.
תכונהערכים נתמכים
רזולוציית פלט480p · 720p
אורך הפלט4–30 שניות
יחס גובה-רוחב16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
תמונות התייחסותעד 30 תמונות
סרטוני התייחסותעד 10 סרטונים
קובצי אודיו להתייחסותעד 10 קובצי שמע
כל קלטי ההתייחסות יחדעד 50 קובצי עזר בסך הכל
אורך כולל לקבוצת וידאו/אודיו30 שניות
seed-1 עד 2147483647
ניתן גם להגדיר duration=-1 במצב התייחסות לווידאו (reference-to-video); ראו עריכת וידאו ותמחור להלן. במצב image-to-video נתמך רק הערך adaptive; יש להשמיט שדה זה או להגדירו כ-adaptive.

תמחור וקרדיטים

החיוב על יצירת סרטונים מתבצע בנקודות זכות (credits) בהתאם למשך הזמן לחיוב בשניות. ללא סרטון קלט, המשך לחיוב הוא אורך סרטון הפלט; עם סרטון קלט, החיוב כולל גם את אורך סרטון הייחוס.

הטבלה שלהלן מציגה את נקודות הזכות לחיוב בשנייה, ולא את העלות הכוללת של המשימה. התעריף נקבע לפי הדגם, רזולוציית הפלט, והאם סופקו סרטוני ייחוס במצב Reference-to-Video. לחישוב העלות הכוללת, עיין בנוסחאות ובדוגמאות שמתחת לטבלה.

רזולוציית פלטללא קלט וידאועם קלט וידאו
480p‏7 קרדיטים לשנייה‏5 קרדיטים לשנייה
720p‏10 קרדיטים לשנייה‏7 קרדיטים לשנייה
  • ללא קלט וידאו: שניות פלט × תעריף ללא וידאו.
  • עם קלט וידאו: (שניות פלט + שניות מדודות של סרטון ההתייחסות) × תעריף עם וידאו. השרת מודד את אורך סרטון ההתייחסות הכולל ומעגל אותו כלפי מעלה לשניות שלמות לפני החיוב.
  • התייחסויות המבוססות על תמונה או אודיו בלבד מחושבות לפי תעריף 'ללא וידאו'. תעריף החיוב עבור סרטון התייחסות חל רק במצב reference-to-video כאשר מסופקים סרטוני התייחסות.

דוגמאות לחישוב עלויות

יצירת טקסט לווידאו באורך 5 שניות ברזולוציית 720p: 5 × 10 = 50 קרדיטים.

פלט באורך 5 שניות ב-720p עם סרטון התייחסות של 5 שניות: (5 + 5) × 7 = 70 קרדיטים.

קרדיטים אלו מנוכים מראש בעת יצירת המשימה. אם המשימה מסתיימת בהצלחה, סכום זה הוא החיוב הסופי; הוא לא יוגדל ולא יוחזר חלקית בהתבסס על משך זמן הפלט בפועל. משימות שנכשלו או שהזמן שלהן פג (Timeout) יעברו לתהליך החזר כספי.

הקרדיטים נשמרים בעת שליחת הבקשה ומחויבים רק עם הצלחת המשימה. משימות שנכשלו או שהזמן שלהן קצב (timeout) נכנסות לתהליך זיכוי. סטטוס חיוב של refund_failed פירושו שהזיכוי לא הושלם בהצלחה; יש לבדוק את יומני הרישום (logs) של ה-API או לפנות לתמיכה.

כיצד מנוכים קרדיטים כאשר duration=-1

כאשר אורך הסרטון מוגדר כ-‎-1, אורך סרטון הפלט אינו קבוע והמודל קובע אותו.

במרבית המקרים, מומלץ להגדיר את אורך הסרטון הרצוי בפועל במקום לבחור ב-‎-1. אנו ממליצים להשתמש ב-‎-1 אך ורק לצורך עריכת וידאו, ולא בתרחישים אחרים של יצירת סרטונים.

קלט ייחוס (Reference)כיצד מחושב החיובדוגמה
עם סרטוני ייחוססוכמים את משך הזמן של כל סרטוני הייחוס ומעגלים את הסך הכל כלפי מעלה לשנייה השלמה הבאה – נסמן ערך זה כ-T. החיוב הוא (T + T) כפול תעריף הוידאו: T אחד מייצג את משך זמן הפלט המוערך, וה-T השני מייצג את משך זמן סרטון הקלט.ברזולוציית 720p עם סרטון ייחוס באורך 5 שניות: (5 + 5) × 7 = 70 קרדיטים.
ללא סרטוני ייחוס (תמונות או שמע בלבד)משך זמן הפלט המוערך נקבע ל-30 שניות. החיוב הוא 30 כפול התעריף ללא וידאו.ברזולוציית 720p ללא סרטוני ייחוס: 30 × 10 = 300 קרדיטים.

אימות

צרו מפתח API בלוח הבקרה. המפתח המלא יוצג פעם אחת בלבד. שמרו אותו בשרת שלכם ושלחו אותו כטוקן Bearer בכל בקשה.

כתובת בסיס (Base URL)

https://api.seevio.ai
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

הגדירו את משתנה הסביבה SEEVIO_API_KEY לפני הרצת דוגמאות אלו. דוגמאות ה-JavaScript רצות על השרת שלכם באמצעות Node.js; דוגמאות ה-Python משתמשות בחבילת requests.

מדריך מהיר

שלחו בקשה בסיסית זו, שמרו את ה-taskId שמוחזר, והשתמשו בדוגמה לשאילתת משימה המופיעה להלן. ערך הקרדיטים (credits) בתגובת היצירה מייצג את כמות הקרדיטים השמורה עבור המשימה.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

דוגמה לתגובת יצירת משימה

לאחר קבלת הבקשה שלעיל, ה-API מחזיר תגובת JSON זו. הפרמטר taskId הוא מזהה המשימה המשמש לשאילתות סטטוס הבאות; הפרמטר credits מייצג את מספר הקרדיטים השמורים עבור משימה זו. תגובה זו מאשרת את יצירת המשימה, ולא שהסרטון מוכן. עליך לבצע פנייה יזומה (polling) לבדיקת סטטוס המשימה או להשתמש ב-Webhook כדי לקבל את תוצאות הסרטון.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

יצירת משימה

POST https://api.seevio.ai/v1/videos/generations

שלחו אובייקט JSON המכיל model ו-input, בתוספת callback_url אופציונלי. הקפידו תמיד לציין את מזהה המודל (model ID) המוצג בדף זה; השמטת המודל תבחר ב-seedance-2-0 כברירת מחדל.

גוף הבקשה

שדהסוגחובהתיאור ומגבלות
model
stringכן

מזהה דגם. כדי להשתמש ב-Seedance 2.5 Flash, הגדר שדה זה כ-seedance-2-5-flash.

callback_url
stringלא

כתובת HTTPS ציבורית לקבלת קריאות חוזרות (POST callbacks) במקרה של הצלחה או כישלון. שימוש ברשתות פרטיות וב-localhost אינו מותר.

דוגמה: https://example.com/webhooks/seevio
input
objectכן

הגדרות היצירה. חייב להכיל prompt (הנחיה) שאינו ריק.

פרמטרי קלט

השדה image_urls הוא חובה במצב image-to-video. מצב reference-to-video דורש לפחות קלט התייחסות אחד מתוך image_urls, video_urls או audio_urls.

יש לספק את image_urls‏, video_urls ו-audio_urls כמערכים של מחרוזות URL‏ (string[]). כל כתובת URL שתוזן חייבת להיות נגישה לציבור באמצעות פרוטוקול HTTPS, כולל קובצי מדיה שאין בהם שימוש במצב שנבחר.

שדהסוגחובהברירת מחדלתיאור ומגבלות
input.prompt
stringכן—

יש להזין הנחיה (prompt) בכל אחד מהמצבים. ההנחיה יכולה להכיל עד 10,000 תווים לכל היותר (לפני קיצוץ רווחים) ואינה יכולה להורכב מרווחים בלבד.

דוגמה: A cat surfing at sunset
input.generation_type
stringלאtext-to-video
ערכים נתמכים
text-to-video | image-to-video | reference-to-video

text-to-video, image-to-video או reference-to-video. אם הושמט, ברירת המחדל היא text-to-video ונעשה שימוש בהנחיה בלבד. image-to-video משתמש ב-1–2 תמונות פריים מסודרות. reference-to-video משתמש בתמונות, סרטונים ו/או שמע; מקורות שמע בלבד נתמכים עם הנחיית טקסט חובה.

input.image_urls
string[]מותנה[]

ספקו כתובות URL של תמונות כדי להכווין את המראה הוויזואלי. במצב image-to-video, ספקו תמונה אחת לפריים הראשון או 2 בסדר של פריים ראשון, פריים אחרון. במצב reference-to-video, ספקו לכל היותר 30 תמונות. כל תמונה חייבת להיות קטנה מ-30 MB; ראו את דרישות המדיה להלן עבור פורמטים ומימדים. ניתן לספק עד 50 קבצים בסך הכול, מכל סוגי חומרי הייחוס יחד. אם הושמט, ברירת המחדל היא []; המערכת מתעלמת מהשדה במצב text-to-video.

דוגמה: ["https://example.com/first-frame.jpg"]
input.video_urls
string[]מותנה[]

ספקו כתובות URL של סרטוני מקור כדי להכווין את התנועה או לערוך/להאריך סרטון, אך ורק במצב reference-to-video. לכל היותר 10 קבצים, עד 100 MB ובין 2–30 שניות כל אחד; משך הזמן המשולב שלהם לא יעלה על 30 שניות. ניתן לספק עד 50 קבצים בסך הכול, מכל סוגי חומרי הייחוס יחד. השרת מודד את משך הווידאו לצורכי חיוב. אם הושמט, ברירת המחדל היא []; המערכת מתעלמת מהשדה במצבים אחרים.

דוגמה: ["https://example.com/source.mp4"]
input.audio_urls
string[]מותנה[]

ספקו כתובות URL של קבצי שמע של מקור כדי להכווין את הסאונד, אך ורק במצב reference-to-video. לכל היותר 10 קבצי MP3/WAV, עד 15 MB ובין 2–30 שניות כל אחד; משך הזמן המשולב שלהם לא יעלה על 30 שניות. ניתן לספק עד 50 קבצים בסך הכול, מכל סוגי חומרי הייחוס יחד. שמע יכול להיות סוג המקור היחיד; ההנחיה נשארת חובה. אם הושמט, ברירת המחדל היא []; המערכת מתעלמת מהשדה במצבים אחרים.

דוגמה: ["https://example.com/music.mp3"]
input.duration
integerלא5
ערכים נתמכים
-1 | 4–30

אורך פלט כמספר שלם, מ-4 עד 30 שניות. תומך גם בערך -1, אך ורק במצב reference-to-video. השתמשו בערך זה עם סרטון מקור לצורך עריכה; החיוב יתבצע בהתאם לכלל המיוחד המפורט לעיל.

דוגמה: 5
input.aspect_ratio
stringלאadaptive
ערכים נתמכים
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

16:9, 4:3, 1:1, 3:4, 9:16, 21:9 או adaptive. אם הושמט, ברירת המחדל היא adaptive, המאפשרת לדגם לקבוע את יחס הפלט. עבור עריכת וידאו או הארכת וידאו, השתמשו ב-adaptive. במצב image-to-video נתמך רק הערך adaptive; יש להשמיט שדה זה או להגדירו כ-adaptive.

דוגמה: adaptive
input.resolution
stringלא720p
ערכים נתמכים
480p | 720p

480p או 720p. אם הושמט, ברירת המחדל היא 720p בכל מצב יצירה נתמך. רזולוציות גבוהות יותר יידחו.

דוגמה: 720p
input.generate_audio
booleanלאtrue
ערכים נתמכים
true | false

הערך true מבקש אודיו מסונכרן; false משבית יצירת אודיו. אם הושמט, ברירת המחדל היא true. חל על כל מצבי היצירה הנתמכים.

דוגמה: true
input.watermark
booleanלאfalse
ערכים נתמכים
true | false

הערך true מבקש סימן מים של בינה מלאכותית על הפלט; false מבקש פלט ללא סימן מים זה. אם הושמט, ברירת המחדל היא false. חל על כל מצבי היצירה הנתמכים.

דוגמה: false
input.web_search
booleanלאfalse
ערכים נתמכים
true | false

הערך true מאפשר חיפוש באינטרנט כאשר הדבר זמין עבור הדגם; false משבית אותו. אם הושמט, ברירת המחדל היא false. הפעלת האפשרות אינה מבטיחה שיתבצע חיפוש בפועל.

דוגמה: false
input.return_last_frame
booleanלאfalse
ערכים נתמכים
true | false

הערך true מבקש לקבל את הפריים האחרון של הסרטון שנוצר; false אינו מבקש זאת. אם הושמט, ברירת המחדל היא false. חל על כל מצבי היצירה הנתמכים. כאשר הפריים מבוקש וזמין, כתובת ה-URL שלו מוחזרת כ-data.last_frame_url; אחרת היא תהיה null.

דוגמה: true
input.seed
integerלא—
ערכים נתמכים
-1 עד 2147483647

מספר שלם בין -1 ל-2147483647. הערך -1 בוחר seed אקראי.

דוגמה: 42
input.output_format
stringלאmp4
ערכים נתמכים
mp4 | mov

mp4 או mov. אם הושמט, ברירת המחדל היא mp4. קובע את פורמט המיכל של הפלט בכל מצבי היצירה הנתמכים.

שדות בוליאניים חייבים לקבל ערך JSON של true או false, ולא כמחרוזות או מספרים.

תגובת יצירה

קוד HTTP 200 מחזיר taskId (מחרוזת) ו-credits (מספר). תגובה זו מאשרת את יצירת המשימה, אך לא את השלמתה. הסכום המוצג להלן תואם למדריך המהיר של 5 שניות ב-720p.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

מצבי יצירה ודוגמאות

החליפו את כתובות ה-URL לדוגמה של example.com בקובצי ה-HTTPS הציבוריים והנגישים שלכם. כתובות ה-URL שבדוגמה נועדו להמחיש את מבנה הבקשה בלבד ואינן זמינות להורדה.

טקסט לווידאו

יצירה מתוך הנחיית טקסט. כתובות URL של מדיה אינן מועברות במצב זה.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

פריים ראשון

ספקו תמונה אחת כפריים הראשון, ותארו את התנועה הרצויה בהנחיית הטקסט.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

פריים ראשון ואחרון

ספקו שתי כתובות URL של תמונות לפי הסדר: הפריים הראשון, ולאחר מכן הפריים האחרון. דוגמה זו מבקשת גם את הפריים האחרון של הסרטון שיווצר.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

התייחסות רב-מודאלית

שילוב של תמונות, סרטונים וקובצי אודיו להתייחסות. הנחיית הטקסט נשארת שדה חובה. שימוש בסרטון התייחסות משנה את נוסחת החיוב.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

התייחסות לאודיו

שימוש באודיו כקלט ההתייחסות היחיד, יחד עם הנחיית טקסט (חובה) המתארת את הווידאו המבוקש.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

עריכת וידאו

בעריכת וידאו ב-Seedance 2.5 Flash, יש להגדיר את משך הזמן (duration) ל- -1 ואת יחס הגובה-רוחב (aspect_ratio) למצב אדפטיבי (adaptive). שתי ההגדרות הללו נחוצות; אחרת, יצירת הסרטון תיכשל.

תארו את העריכה המבוקשת וספקו את סרטון המקור. הגדירו duration=-1 והשתמשו ביחס גובה-רוחב adaptive. מומלץ להשתמש בקטע מקור של 4 שניות לפחות עבור תהליך עבודה זה. כלל החיוב עבור duration=-1 מפורט לעיל.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

הארכת וידאו

עבור הרחבת הווידאו של Seedance 2.5 Flash, יש להגדיר את aspect_ratio ל-adaptive; אחרת, יצירת הווידאו עלולה להיכשל. הגדר את duration כרגיל לאורך סרטון הפלט הרצוי בטווח הנתמך; אין צורך להשתמש ב--1.

תארו כיצד סרטון המקור צריך להמשיך. השתמשו ביחס גובה-רוחב adaptive והגדירו אורך פלט רגיל בטווח הנתמך על ידי הדגם.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

שאילתת משימה

GET https://api.seevio.ai/v1/tasks/{taskId}

החליפו את מזהה הדוגמה ב-taskId שהתקבל בעת היצירה. שאילתות יחזירו רק משימות השייכות למשתמש של מפתח ה-API; מזהים שאינם נגישים או שאינם קיימים יחזירו שגיאת HTTP 404.

כנקודת מוצא, בצעו שאילתה (polling) כל 10–20 שניות, הפחיתו את התדירות במקרה של שגיאת HTTP 429, ועצרו כאשר הסטטוס הופך ל-completed או failed. בסביבת פרודקשן מומלץ להשתמש ב-Webhooks. כל דוגמת קוד להלן מבצעת שאילתה אחת בלבד.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"
סטטוסתיאור ומגבלות
queuedהתקבל וממתין לעיבוד.
generatingהיצירה מתבצעת כעת.
completedהושלם בהצלחה. יש להוריד את הקבצים מ-data.results לפני מועד פקיעת התוקף.
failedנכשל סופית. יש לבדוק את failed_reason ואת billing_status.
שדהסוגתיאור ומגבלות
idstring
מזהה המשימה. זהו ה-taskId שהתקבל בתגובת היצירה.
created_atnumber
זמן יצירת המשימה בפורמט Unix timestamp (שניות).
modelstring
מזהה הדגם הציבורי ששימש למשימה זו.
billing_statusstring
סטטוס חיוב: reserved (שמור), charged (חויב), refunded (זוכה) או refund_failed (הזיכוי נכשל).
creditsnumber
הקרדיטים שנשמרו עבור משימה זו. ערך זה נשמר גם לאחר זיכוי; יש לבדוק את billing_status כדי לקבוע את תוצאת החיוב הסופית.
failed_reasonstring | null
סיבת הכישלון במשימות שנכשלו; אחרת הערך הוא null. תגובות של שאילתות שנכשלו אינן כוללות את השדה data.
dataobject
קיים בשאילתות של משימות שלא נכשלו. מכיל פרטי פלט ועיבוד.
data.resultsstring[]
מערך כתובות URL של הסרטון. ריק עד להשלמת המשימה או לאחר פקיעת תוקף הסרטון.
data.video_expires_atstring | null
מועד פקיעת התוקף של הסרטון בפורמט ISO 8601, או null לפני שהסרטון זמין. שמרו את התוצאה לפני מועד זה.
data.last_frame_urlstring | null
כתובת ה-URL של הפריים האחרון כאשר התבקש וזמין, אחרת null.
data.processing_timenumber | null
משך עיבוד המשימה בשניות, במידה וזמין. אחרת יוחזר null.

משימה הושלמה: תגובת שאילתה עם תוצאות הווידאו

כאשר השאילתה מחזירה status=completed, יצירת הווידאו הסתיימה. ניתן לקרוא את כתובות ה-URL של הסרטונים מתוך data.results ולהוריד אותם לפני המועד המצוין ב-data.video_expires_at. הסטטוס billing_status=charged מציין כי הקרדיטים השמורים חויבו.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

משימה נכשלה: תגובת שאילתה עם פרטי השגיאה והחיוב

כאשר השאילתה מחזירה status=failed, תהליך היצירה הסתיים ללא הצלחה. ניתן לראות את סיבת הכישלון ב-failed_reason ואת סטטוס ההחזר ב-billing_status. בדוגמה זו, refunded מציין שהקרדיטים הוחזרו. השדה credits שומר על הערך המקורי שהוזמן, והתגובה אינה כוללת את השדה data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed"
}

Webhooks

הגדירו callback_url בבקשת היצירה כדי לקבל בקשת POST מסוג JSON כאשר המשימה מסתיימת או נכשלת. החזירו תגובת 2xx בתוך 15 שניות. שליחות שנכשלו ינוסו שוב; טפלו בקבלת שידורים חוזרים בצורה אידמפוטנטית (idempotent) לפי מזהה המשימה.

קצה הקישור החוזר (callback endpoint) שלך חייב לקבל בקשות POST עם גוף בקשה מסוג JSON (Content-Type: application/json).

יצירת משימה עם קריאה חוזרת (Callback)

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

המשימה הושלמה: נתוני ה-payload של ה-callback שהצליח

כאשר היצירה מצליחה, ה-callback יכיל את הסטטוס status=completed. השתמש ב-id כדי לזהות את המשימה וב-data.results כדי לקבל את כתובות ה-URL של הווידאו. יש להוריד ולשמור את התוצאות לפני הזמן המצוין ב-data.video_expires_at.

השדה created_at מציין את זמן יצירת האירוע ו-task_created_at את זמן יצירת המשימה, בשניות Unix. הדוגמאות מציגות שדות מומלצים; התגובה עשויה לכלול שדות נוספים.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

המשימה נכשלה: נתוני ה-payload של ה-callback שנכשל

כאשר היצירה נכשלת, ה-callback יכיל את הסטטוס status=failed. השתמש ב-id כדי לזהות את המשימה, ב-failed_reason כדי לראות את סיבת הכתב וב-credits_refunded כדי לראות את כמות הקרדיטים שזוכתה.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed",
  "credits_refunded": 50
}

דוגמה לקוד קליטה (Receiver)

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

דוגמה זו ב-Next.js קוראת את גוף ה-JSON של ה-callback ומטפלת ישירות במשימות שהושלמו או נכשלו. מומלץ להוסיף שמירה בבסיס נתונים ומניעת כפילויות של מזהי משימות (task-ID deduplication) באפליקציה שלך; מומלץ להעביר עבודות איטיות לתור (queue) לפני החזרת אישור על קבלת ה-callback.

מגבלות ודרישות מדיה

  • כל כתובות ה-URL של המדיה והקריאות החוזרות חייבות להיות כתובות HTTPS ציבוריות. הימנעו משימוש ב-localhost, כתובות IP פרטיות או קבצים הדורשים עוגיות (cookies) או התחברות. כתובות URL של סרטוני/קובצי אודיו להתייחסות חייבות להוביל ישירות לקובץ המדיה לקריאה.
  • במצב reference-to-video, ספקו לפחות קלט התייחסות אחד, ולא יותר מ-30 תמונות, 10 סרטונים, 10 קובצי אודיו ו-50 חומרי מקור סך הכל. אורך הווידאו הכולל ואורך האודיו הכולל של קלטי ההתייחסות חייבים להיות לכל היותר 30 שניות כל אחד.
  • מצב text-to-video מתעלם מכל קלטי המדיה. מצב image-to-video מעביר רק את תמונות הפריים הראשון/האחרון ומתעלם מהתייחסויות לווידאו ואודיו. השתמשו ב-reference-to-video כדי לשלב סוגי מדיה שונים.
  • כל סרטון או קובץ אודיו להתייחסות חייב להיות באורך של 2–30 שניות. עבור דוגמאות של עריכת וידאו, השתמשו בקטעי מקור של לפחות 4 שניות.

דרישות לתמונות

  • נפח כל תמונה חייב להיות קטן מ-30 MB.
  • פורמטים נתמכים: jpeg, png, webp, bmp, tiff, gif.
  • יחס גובה-רוחב (רוחב ÷ גובה): בין 0.4 ל-2.5, כולל.
  • הרוחב והגובה חייבים להיות בין 300 ל-6,000 פיקסלים כל אחד, כולל.

דרישות לווידאו

  • פורמטים נתמכים: mp4, mov.
  • נפח כל סרטון לא יעלה על 100 MB.
  • קצב פריימים: 24 עד 60 FPS, כולל.
  • יחס גובה-רוחב (רוחב ÷ גובה): בין 0.4 ל-2.5, כולל.
  • סך הפיקסלים (רוחב × גובה): בין 407,696 ל-8,295,044, כולל. לדוגמה, 614 × 664 = 407,696 וכן 3,326 × 2,494 = 8,295,044. אלו הן דוגמאות למספר הפיקסלים הכולל, ולא דרישות קשיחות לרוחב ולגובה.

דרישות לאודיו

  • פורמטים נתמכים: wav, mp3.
  • נפח כל קובץ שמע לא יעלה על 15 MB.