Genereer video, afbeeldingen en muziek vanuit je eigen code

Drie stappen van nul naar een voltooide video. Elk verzoek is gewone HTTPS met JSON, dus elke taal of tool werkt.

1. 1

   Maak een sleutel aan

   Open de API-pagina in je account en maak een sleutel aan. De volledige sleutel wordt één keer getoond, dus sla deze op in een omgevingsvariabele genaamd API_KEY.

   Maak een sleutel aan
2. 2

   Dien een taak in

   Stuur het model, een prompt en eventuele opties. Credits worden één keer afgeschreven bij het indienen, en de respons vertelt je hoeveel en wat er over is.

   cURLJavaScriptPython

   Kopiëren

   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": "Een langzame dolly-shot door een regenachtige neonstraat 's nachts, reflecties op nat asfalt, cinematografisch",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Controleer totdat het klaar is

   Controleer de taak elke paar seconden. Wanneer de status geslaagd is, download je het bestand via output_url. Als het mislukt is, zijn de credits al terug op je saldo.

   cURLJavaScriptPython

   Kopiëren

   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

Stuur je sleutel mee in de Authorization-header van elk verzoek. Sleutels beginnen met nm_live_ en horen bij één account.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

Basis-URL

Alle endpoints bevinden zich onder https://novamotions.com/api/v1 en geven JSON terug.

Houd sleutels geheim

Roep de API aan vanaf je server, nooit vanuit een browser of mobiele app. Een ingetrokken sleutel werkt direct niet meer.

Één saldo

API-aanroepen gebruiken de credits van de sleutel-eigenaar, hetzelfde saldo dat de studio gebruikt. Plangrenzen per generatie gelden ook.

Media-URL's

Afbeeldingen, video's en audio die je doorgeeft moeten openbare https-URL's zijn die laden zonder cookies of inloggen.

Elk model dat de API aanbiedt, met zijn modi, duur, resoluties, beeldverhoudingen, audiomogelijkheden, referentielimieten en de laagste prijs in credits. Gebruik dit om een modelkiezer te bouwen in plaats van opties hard te coderen.

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

De credits die de sleutel-eigenaar nu kan besteden, verdeeld in pools met hun vervaldatums, plus het huidige 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 naar video, afbeelding naar video (een startframe en optioneel een eindframe) of referentie naar video (afbeeldingen, clips en audio die het resultaat sturen). De modus wordt gekozen op basis van de inputs als je deze weglaat.

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": "Een langzame dolly-shot door een regenachtige neonstraat 's nachts, reflecties op nat asfalt, cinematografisch",
    "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 naar afbeelding, of bewerk een bestaande afbeelding met een prompt. Vraag tot vier afbeeldingen per verzoek aan, elk is een eigen taak.

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": "Studio productfoto van een keramische koffiekop op eikenhout, zacht raamlicht, geringe scherptediepte",
    "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
}

Een volledig nummer vanuit een beschrijving, met je eigen songtekst of als instrumentaal.

curl -X POST https://novamotions.com/api/v1/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-music",
    "prompt": "Warme lo-fi hiphop met zachte piano, vinylkraak en een ontspannen late-night groove",
    "duration": 60,
    "instrumental": false
  }'

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

Controleer een taak via zijn id. Zodra de status geslaagd is, wijst output_url naar het voltooide bestand. Polling gebruikt de leeslimiet, dus het gaat nooit ten koste van je indienbudget.

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": "Een langzame dolly-shot door een regenachtige neonstraat 's nachts, reflecties op nat asfalt, cinematografisch",
  "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"
}

Taken die je via de API in de afgelopen 30 dagen hebt aangemaakt, nieuwste eerst, met dezelfde vorm als een enkele taak. Geef next_cursor door als cursor om de volgende pagina te laden.

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": "Een langzame dolly-shot door een regenachtige neonstraat 's nachts, reflecties op nat asfalt, cinematografisch",
      "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
}

Een taak gaat van queued naar running en eindigt als succeeded of failed. Stop met polleren bij een eindstatus.

queued

Geaccepteerd en wacht op een renderplek. Blijf polleren.

running

Bezig met renderen. Voortgang gaat van 0 tot 99.

succeeded

Klaar. output_url en thumbnail_url wijzen naar de voltooide bestanden.

failed

Eindigde zonder resultaat. error legt uit waarom en refunded is true, de credits zijn terug op je saldo.

Elke fout heeft dezelfde structuur. Vertak op code en toon een bericht aan de gebruiker. Een taak die geaccepteerd is kan later nog falen, controleer daarom de status bij het polleren.

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

Limieten worden per sleutel geteld over een rollende minuut. Bij overschrijding krijg je HTTP 429 met een Retry-After header in seconden. Elke respons bevat X-RateLimit headers zodat je kunt vertragen voordat dat gebeurt.

Verzenden

30 per minuut

Video's, afbeeldingen en nummers maken.

Lezen

120 per minuut

Taken, saldo en modellen. Apart geteld van verzenden.

Gelijktijdig actief

3

Taken per account die tegelijk renderen.

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

De modellen die je vandaag kunt gebruiken met hun slugs en laagste prijs. De modellen endpoint geeft dezelfde lijst met alle opties terug.