API ציבורי

צור וידאו, תמונות ומוזיקה מהקוד שלך

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

קבל מפתח API התחלה מהירה

כתובת בסיסhttps://novamotions.com/api/v1

התחלה מהירה

שלושה שלבים מאפס לווידאו מוכן. כל בקשה היא HTTPS פשוט עם JSON, כך שכל שפה או כלי מתאימים.

1
צור מפתח
פתח את דף ה-API בחשבונך וצור מפתח. המפתח המלא מוצג פעם אחת בלבד, אז שמור אותו במשתנה סביבה בשם API_KEY.
צור מפתח

שלח משימה

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

curl -X POST https://novamotions.com/api/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-pro",
    "prompt": "צילום דולי איטי ברחוב ניאון גשום בלילה, השתקפויות על אספלט רטוב, סגנון קולנועי",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

בדוק עד שהמשימה מוכנה

בדוק את המשימה כל כמה שניות. כשהסטטוס הוא הצלחה, הורד את הקובץ מ-output_url. אם נכשלה, הקרדיטים כבר הוחזרו ליתרה שלך.

TASK_ID=your_task_id
while true
do
  TASK=$(curl -s https://novamotions.com/api/v1/tasks/$TASK_ID -H "Authorization: Bearer $API_KEY")
  STATUS=$(echo "$TASK" | jq -r .status)
  echo "$STATUS"
  if [ "$STATUS" = "succeeded" ] || [ "$STATUS" = "failed" ]
  then
    echo "$TASK" | jq
    break
  fi
  sleep 5
done

אימות

שלח את המפתח בכותרת Authorization של כל בקשה. מפתחות מתחילים ב-nm_live_ ושייכים לחשבון אחד.

HTTP

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

כתובת בסיס: כל נקודות הקצה נמצאות תחת https://novamotions.com/api/v1 ומחזירות JSON.
שמור על סודיות המפתחות: קרא ל-API מהשרת שלך, לעולם לא מדפדפן או אפליקציה ניידת. מפתח מבוטל מפסיק לעבוד מיד.
יתרה אחת: קריאות API מוציאות קרדיטים של בעל המפתח, אותה יתרה שהסטודיו משתמש בה. מגבלות תוכנית ליצירה חלות גם כן.
כתובות מדיה: תמונות, וידאו ואודיו שאתה שולח חייבים להיות כתובות https ציבוריות שנפתחות ללא עוגיות או התחברות.

רשימת דגמים

GET/api/v1/models

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

בקשה

curl https://novamotions.com/api/v1/models \
  -H "Authorization: Bearer $API_KEY"

תגובה

JSON

{
  "object": "list",
  "data": [
    {
      "slug": "seedance-2-pro",
      "name": "Seedance 2.0 Pro",
      "kind": "video",
      "endpoint": "/api/v1/videos",
      "available": true,
      "modes": [
        "text-to-video",
        "image-to-video",
        "reference-to-video"
      ],
      "durations": [
        4,
        5,
        6,
        8,
        10,
        12,
        15
      ],
      "default_duration": 5,
      "resolutions": [
        "480p",
        "720p",
        "1080p",
        "4K"
      ],
      "aspect_ratios": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4",
        "21:9"
      ],
      "audio": {
        "supported": true,
        "extra_credits": 20
      },
      "references": {
        "images": 9,
        "videos": 3,
        "audio": 3,
        "end_frame": true
      },
      "max_count": 4,
      "prompt_max_length": 10000,
      "from_credits": 35
    }
  ]
}

בדוק יתרה

GET/api/v1/balance

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

בקשה

curl https://novamotions.com/api/v1/balance \
  -H "Authorization: Bearer $API_KEY"

תגובה

JSON

{
  "object": "balance",
  "balance": 1175,
  "never_expiring": 375,
  "next_expiry": "2026-11-17T00:00:00.000Z",
  "pools": [
    {
      "source": "subscription",
      "remaining": 800,
      "granted": 2000,
      "expires_at": "2026-11-17T00:00:00.000Z"
    },
    {
      "source": "topup",
      "remaining": 375,
      "granted": 375,
      "expires_at": null
    }
  ],
  "plan": {
    "name": "Pro",
    "status": "active",
    "cycle": "monthly",
    "renews_or_ends_at": "2026-11-14T00:00:00.000Z"
  }
}

