Generează videoclipuri, imagini și muzică din propriul cod

Trei pași de la zero la un videoclip finalizat. Fiecare cerere este HTTPS simplu cu JSON, deci orice limbaj sau unealtă funcționează.

1. 1

   Creează o cheie

   Deschide pagina API din contul tău și creează o cheie. Cheia completă este afișată o singură dată, deci salveaz-o într-o variabilă de mediu numită API_KEY.

   Creează o cheie
2. 2

   Trimite o sarcină

   Trimite modelul, un prompt și orice opțiuni. Creditele se scad o singură dată, la trimitere, iar răspunsul îți spune câte și ce a rămas.

   cURLJavaScriptPython

   Copiază

   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": "Un dolly lent printr-o stradă neon plină de ploaie noaptea, reflexii pe asfalt umed, cinematic",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Verifică până e gata

   Verifică sarcina la câteva secunde. Când starea este reușită, descarcă fișierul de la output_url. Dacă a eșuat, creditele sunt deja înapoi în soldul tău.

   cURLJavaScriptPython

   Copiază

   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

Trimite cheia ta în antetul Authorization al fiecărei cereri. Cheile încep cu nm_live_ și aparțin unui singur cont.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

URL de bază

Toate punctele finale sunt sub https://novamotions.com/api/v1 și returnează JSON.

Păstrează cheile secrete

Apelează API-ul de pe serverul tău, niciodată dintr-un browser sau o aplicație mobilă. O cheie revocată încetează să funcționeze imediat.

Un singur sold

Apelurile API consumă creditele proprietarului cheii, același sold folosit de studio. Se aplică și limitele planului pentru fiecare generație.

URL-uri media

Imaginile, videoclipurile și audio pe care le trimiți trebuie să fie URL-uri publice https care se încarcă fără cookie-uri sau autentificare.

Toate modelele oferite de API, cu modurile, duratele, rezoluțiile, raporturile de aspect, suportul audio, limitele de referință și cel mai mic preț în credite. Folosește-l pentru a construi un selector de modele în loc să codifici opțiunile manual.

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

Creditele pe care proprietarul cheii le poate cheltui acum, împărțite pe pool-uri cu datele lor de expirare, plus planul curent.

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

Text în videoclip, imagine în videoclip (un cadru de start și opțional un cadru final) sau referință la videoclip (imagini, clipuri și audio care ghidează rezultatul). Modul este ales din inputuri dacă îl omiți.

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": "Un dolly lent printr-o stradă neon plină de ploaie noaptea, reflexii pe asfalt umed, cinematic",
    "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
}

Text în imagine sau editează o imagine existentă cu un prompt. Poți cere până la patru imagini per cerere, fiecare fiind o sarcină separată.

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": "Fotografie de studio a unei cești ceramice de cafea pe stejar, lumină moale de fereastră, adâncime mică de câmp",
    "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
}

O melodie completă dintr-o descriere, cu versurile tale sau instrumentală.

curl -X POST https://novamotions.com/api/v1/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-music",
    "prompt": "Lo-fi hip hop cald cu pian moale, zgomot de vinil și un groove relaxat de noapte târzie",
    "duration": 60,
    "instrumental": false
  }'

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

Verifică o sarcină după id. Odată ce starea este reușită, output_url indică fișierul finalizat. Verificarea folosește limita de citire, deci nu consumă din bugetul de trimitere.

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": "Un dolly lent printr-o stradă neon plină de ploaie noaptea, reflexii pe asfalt umed, cinematic",
  "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"
}

Sarcinile create prin API în ultimele 30 de zile, cele mai noi primele, cu același format ca o sarcină individuală. Trimite next_cursor ca cursor pentru a încărca pagina următoare.

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": "Un dolly lent printr-o stradă neon plină de ploaie noaptea, reflexii pe asfalt umed, cinematic",
      "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
}

O sarcină trece de la queued la running și se încheie ca succeeded sau failed. Oprește interogarea la oricare dintre aceste stări finale.

queued

Acceptată și așteaptă un slot de redare. Continuă interogarea.

running

Se redă acum. progresul merge de la 0 la 99.

succeeded

Finalizat. output_url și thumbnail_url indică fișierele terminate.

failed

S-a încheiat fără rezultat. error explică motivul și refunded este true, creditele sunt returnate în soldul tău.

Fiecare eroare are aceeași structură. Ramifică după cod și afișează mesajul pentru utilizator. O sarcină acceptată poate eșua ulterior, deci verifică-i statusul când interoghezi.

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

Limitele se calculează per cheie pe o fereastră mobilă de un minut. Peste limită primești HTTP 429 cu un antet Retry-After în secunde. Fiecare răspuns conține antetele X-RateLimit ca să poți încetini înainte de limită.

Trimite

30 pe minut

Crearea de videoclipuri, imagini și cântece.

Citește

120 pe minut

Sarcini, sold și modele. Contorizate separat de trimiteri.

În execuție simultan

3

Sarcini per cont care se redau în același timp.

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

Modelele pe care le poți folosi astăzi cu slug-urile și cel mai mic preț. Endpoint-ul modelelor returnează aceeași listă cu toate opțiunile.