API

Wan 3.0 API

וידאו

ממשק Wan 3.0 API יוצר סרטונים באורך 2–30 שניות ברזולוציית 480p / 720p / 1080p מטקסט, מפריימים או מייחוס רב־מודאלי. מצב הייחוס מקבל עד 10 תמונות, 5 סרטונים ו־5 קובצי אודיו. כל תמונה מוגבלת ל־30 MB.

הרשאות

Bearerstringheaderחובה

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

גוף

application/json

modelstringחובה

wan-3-0

input.promptstringחובה

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

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

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

מספר כתובות מרבי: 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ברירת מחדל: 5

2–30

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

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

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

480p720p1080p

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

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

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

16:99:161:13:44:3

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": "wan-3-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": "wan-3-0",
    "status": "processing",
    "credits": 600
  }
}

בצעו 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": "wan-3-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": "wan-3-0",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

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

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

נקודות לכל שנייה לחיוב לפי רזולוציה ומצב ייחוס וידאו.
יצירה	480P	720P	1080P
ללא סרטוני ייחוס	60	120	240
עם סרטוני ייחוס	60	120	240

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

ללא סרטון ייחוס: שניות שנוצרו × תעריף. עם סרטון ייחוס: (שניות שנוצרו + min(15, ceil(reference_video_duration))) × תעריף. התעריף לשנייה זהה; משך הייחוס מוסיף שניות לחיוב.

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