Generuj wideo, obrazy i muzykę za pomocą własnego kodu

Trzy kroki od zera do gotowego wideo. Każde żądanie to zwykłe HTTPS z JSON, więc możesz użyć dowolnego języka lub narzędzia.

1. 1

   Utwórz klucz

   Otwórz stronę API w swoim koncie i utwórz klucz. Pełny klucz jest pokazany tylko raz, więc zapisz go w zmiennej środowiskowej o nazwie API_KEY.

   Utwórz klucz
2. 2

   Wyślij zadanie

   Podaj model, prompt i opcje. Kredyty są pobierane jednorazowo przy wysłaniu, a odpowiedź informuje ile ich zużyto i ile pozostało.

   cURLJavaScriptPython

   Kopiuj

   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": "Powolny ruch kamery przez deszczową neonową ulicę nocą, odbicia na mokrym asfalcie, kinowy klimat",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Sprawdzaj aż będzie gotowe

   Sprawdzaj status zadania co kilka sekund. Gdy status to succeeded, pobierz plik z output_url. Jeśli zadanie się nie powiodło, kredyty są już zwrócone na twoje saldo.

   cURLJavaScriptPython

   Kopiuj

   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

Przesyłaj swój klucz w nagłówku Authorization każdego żądania. Klucze zaczynają się od nm_live_ i należą do jednego konta.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

Podstawowy URL

Wszystkie punkty końcowe działają pod adresem https://novamotions.com/api/v1 i zwracają JSON.

Chroń klucze

Wywołuj API ze swojego serwera, nigdy z przeglądarki lub aplikacji mobilnej. Cofnięty klucz przestaje działać natychmiast.

Jedno saldo

Wywołania API zużywają kredyty właściciela klucza, to samo saldo, które używa studio. Obowiązują też limity planu na generację.

URL-e mediów

Obrazy, wideo i audio, które przesyłasz, muszą być publicznymi adresami https, które ładują się bez ciasteczek i logowania.

Każdy model dostępny w API, z trybami, długościami, rozdzielczościami, proporcjami, obsługą audio, limitami referencji i najniższą ceną w kredytach. Użyj do budowy wyboru modelu zamiast na sztywno wpisywać opcje.

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

Kredyty, które właściciel klucza może teraz wydać, podzielone na pule z datami ważności oraz aktualny plan.

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

Tekst na wideo, obraz na wideo (klatka startowa i opcjonalnie końcowa) lub odniesienie do wideo (obrazy, klipy i audio kierujące wynikiem). Tryb wybierany jest na podstawie wejść, jeśli go pominiesz.

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": "Powolny ruch kamery przez deszczową neonową ulicę nocą, odbicia na mokrym asfalcie, kinowy klimat",
    "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
}

Tekst na obraz lub edycja istniejącego obrazu za pomocą promptu. Możesz poprosić o maksymalnie cztery obrazy na żądanie, każdy to osobne zadanie.

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": "Zdjęcie studyjne produktu: ceramiczny kubek do kawy na dębowym stole, miękkie światło okienne, płytka głębia ostrości",
    "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
}

Pełna piosenka na podstawie opisu, z własnymi tekstami lub instrumentalna.

curl -X POST https://novamotions.com/api/v1/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-music",
    "prompt": "Ciepły lo-fi hip hop z delikatnym pianinem, trzaskiem winyla i zrelaksowanym nocnym groove'em",
    "duration": 60,
    "instrumental": false
  }'

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

Sprawdzaj zadanie po jego ID. Gdy status to succeeded, output_url wskazuje na gotowy plik. Sprawdzanie używa limitu odczytu, więc nie zużywa limitu wysyłania.

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": "Powolny ruch kamery przez deszczową neonową ulicę nocą, odbicia na mokrym asfalcie, kinowy klimat",
  "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"
}

Zadania utworzone przez API w ciągu ostatnich 30 dni, od najnowszych, o takim samym kształcie jak pojedyncze zadanie. Przekaż next_cursor jako cursor, aby załadować kolejną stronę.

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": "Powolny ruch kamery przez deszczową neonową ulicę nocą, odbicia na mokrym asfalcie, kinowy klimat",
      "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
}

Zadanie przechodzi od queued do running i kończy się jako succeeded lub failed. Przestań odpytywać przy stanie końcowym.

queued

Zaakceptowane i czekające na slot renderowania. Kontynuuj odpytywanie.

running

Renderowanie w toku. postęp od 0 do 99.

succeeded

Gotowe. output_url i thumbnail_url wskazują na gotowe pliki.

failed

Zakończone bez wyniku. error wyjaśnia powód, a refunded jest true, kredyty wracają na twoje konto.

Każdy błąd ma ten sam format. Rozgałęźiaj po kodzie i pokaż komunikat użytkownikowi. Zadanie zaakceptowane może później nie powieść się, więc sprawdzaj status przy odpytywaniu.

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

Limity liczone na klucz w ciągu minuty przesuwnej. Po przekroczeniu limitu otrzymujesz HTTP 429 z nagłówkiem Retry-After w sekundach. Każda odpowiedź zawiera nagłówki X-RateLimit, byś mógł zwolnić przed limitem.

Wysyłanie

30 na minutę

Tworzenie filmów, obrazów i piosenek.

Odczyt

120 na minutę

Zadania, saldo i modele. Liczone osobno od wysyłania.

Wykonywane jednocześnie

3

Zadań na konto renderowanych w tym samym czasie.

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

Modele, które możesz dziś wywołać wraz z ich identyfikatorami i najniższą ceną. Punkt końcowy modeli zwraca tę samą listę ze wszystkimi opcjami.