Seedance 2.5 Flash

יצירת סרטונים באורך 4–30 שניות ב־480p או 720p מטקסט, מפריים ראשון/אחרון או מרפרנסים מולטימודליים, או עריכת סרטון מקור אחד.

Seedance 2.5 Flash תומך ביצירת וידאו מטקסט, ביצירה מפריים ראשון/אחרון, ביצירה מרפרנסים ובעריכת וידאו. השתמש ב־dreamina-seedance-2-5-flash ברמת Default. שלח מדיה ככתובות HTTP או HTTPS ציבוריות ללא פרטי גישה. שמור את מזהה המשימה שהוחזר ושלח שאילתות לגביו כדי לקבל את הסרטון המוגמר.

ראה את סביבת ההתנסות והמחירים בזמן אמת, מפרט OpenAPI ומדריך התמחור.

דוגמה מהירה

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

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

פרמטרים

model ו־content הם שדות חובה. כל שאר השדות אופציונליים. ערכי null מפורשים ושדות לא מוכרים נדחים.

שדה	סוג	ברירת מחדל	מגבלות
`model`	מחרוזת	חובה	`dreamina-seedance-2-5-flash`
`content`	מערך	חובה	לפחות פריט טקסט אחד שאינו ריק; פריטי מדיה מחייבים תפקיד.
`resolution`	מחרוזת	`720p`	`480p` או `720p`.
`duration`	מספר שלם	`5`, או `-1` לעריכה	יצירה: 4–30 שניות. עריכה: השמט או השתמש ב־`-1`; הפלט תואם למקור.
`ratio`	מחרוזת	`16:9`, או `adaptive` לפריימים/עריכה	יצירה מטקסט/רפרנסים: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`. פריים ראשון/אחרון ועריכה: רק `adaptive`.
`generate_audio`	בוליאני	`true`	הפעלה או השבתה של אודיו שנוצר; אין לכך השפעה על התעריף.
`omni_reference_task_type`	מחרוזת	`generate`	`generate` או `edit`. עריכה מחייבת סרטון אחד בדיוק.
`content_filter`	בוליאני	`true`	רק `true` מתקבל; אין צורך בפקד בסביבת ההתנסות.

לפי התיעוד, הנחיות מוגבלות ל־10,000 טוקנים לכל היותר. לא מצוין טוקנייזר ציבורי, ולכן אסור להתייחס למספר התווים כאל מספר הטוקנים המדויק.

תוכן ומצבים

טקסט משתמש ב־{"type":"text","text":"Describe the shot"}. תמונות, סרטונים ואודיו משתמשים בכתובת URL מקוננת ובתפקיד מפורש:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

מצב	תוכן	מסגור ומשך
וידאו מטקסט	טקסט בלבד	יחס קבוע; 4–30 שניות.
פריים ראשון/אחרון	טקסט ותמונת `first_frame` אחת, ובאופן אופציונלי תמונת `last_frame` אחת	`adaptive`; 4–30 שניות. פריים אחרון מחייב פריים ראשון.
יצירה מרפרנסים	טקסט ופריטי `reference_image`, `reference_video` או `reference_audio`	יחס קבוע; 4–30 שניות. עד 10 תמונות, 5 סרטונים ו־5 קטעי אודיו.
עריכת וידאו	טקסט, `reference_video` אחד בדיוק, תמונות/אודיו כרפרנס לפי הצורך; סוג משימה `edit`	`adaptive`; משך מושמט או `-1`.

פריטי וידאו משתמשים ב־type: "video_url", ב־video_url: {"url": "..."} וב־role: "reference_video"; פריטי אודיו משתמשים ב־audio_url וב־reference_audio באותו מבנה. אי אפשר לשלב פריים ראשון/אחרון עם מדיית רפרנס. פקדי טיוטה, הארכה, 1080p, סימן מים, seed ופלט של הפריים האחרון אינם זמינים בשילוב הזה. אין תמיכה ב־callbacks.

מגבלות מדיה

מדיה	פורמטים	גודל ומשך
תמונה	JPEG, PNG, WebP	עד 30 MB; כל צלע 300–6,000 px; יחס רוחב/גובה 0.4–2.5.
וידאו	MP4, MOV	עד 200 MB; ‏24–60 FPS; כל צלע 300–6,000 px; יחס 0.4–2.5; ‏409,600–8,295,044 פיקסלים. רפרנסים: 2–30 שניות כל אחד, לכל היותר 30 שניות במצטבר. מקור לעריכה: 4–30 שניות.
אודיו	WAV, MP3	עד 15 MB; ‏2–30 שניות כל אחד, לכל היותר 30 שניות במצטבר.

הקבצים חייבים להיות נגישים לקריאה לפני השליחה. משך הווידאו נמדד מהמדיה לצורך חישוב החיוב. השתמש בכתובות URL ציבוריות יציבות.

תגובת המשימה ותשאול מחזורי

היצירה מחזירה id, ‏model, ‏status ו־created_at. שלח שאילתות לגבי אותה משימה עד להשלמתה:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

הסטטוס הוא processing, ‏completed או failed. בהצלחה, קרא את output.video_url כדי לקבל את הסרטון המאוחסן. בכישלון, קרא את error.code ואת error.message. תגובות ציבוריות אינן כוללות עלויות. חריגה מזמן ההמתנה בתשאול אינה מוכיחה שהיצירה נכשלה: שמור את מזהה המשימה ושלח שאילתה נוספת לגביו במקום לשלוח בקשת יצירה נוספת.

חיוב

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

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

ראה מחזור חיי משימה וקודי שגיאה לתגובות נפוצות ולהנחיות לניסיונות חוזרים.