צור וידאו

POST/api/v1/videos

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

פרמטרים

modelstring
נדרשמזהה הדגם מנקודת הקצה של הדגמים.
promptstring
נדרשמה אמור לקרות בקליפ. אופציונלי ל-image-to-video, שם פריים ההתחלה מוביל.
modestring
אופציונליtext-to-video, image-to-video או reference-to-video. נבחר מהקלטים כשלא מצוין.
durationinteger
אופציונליאורך הקליפ בשניות. חייב להיות אחד מהמשכים של הדגם, אחרת ישתמש כברירת מחדל.
resolutionstring
אופציונלירזולוציית הפלט כמו 720p או 1080p, מתוך רשימת הדגם.
aspect_ratiostring
אופציונלי16:9, 9:16, 1:1, 4:3, 3:4 או 21:9, מתוך רשימת הדגמים. ברירת מחדל היא 16:9.
audioboolean
אופציונליצור פסקול עם דיאלוג, אפקטים ואווירה בדגמים התומכים בכך. מוסיף 20 קרדיטים. ברירת מחדל היא לא.
image_urlstring (URL)
אופציונלימסגרת התחלתית ליצירת וידאו מתמונה.
end_image_urlstring (URL)
אופציונלימסגרת סופית, בדגמים התומכים במסגרת ראשונה ואחרונה.
reference_image_urlsstring[]
אופציונליתמונות התייחסות ליצירת וידאו מהתייחסות, עד למגבלת הדגם.
reference_video_urlsstring[]
אופציונליקליפים להתייחסות ליצירת וידאו, עד למגבלת הדגם.
reference_audio_urlsstring[]
אופציונליאודיו שמנחה את הפסקול, עד למגבלת הדגם.
countinteger
אופציונליכמה סרטונים ליצור מאותה בקשה, מ-1 עד 4. כל אחד הוא משימה נפרדת ומחויב בנפרד.
seedinteger
אופציונליזרע קבוע לתוצאות חוזרות. כל פריט נוסף באצווה מקבל את הזרע הבא.

בקשה

curl -X POST https://novamotions.com/api/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-pro",
    "prompt": "צילום דולי איטי ברחוב ניאון גשום בלילה, השתקפויות על אספלט רטוב, סגנון קולנועי",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

תגובה

JSON

{
  "tasks": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "status": "queued",
      "credits": 44,
      "url": "https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2"
    }
  ],
  "credits_charged": 44,
  "balance": 1131
}

צור תמונות

POST/api/v1/images

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

פרמטרים

modelstring
נדרשמזהה הדגם מנקודת הקצה של הדגמים.
promptstring
נדרשמה התמונה צריכה להראות, או איך לשנות את התמונה שאתה מוסר.
modestring
אופציונליטקסט לתמונה או עריכת תמונה. נבחר מתוך הקלטים שלך אם לא צויין.
resolutionstring
אופציונלי1K, 2K או 4K, מתוך רשימת הדגמים.
aspect_ratiostring
אופציונלייחס גובה-רוחב מתוך רשימת הדגמים, כולל אוטומטי בדגמים התומכים.
image_urlstring (URL)
אופציונליהתמונה לעריכה. נדרש לעריכת תמונה.
reference_image_urlsstring[]
אופציונליתמונות התייחסות נוספות לעריכה, עד למגבלת הדגם.
countinteger
אופציונלימספר תמונות לכל בקשה, מ-1 עד 4. כל אחת היא משימה נפרדת.
seedinteger
אופציונליזרע קבוע לתוצאות חוזרות. כל פריט נוסף באצווה מקבל את הזרע הבא.

בקשה

curl -X POST https://novamotions.com/api/v1/images \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "צילום מוצר בסטודיו של ספל קפה קרמי על עץ אלון, אור חלון רך, עומק שדה רדוד",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "count": 1
  }'

תגובה

JSON

{
  "tasks": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "status": "queued",
      "credits": 3,
      "url": "https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2"
    }
  ],
  "credits_charged": 3,
  "balance": 1172
}

צור שיר

POST/api/v1/music

שיר מלא מתיאור, עם מילים משלך או ככלי נגינה בלבד.

פרמטרים

