Genera video, immagini e musica dal tuo codice

Tre passaggi da zero a video finito. Ogni richiesta è HTTPS semplice con JSON, quindi funziona con qualsiasi linguaggio o strumento.

1. 1

   Crea una chiave

   Apri la pagina API nel tuo account e crea una chiave. La chiave completa viene mostrata una sola volta, quindi salvala in una variabile d’ambiente chiamata API_KEY.

   Crea una chiave
2. 2

   Invia un task

   Invia il modello, un prompt e le opzioni. I crediti vengono addebitati una sola volta, all’invio, e la risposta indica quanti ne restano e quali.

   cURLJavaScriptPython

   Copia

   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": "Una lenta carrellata in una strada al neon piovosa di notte, riflessi sull’asfalto bagnato, cinematografico",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Controlla finché non è pronto

   Controlla il task ogni pochi secondi. Quando lo stato è riuscito, scarica il file da output_url. Se è fallito, i crediti sono già stati riaccreditati.

   cURLJavaScriptPython

   Copia

   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

Invia la tua chiave nell’intestazione Authorization di ogni richiesta. Le chiavi iniziano con nm_live_ e appartengono a un account.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

URL base

Tutti gli endpoint sono sotto https://novamotions.com/api/v1 e restituiscono JSON.

Tieni segrete le chiavi

Chiama l’API dal tuo server, mai da un browser o app mobile. Una chiave revocata smette di funzionare subito.

Un saldo unico

Le chiamate API consumano i crediti del proprietario della chiave, lo stesso saldo usato dallo studio. Si applicano anche i limiti del piano per generazione.

URL media

Immagini, video e audio che invii devono essere URL https pubblici che si caricano senza cookie o login.

Tutti i modelli serviti dall’API, con modalità, durate, risoluzioni, rapporti d’aspetto, supporto audio, limiti di riferimento e il prezzo più basso in crediti. Usalo per costruire un selettore di modelli invece di codificare opzioni fisse.

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

I crediti che il proprietario della chiave può spendere ora, divisi in pool con le rispettive scadenze, più il piano attuale.

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

Da testo a video, da immagine a video (un fotogramma iniziale e opzionalmente uno finale) o da riferimento a video (immagini, clip e audio che guidano il risultato). La modalità viene scelta dagli input se la ometti.

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": "Una lenta carrellata in una strada al neon piovosa di notte, riflessi sull’asfalto bagnato, cinematografico",
    "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
}

Da testo a immagine, o modifica un’immagine esistente con un prompt. Puoi richiedere fino a quattro immagini per richiesta, ognuna è un task a sé.

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": "Foto prodotto in studio di una tazza di ceramica su quercia, luce soffusa da finestra, profondità di campo ridotta",
    "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
}

Una canzone completa da una descrizione, con testi tuoi o strumentale.

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 caldo con pianoforte morbido, crepitio di vinile e groove rilassato da tarda notte",
    "duration": 60,
    "instrumental": false
  }'

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

Controlla un task tramite il suo ID. Quando lo stato è riuscito, output_url punta al file finito. Il polling usa il limite di lettura, quindi non consuma il budget di invio.

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": "Una lenta carrellata in una strada al neon piovosa di notte, riflessi sull’asfalto bagnato, cinematografico",
  "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"
}

Task creati tramite API negli ultimi 30 giorni, dal più recente, con la stessa struttura di un singolo task. Passa next_cursor come cursor per caricare la pagina successiva.

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": "Una lenta carrellata in una strada al neon piovosa di notte, riflessi sull’asfalto bagnato, cinematografico",
      "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
}

Un’attività passa da in coda a in esecuzione e termina come completata o fallita. Interrompi il polling in uno di questi stati finali.

queued

Accettata e in attesa di uno slot di rendering. Continua il polling.

running

Rendering in corso. il progresso va da 0 a 99.

succeeded

Fatto. output_url e thumbnail_url puntano ai file finiti.

failed

Terminata senza risultato. error spiega il motivo e refunded è true, i crediti sono stati riaccreditati.

Ogni errore ha la stessa struttura. Differenzia per codice e mostra il messaggio all’utente. Un’attività accettata può comunque fallire dopo, quindi controlla lo stato durante il polling.

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

I limiti si calcolano per chiave su un minuto mobile. Superato il limite ricevi HTTP 429 con intestazione Retry-After in secondi. Ogni risposta include intestazioni X-RateLimit per rallentare prima del limite.

Invia

30 al minuto

Creazione di video, immagini e canzoni.

Lettura

120 al minuto

Attività, saldo e modelli. Contati separatamente dagli invii.

Esecuzioni simultanee

3

Attività per account in esecuzione contemporaneamente.

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

I modelli che puoi utilizzare oggi con i loro slug e il prezzo più basso. L'endpoint dei modelli restituisce la stessa lista con tutte le opzioni.