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

Три шага от нуля до готового видео. Каждый запрос — обычный 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-ссылками, доступными без куки или входа в систему.

Все модели, доступные через 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

Сейчас рендерится. Прогресс от 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

Модели, которые вы можете использовать сегодня, с их идентификаторами и минимальной ценой. Эндпоинт моделей возвращает тот же список со всеми опциями.