modelstring
נדרשמזהה הדגם מנקודת הקצה של הדגמים.
promptstring
נדרשז'אנר, מצב רוח, כלים וקצב השיר.
durationinteger
אופציונליאורך השיר בשניות, מתוך אורכי הדגם.
lyricsstring
אופציונלימילות השיר שלך. השאר ריק כדי שהדגם יכתוב אותן.
instrumentalboolean
אופציונליצור שיר ללא שירה. ברירת מחדל היא לא.

בקשה

curl -X POST https://novamotions.com/api/v1/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-music",
    "prompt": "היפ הופ לופ-פיי חם עם פסנתר רך, חריקות ויניל וגרוב רגוע של לילה מאוחר",
    "duration": 60,
    "instrumental": false
  }'

תגובה

JSON

{
  "tasks": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "status": "queued",
      "credits": 11,
      "url": "https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2"
    }
  ],
  "credits_charged": 11,
  "balance": 1164
}

קבל משימה

GET/api/v1/tasks/{id}

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

בקשה

curl https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2 \
  -H "Authorization: Bearer $API_KEY"

תגובה

JSON

{
  "id": "cmtask8k2x0001ab7c9d0e1f2",
  "object": "task",
  "kind": "video",
  "model": "seedance-2-pro",
  "mode": "text-to-video",
  "status": "succeeded",
  "progress": 100,
  "prompt": "צילום דולי איטי ברחוב ניאון גשום בלילה, השתקפויות על אספלט רטוב, סגנון קולנועי",
  "params": {
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": false,
    "seed": null
  },
  "output_url": "https://novamotions.com/uploads/videos/2026/10/example.mp4",
  "thumbnail_url": "https://novamotions.com/uploads/videos/2026/10/example.jpg",
  "width": 1280,
  "height": 720,
  "duration_seconds": 5,
  "credits": 44,
  "refunded": false,
  "error": null,
  "created_at": "2026-10-18T09:30:00.000Z",
  "completed_at": "2026-10-18T09:31:12.000Z"
}

רשימת משימות

GET/api/v1/tasks

משימות שיצרת דרך ה-API ב-30 הימים האחרונים, החדשות ביותר תחילה, באותו פורמט כמו משימה בודדת. העבר next_cursor כ-cursor לטעינת העמוד הבא.

פרמטרים

limitinteger
אופציונליתוצאות לעמוד, מ-1 עד 50. ברירת מחדל היא 20.
cursorstring
אופציונליערך next_cursor מהעמוד הקודם.
statusstring
אופציונלירק משימות במצב זה: בתור, בפעולה, הושלם או נכשל.

בקשה

curl https://novamotions.com/api/v1/tasks?limit=20 \
  -H "Authorization: Bearer $API_KEY"

תגובה

JSON

{
  "object": "list",
  "data": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "object": "task",
      "kind": "video",
      "model": "seedance-2-pro",
      "mode": "text-to-video",
      "status": "succeeded",
      "progress": 100,
      "prompt": "צילום דולי איטי ברחוב ניאון גשום בלילה, השתקפויות על אספלט רטוב, סגנון קולנועי",
      "params": {
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": false,
        "seed": null
      },
      "output_url": "https://novamotions.com/uploads/videos/2026/10/example.mp4",
      "thumbnail_url": "https://novamotions.com/uploads/videos/2026/10/example.jpg",
      "width": 1280,
      "height": 720,
      "duration_seconds": 5,
      "credits": 44,
      "refunded": false,
      "error": null,
      "created_at": "2026-10-18T09:30:00.000Z",
      "completed_at": "2026-10-18T09:31:12.000Z"
    }
  ],
  "next_cursor": null
}

מצבי משימות

משימה עוברת מ'בתור' ל'בפעולה' ומסתיימת כ'הושלם' או 'נכשל'. הפסק את הבדיקה במצב סופי.

queued: התקבלה וממתינה לתור לעיבוד. המשך לבדוק.
running: מתבצע עיבוד כעת. ההתקדמות מ-0 עד 99.
succeeded: הושלם. output_url ו-thumbnail_url מפנים לקבצים המוגמרים.
failed: הסתיים ללא תוצאה. error מסביר למה ו-refunded הוא true, הקרדיטים הוחזרו למאזן שלך.

קודי שגיאה

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

תגובה לשגיאה

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request. Top up or renew your plan, then retry.",
    "needed": 44,
    "balance": 14
  }
}

