Générez des vidéos, images et musiques depuis votre propre code

Trois étapes pour passer de zéro à une vidéo terminée. Chaque requête est en HTTPS simple avec JSON, donc n’importe quel langage ou outil fonctionne.

1. 1

   Créer une clé

   Ouvrez la page API dans votre compte et créez une clé. La clé complète est affichée une seule fois, stockez-la dans une variable d’environnement nommée API_KEY.

   Créer une clé
2. 2

   Soumettre une tâche

   Envoyez le modèle, une description et les options éventuelles. Les crédits sont débités une fois à la soumission, et la réponse indique combien il en reste.

   cURLJavaScriptPython

   Copier

   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 travelling lent dans une rue néon pluvieuse la nuit, reflets sur l’asphalte mouillé, style cinématographique",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Interroger jusqu’à ce que ce soit prêt

   Vérifiez la tâche toutes les quelques secondes. Quand le statut est réussi, téléchargez le fichier depuis output_url. En cas d’échec, les crédits sont déjà remboursés sur votre solde.

   cURLJavaScriptPython

   Copier

   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

Envoyez votre clé dans l’en-tête Authorization de chaque requête. Les clés commencent par nm_live_ et appartiennent à un compte.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

URL de base

Tous les points de terminaison sont sous https://novamotions.com/api/v1 et renvoient du JSON.

Gardez les clés secrètes

Appelez l’API depuis votre serveur, jamais depuis un navigateur ou une application mobile. Une clé révoquée cesse de fonctionner immédiatement.

Un seul solde

Les appels API dépensent les crédits du propriétaire de la clé, le même solde utilisé par le studio. Les limites du forfait par génération s’appliquent aussi.

URLs des médias

Les images, vidéos et audios que vous fournissez doivent être des URLs https publiques qui se chargent sans cookies ni connexion.

Tous les modèles servis par l’API, avec leurs modes, durées, résolutions, rapports d’aspect, support audio, limites de référence et leur prix le plus bas en crédits. Utilisez-le pour créer un sélecteur de modèles au lieu de coder en dur les options.

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

Les crédits que le propriétaire de la clé peut dépenser immédiatement, répartis en pools avec leurs dates d’expiration, plus le forfait actuel.

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

Texte en vidéo, image en vidéo (une image de départ et éventuellement une image de fin) ou référence vidéo (images, clips et audio qui guident le résultat). Le mode est choisi selon les entrées si vous le laissez vide.

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 travelling lent dans une rue néon pluvieuse la nuit, reflets sur l’asphalte mouillé, style cinématographique",
    "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
}

Texte en image, ou modifier une image existante avec une description. Demandez jusqu’à quatre images par requête, chacune est une tâche distincte.

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": "Photo produit studio d’une tasse en céramique sur chêne, lumière douce de fenêtre, faible profondeur de champ",
    "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
}

Une chanson complète à partir d’une description, avec vos propres paroles ou en 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": "Hip-hop lo-fi chaleureux avec piano doux, crépitement de vinyle et groove relax de fin de soirée",
    "duration": 60,
    "instrumental": false
  }'

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

Interrogez une tâche par son id. Une fois le statut réussi, output_url pointe vers le fichier terminé. L’interrogation utilise la limite de lecture, elle ne consomme donc pas votre budget de soumission.

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 travelling lent dans une rue néon pluvieuse la nuit, reflets sur l’asphalte mouillé, style cinématographique",
  "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"
}

Tâches créées via l’API dans les 30 derniers jours, les plus récentes en premier, avec la même structure qu’une tâche unique. Passez next_cursor comme curseur pour charger la page suivante.

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 travelling lent dans une rue néon pluvieuse la nuit, reflets sur l’asphalte mouillé, style cinématographique",
      "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
}

Une tâche passe de en attente à en cours puis finit en réussie ou échouée. Arrêtez la consultation à l’un de ces états finaux.

queued

Acceptée et en attente d’une place de rendu. Continuez à consulter.

running

Rendu en cours. La progression va de 0 à 99.

succeeded

Terminé. output_url et thumbnail_url pointent vers les fichiers finis.

failed

Terminé sans résultat. error explique pourquoi et refunded est vrai, les crédits sont remboursés sur votre solde.

Chaque erreur a la même structure. Branchez-vous sur le code et affichez un message compréhensible. Une tâche acceptée peut échouer plus tard, vérifiez son statut lors de la consultation.

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

Les limites sont comptées par clé sur une minute glissante. Au-delà, vous recevez un HTTP 429 avec un en-tête Retry-After en secondes. Chaque réponse porte les en-têtes X-RateLimit pour que vous puissiez ralentir avant cela.

Soumettre

30 par minute

Création de vidéos, images et chansons.

Lecture

120 par minute

Tâches, solde et modèles. Comptés séparément des soumissions.

Exécution simultanée

3

Tâches par compte en rendu en même temps.

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

Les modèles que vous pouvez utiliser aujourd'hui avec leurs identifiants et leur prix le plus bas. Le point de terminaison des modèles renvoie la même liste avec toutes les options.