Erstelle Videos, Bilder und Musik mit deinem eigenen Code

Drei Schritte von null bis zum fertigen Video. Jede Anfrage ist einfaches HTTPS mit JSON, daher funktioniert jede Sprache oder jedes Tool.

1. 1

   Schlüssel erstellen

   Öffne die API-Seite in deinem Konto und erstelle einen Schlüssel. Der vollständige Schlüssel wird nur einmal angezeigt, speichere ihn daher in einer Umgebungsvariable namens API_KEY.

   Schlüssel erstellen
2. 2

   Aufgabe einreichen

   Sende das Modell, eine Eingabeaufforderung und alle Optionen. Credits werden einmalig bei der Einreichung abgezogen, die Antwort zeigt dir, wie viele und welche noch übrig sind.

   cURLJavaScriptPython

   Kopieren

   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": "Eine langsame Dollyfahrt durch eine regnerische Neonstraße bei Nacht, Spiegelungen auf nassem Asphalt, filmisch",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Abfragen, bis es fertig ist

   Prüfe die Aufgabe alle paar Sekunden. Wenn der Status erfolgreich ist, lade die Datei von output_url herunter. Falls sie fehlgeschlagen ist, sind die Credits bereits zurück auf deinem Guthaben.

   cURLJavaScriptPython

   Kopieren

   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

Sende deinen Schlüssel im Authorization-Header jeder Anfrage. Schlüssel beginnen mit nm_live_ und gehören zu einem Konto.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

Basis-URL

Alle Endpunkte sind unter https://novamotions.com/api/v1 erreichbar und liefern JSON zurück.

Schlüssel geheim halten

Rufe die API von deinem Server auf, niemals aus einem Browser oder einer mobilen App. Ein widerrufener Schlüssel funktioniert sofort nicht mehr.

Ein Guthaben

API-Aufrufe verbrauchen die Credits des Schlüsselinhabers, dasselbe Guthaben, das auch das Studio nutzt. Planlimits pro Generierung gelten ebenfalls.

Medien-URLs

Bilder, Videos und Audio, die du übergibst, müssen öffentliche https-URLs sein, die ohne Cookies oder Anmeldung geladen werden können.

Alle Modelle, die die API anbietet, mit ihren Modi, Laufzeiten, Auflösungen, Seitenverhältnissen, Audio-Unterstützung, Referenzlimits und dem niedrigsten Preis in Credits. Nutze dies, um einen Modell-Auswahldialog zu bauen, statt Optionen fest zu kodieren.

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

Die Credits, die der Schlüsselinhaber aktuell ausgeben kann, aufgeteilt in Pools mit Ablaufdaten, plus der aktuelle 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-zu-Video, Bild-zu-Video (ein Startbild und optional ein Endbild) oder Referenz-zu-Video (Bilder, Clips und Audio, die das Ergebnis steuern). Der Modus wird aus den Eingaben gewählt, wenn du ihn weglässt.

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": "Eine langsame Dollyfahrt durch eine regnerische Neonstraße bei Nacht, Spiegelungen auf nassem Asphalt, filmisch",
    "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-zu-Bild oder Bearbeitung eines bestehenden Bildes mit einer Eingabeaufforderung. Fordere bis zu vier Bilder pro Anfrage an, jedes ist eine eigene Aufgabe.

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 einer Keramiktasse auf Eichenholz, weiches Fensterlicht, geringe Tiefenschärfe",
    "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
}

Ein kompletter Song aus einer Beschreibung, mit eigenen Texten oder als 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": "Warmer Lo-Fi Hip-Hop mit sanftem Klavier, Vinyl-Knistern und entspanntem Spätnachtsgroove",
    "duration": 60,
    "instrumental": false
  }'

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

Frage eine Aufgabe über ihre ID ab. Sobald der Status erfolgreich ist, zeigt output_url auf die fertige Datei. Abfragen verbrauchen das Leselimit, belasten also nicht dein Einreichbudget.

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": "Eine langsame Dollyfahrt durch eine regnerische Neonstraße bei Nacht, Spiegelungen auf nassem Asphalt, filmisch",
  "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"
}

Aufgaben, die du in den letzten 30 Tagen über die API erstellt hast, neueste zuerst, mit derselben Struktur wie eine einzelne Aufgabe. Übergebe next_cursor als Cursor, um die nächste Seite zu 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": "Eine langsame Dollyfahrt durch eine regnerische Neonstraße bei Nacht, Spiegelungen auf nassem Asphalt, filmisch",
      "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
}

Eine Aufgabe wechselt von queued zu running und endet als succeeded oder failed. Stoppe das Abfragen bei Endstatus.

queued

Akzeptiert und wartet auf einen Renderplatz. Weiter abfragen.

running

Wird gerade gerendert. Fortschritt von 0 bis 99.

succeeded

Fertig. output_url und thumbnail_url zeigen auf die fertigen Dateien.

failed

Endete ohne Ergebnis. error erklärt warum und refunded ist true, die Credits sind zurück auf deinem Konto.

Jeder Fehler hat dieselbe Struktur. Nach Code verzweigen und Nachricht für Nutzer anzeigen. Eine akzeptierte Aufgabe kann später noch fehlschlagen, also Status beim Abfragen prüfen.

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

Limits werden pro Schlüssel über eine rollierende Minute gezählt. Bei Überschreitung erhältst du HTTP 429 mit einem Retry-After Header in Sekunden. Jede Antwort enthält X-RateLimit Header, damit du vorher langsamer machen kannst.

Absenden

30 pro Minute

Videos, Bilder und Songs erstellen.

Lesen

120 pro Minute

Aufgaben, Guthaben und Modelle. Getrennt von Absenden gezählt.

Gleichzeitig laufend

3

Aufgaben pro Konto, die gleichzeitig gerendert werden.

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

Die Modelle, die Sie heute mit ihren Slugs und dem niedrigsten Preis aufrufen können. Der Modelle-Endpunkt gibt dieselbe Liste mit allen Optionen zurück.