Створюйте відео, зображення та музику за допомогою власного коду

Три кроки від нуля до готового відео. Кожен запит — це звичайний HTTPS з JSON, тому можна використовувати будь-яку мову чи інструмент.

1. 1

   Створіть ключ

   Відкрийте сторінку API у вашому акаунті та створіть ключ. Повний ключ показується лише один раз, тому збережіть його у змінній середовища з назвою API_KEY.

   Створити ключ
2. 2

   Надішліть завдання

   Вкажіть модель, підказку та будь-які опції. Кредити списуються одразу при відправці, а у відповіді ви побачите скільки списано і скільки залишилось.

   cURLJavaScriptPython

   Копіювати

   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"
     }'

3. 3

   Опитуйте, доки не буде готово

   Перевіряйте статус завдання кожні кілька секунд. Коли статус — succeeded, завантажте файл за output_url. Якщо завдання не вдалося, кредити вже повернені на ваш баланс.

   cURLJavaScriptPython

   Копіювати

   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_ і належать одному акаунту.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

Базова URL

Всі ендпоінти знаходяться за адресою https://novamotions.com/api/v1 і повертають JSON.

Зберігайте ключі в секреті

Викликайте API з вашого сервера, ніколи не з браузера чи мобільного додатку. Відкликаний ключ одразу перестає працювати.

Один баланс

Виклики API витрачають кредити власника ключа, той самий баланс, що і у студії. Також застосовуються обмеження плану на генерацію.

URL медіа

Зображення, відео та аудіо, які ви передаєте, мають бути публічними https URL, що завантажуються без куків чи входу в акаунт.

Всі моделі, які підтримує API, з їх режимами, тривалістю, роздільною здатністю, співвідношенням сторін, підтримкою аудіо, обмеженнями на референси та найнижчою ціною в кредитах. Використовуйте для створення вибору моделі замість жорсткого кодування опцій.

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

{
  "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
    }
  ]
}

Кредити, які власник ключа може витратити зараз, розподілені по пулах з датами закінчення, а також поточний план.

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

{
  "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"
  }
}

Текст у відео, зображення у відео (початковий кадр і за бажанням кінцевий) або референс для відео (зображення, кліпи та аудіо, що керують результатом). Режим обирається за вхідними даними, якщо його не вказано.

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"
  }'

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

Текст у зображення або редагування існуючого зображення за підказкою. Можна запросити до чотирьох зображень за один запит, кожне — окреме завдання.

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
  }'

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

Повна пісня за описом, з вашими власними текстами або інструментальна.

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
  }'

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

Опитуйте завдання за його id. Коли статус — succeeded, output_url вказує на готовий файл. Опитування використовує ліміт читання, тому не витрачає ваш бюджет на відправку.

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

{
  "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"
}

Завдання, створені вами через API за останні 30 днів, новіші зверху, з тією ж структурою, що й одне завдання. Передайте next_cursor як cursor для завантаження наступної сторінки.

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

{
  "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 і завершується як succeeded або failed. При досягненні кінцевого стану припиніть опитування.

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 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

Моделі, які ви можете використовувати сьогодні, з їхніми ідентифікаторами та найнижчою ціною. Ендпоінт моделей повертає той самий список з усіма опціями.