Skapa video, bilder och musik från din egen kod

Tre steg från noll till färdig video. Varje förfrågan är vanlig HTTPS med JSON, så vilket språk eller verktyg som helst fungerar.

1. 1

   Skapa en nyckel

   Öppna API-sidan i ditt konto och skapa en nyckel. Den fullständiga nyckeln visas en gång, så spara den i en miljövariabel som heter API_KEY.

   Skapa en nyckel
2. 2

   Skicka en uppgift

   Skicka modellen, en prompt och eventuella inställningar. Credits dras en gång vid inskickning och svaret visar hur många och vad som finns kvar.

   cURLJavaScriptPython

   Kopiera

   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": "En långsam dolly-shot genom en regnig neonupplyst gata på natten, reflektioner på våt asfalt, filmiskt",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Kontrollera tills den är klar

   Kontrollera uppgiften var några sekunder. När status är lyckad, ladda ner filen från output_url. Om den misslyckades är krediterna redan tillbaka på ditt saldo.

   cURLJavaScriptPython

   Kopiera

   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

Skicka din nyckel i Authorization-headern för varje förfrågan. Nycklar börjar med nm_live_ och tillhör ett konto.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

Bas-URL

Alla slutpunkter finns under https://novamotions.com/api/v1 och returnerar JSON.

Håll nycklar hemliga

Anropa API:et från din server, aldrig från en webbläsare eller mobilapp. En återkallad nyckel slutar fungera omedelbart.

Ett saldo

API-anrop använder nyckelns ägares credits, samma saldo som studion använder. Planbegränsningar per generering gäller också.

Media-URL:er

Bilder, videor och ljud du skickar in måste vara offentliga https-URL:er som laddas utan cookies eller inloggning.

Alla modeller som API:et erbjuder, med deras lägen, längder, upplösningar, bildförhållanden, ljudstöd, referensbegränsningar och lägsta pris i credits. Använd för att bygga en modellväljare istället för hårdkodade alternativ.

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 nyckelägaren kan använda just nu, uppdelade i pooler med utgångsdatum, plus aktuell 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"
  }
}

Text till video, bild till video (en startbild och valfritt en slutbild) eller referens till video (bilder, klipp och ljud som styr resultatet). Läge väljs från dina indata om du lämnar det tomt.

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": "En långsam dolly-shot genom en regnig neonupplyst gata på natten, reflektioner på våt asfalt, filmiskt",
    "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 till bild, eller redigera en befintlig bild med en prompt. Be om upp till fyra bilder per förfrågan, varje bild är en egen uppgift.

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-produktfoto av en keramisk kaffekopp på ek, mjukt fönsterljus, grunt skärpedjup",
    "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
}

En hel låt från en beskrivning, med egna texter eller som 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": "Varm lo-fi hiphop med mjuk piano, vinylknaster och en avslappnad nattlig 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
}

Kontrollera en uppgift med dess id. När status är lyckad pekar output_url på den färdiga filen. Kontrollering använder läsgränsen och påverkar aldrig din inskickningsbudget.

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": "En långsam dolly-shot genom en regnig neonupplyst gata på natten, reflektioner på våt asfalt, filmiskt",
  "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"
}

Uppgifter du skapat via API:et de senaste 30 dagarna, nyast först, med samma format som en enskild uppgift. Skicka next_cursor som cursor för att ladda nästa sida.

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": "En långsam dolly-shot genom en regnig neonupplyst gata på natten, reflektioner på våt asfalt, filmiskt",
      "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
}

En uppgift går från köad till körs och slutar som lyckad eller misslyckad. Sluta pollning vid något av slutlägena.

queued

Accepterad och väntar på en renderingsplats. Fortsätt pollning.

running

Renderar nu. Framsteg går från 0 till 99.

succeeded

Klar. output_url och thumbnail_url pekar på de färdiga filerna.

failed

Avslutades utan resultat. error förklarar varför och refunded är sant, credits är tillbaka på ditt saldo.

Varje fel har samma format. Granska koden och visa meddelande till användaren. En uppgift som accepterats kan ändå misslyckas senare, så kontrollera dess status när du pollar.

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

Begränsningar räknas per nyckel över en rullande minut. Överskrids gränsen får du HTTP 429 med en Retry-After-header i sekunder. Varje svar innehåller X-RateLimit-header så du kan sakta ner innan dess.

Skicka

30 per minut

Skapa videor, bilder och låtar.

Läsa

120 per minut

Uppgifter, saldo och modeller. Räknas separat från inskick.

Körs samtidigt

3

Uppgifter per konto som renderas samtidigt.

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

Modellerna du kan använda idag med deras slugs och lägsta pris. Endpointen för modeller returnerar samma lista med alla alternativ.