API

Seedance 2.0 API

וידאו

ממשק Seedance 2.0 API יוצר סרטונים באורך 4–15 שניות ברזולוציית 480p / 720p / 1080p / 4K מטקסט, מפריימים או מייחוס רב־מודאלי. מצב הייחוס מקבל עד 9 תמונות, 3 סרטונים ו־3 קובצי אודיו. כל תמונה מוגבלת ל־30 MB.

הרשאות

Bearerstringheaderחובה

מפתח API לאישור בקשות

גוף

application/json

modelstringחובה

seedance-2-0

input.promptstringחובה

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

input.frames_imagesstring[]אופציונלי

רשימה של כתובת HTTPS ציבורית אחת או שתיים לתמונות: פריים ראשון ואחריו פריים אחרון לבחירה. אין לשלב מצב זה עם reference_images, reference_videos או reference_audios.

עם input.frames_images, ‏Seedance 2.0 משתמש אוטומטית ביחס adaptive לפי הפריימים שסופקו.

מספר כתובות מרבי: 2.

גודל מרבי לכל תמונה: 30 MB.

דוגמה: ["https://example.com/first-frame.png","https://example.com/last-frame.png"]

input.reference_imagesstring[]אופציונלי

רשימת כתובות HTTPS ציבוריות לתמונות ייחוס. ניתן לשלב עם reference_videos ו־reference_audios, אך לא עם frames_images. שלחו מחרוזות URL, לא קבצים או base64.

מספר כתובות מרבי: 9.

גודל מרבי לכל תמונה: 30 MB.

דוגמה: ["https://example.com/your-image.png"]

input.reference_videosstring[]אופציונלי

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

מספר כתובות מרבי: 3.

דוגמה: ["https://example.com/your-video.mp4"]

input.reference_audiosstring[]אופציונלי

רשימת כתובות HTTPS ציבוריות לאודיו ייחוס. ניתן לשלב עם רשימות reference_* אחרות, אך לא עם frames_images.

מספר כתובות מרבי: 3.

דוגמה: ["https://example.com/your-audio.mp3"]

input.durationintegerאופציונלי

משך הסרטון בשניות שלמות, בין 4 ל־15. ברירת המחדל היא 5. צריכת הנקודות תלויה במשך.

ברירת מחדל: 5

4–15

input.resolutionstringאופציונלי

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

ברירת מחדל: 720p

480p720p1080p4k

input.aspect_ratiostringאופציונלי

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

ברירת מחדל: 16:9

16:99:161:13:44:321:9

input.soundbooleanאופציונלי

האם ליצור אודיו יחד עם הווידאו. ברירת המחדל היא false. שלחו ערך בוליאני של JSON, לא מחרוזת.

ברירת מחדל: false

דוגמאות בקשה

בחרו מצב אחד: ללא מדיה ליצירה מטקסט; frames_images לפריים ראשון ואחרון; או שילוב של reference_images, reference_videos ו־reference_audios ליצירה עם ייחוס. אין לשלב frames_images עם רשימות מדיה reference_*. כל המשאבים הם רשימות כתובות HTTPS ציבוריות, לא קבצים או base64. החליפו את כתובות example.com. שמרו data.task_id ובדקו ב־POST /api/v1/check עד completed או failed.

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-0",
  "input": {
    "prompt": "מכונית אספנות אדומה נוסעת בכביש חוף בשקיעה. המצלמה עוקבת בעדינות אחר צד המכונית ואור חם משתקף בים.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "sound": false
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedance-2-0",
    "status": "processing",
    "credits": 750
  }
}

בצעו polling לנקודת הקצה באמצעות מזהה המשימה שהוחזר עד שהמשימה תושלם או תיכשל. אנו ממליצים לבצע polling כל 5 שניות כדי לבדוק את הסטטוס העדכני.

POST /api/v1/check

{
  "task_id": "task_example"
}

תגובה

מצב המשימה שמוחזר מ־POST /api/v1/check. המזהים, כתובות ה־URL וחותמות הזמן להלן הם דוגמאות.

idstringחובה

מזהה המשימה בשדה data.id זהה ל־task_id שנשלח בבקשת הבדיקה.

statusstringחובה

completed מציין שהיצירה הצליחה ו־data.data מכיל את התוצאות. במצבים אחרים data.data הוא null.

failed_reasonstringאופציונלי

מוחזר רק כאשר status הוא failed ומסביר את סיבת הכישלון. שדה זה אינו מופיע ב־completed או ב־processing.

הושלמה · completed

כתובות ההורדה נמצאות ב־data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedance-2-0",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.mp4"
      ],
      "processing_time": 120
    }
  }
}

מצבים אחרים

ב־processing או ב־failed השדה data.data הוא null. הדוגמה מציגה failed: רק failed כולל failed_reason. המשיכו לבדוק ב־processing והפסיקו ב־failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedance-2-0",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

צריכת קרדיטים

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

נקודות לכל שנייה לחיוב לפי רזולוציה ומצב ייחוס וידאו.
יצירה	480P	720P	1080P	4K
ללא סרטוני ייחוס	80	150	400	500
עם סרטוני ייחוס	48	90	240	300

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

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

השדה credits בתשובה של POST /api/v1/create מציג את הקרדיטים שחויבו עבור המשימה.