HTTPקודמשמעות

400invalid_jsonהגוף אינו אובייקט JSON תקין.
401unauthorizedאין מפתח Bearer בכותרת Authorization.
401invalid_api_keyהמפתח אינו קיים או שגוי.
401key_revokedהמפתח בוטל. צור מפתח חדש.
402insufficient_creditsאין מספיק קרדיטים לבקשה זו. התגובה כוללת את הנדרש והיתרה.
403plan_limit_exceededהבקשה חורגת מהמגבלה היומית של התוכנית. הפחת את האורך או הרזולוציה.
403account_suspendedהחשבון שמחזיק במפתח מושעה.
403api_disabledממשק ה-API כבוי כרגע.
404not_foundהמשימה או נקודת הקצה לא קיימים בחשבון זה.
404model_not_foundאין דגם עם מזהה זה. בדוק את נקודת הקצה של הדגמים.
409too_many_runningכבר יש 3 משימות פעילות בחשבון זה. המתן לסיום אחת מהן.
422invalid_requestשדה חסר או מסוג שגוי. details מפרט כל בעיה.
422wrong_endpointהדגם שייך לנקודת קצה אחרת, לדוגמה דגם תמונה שנשלח לנקודת וידאו.
422invalid_modeהמצב אינו מוכר לנקודת הקצה הזו.
422mode_not_supportedהדגם אינו תומך במצב זה.
422prompt_requiredמצב זה דורש טקסט בקשה.
422image_requiredמצב זה דורש image_url.
429rate_limitedבקשות רבות מדי. המתן את מספר השניות ב-Retry-After ואז נסה שוב.
500internal_errorאירעה תקלה אצלנו. נסה שוב בעוד רגע.
503service_busyהמערכת עמוסה כרגע. נסה שוב בעוד מספר דקות.

קרדיטים והחזרים

מחויב פעם אחת בעת השליחה

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

החזר מלא על משימות שנכשלו

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

מגבלות התוכנית חלות

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

מגבלות קצב

המגבלות נספרות לפי מפתח במשך דקה מתגלגלת. מעבר למגבלה תקבל HTTP 429 עם כותרת Retry-After בשניות. כל תגובה כוללת כותרות X-RateLimit כדי שתוכל להאט לפני כן.

שליחה: 30 לדקה; יצירת סרטונים, תמונות ושירים.
קריאה: 120 לדקה; משימות, יתרה ודגמים. נספרים בנפרד מהשליחות.
משימות פעולות בו זמנית: 3; משימות לעיבוד בו זמנית לחשבון.

כותרות הגבלת קצב

HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 42

מודלים

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

מודלSlugסוגמ

Seedance 2.5seedance-2-5וידאו45 קרדיטים
Seedance 2.0 Proseedance-2-proוידאו35 קרדיטים
Seedance 2.0 Miniseedance-2-miniוידאו24 קרדיטים
Wan 3.0wan-3וידאו46 קרדיטים
MiniMax H3minimax-h3וידאו30 קרדיטים
Kling 3kling-3וידאו30 קרדיטים
Seedance 1.5 Proseedance-1-5-proוידאו31 קרדיטים
Seedance 1.0seedance-1וידאו32 קרדיטים
Kling O3kling-o3וידאו46 קרדיטים
Kling 2.6kling-2-6וידאו41 קרדיטים
Wan 2.7wan-2-7וידאו35 קרדיטים
Wanwanוידאו32 קרדיטים
Grokgrok-videoוידאו47 קרדיטים
Veo 3veo-3וידאו42 קרדיטים
GPT Image 2.5gpt-image-2-5תמונה4 קרדיטים
GPT Image 2gpt-image-2תמונה3 קרדיטים
Seedream 5 Proseedream-5-proתמונה4 קרדיטים
Seedream 5seedream-5תמונה3 קרדיטים
Nano Banana Pronano-banana-proתמונה5 קרדיטים
Nano Banana 2nano-banana-2תמונה3 קרדיטים
Nano Banana 2 Litenano-banana-2-liteתמונה2 קרדיטים
AI Musicai-musicמוזיקה6 קרדיטים

מוכן להתחיל?

צור מפתח בחשבונך ושלח את הבקשה הראשונה תוך דקה.

צור מפתח API