Genera videos, imágenes y música desde tu propio código

Tres pasos de cero a un video terminado. Cada solicitud es HTTPS simple con JSON, así que cualquier lenguaje o herramienta funciona.

1. 1

   Crear una clave

   Abre la página de API en tu cuenta y crea una clave. La clave completa se muestra una vez, así que guárdala en una variable de entorno llamada API_KEY.

   Crear una clave
2. 2

   Enviar una tarea

   Envía el modelo, un prompt y cualquier opción. Los créditos se cobran una vez, al enviar, y la respuesta te indica cuántos y cuántos quedan.

   cURLJavaScriptPython

   Copiar

   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 toma lenta con dolly por una calle neón lluviosa de noche, reflejos en asfalto mojado, cinematográfico",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Consultar hasta que esté listo

   Revisa la tarea cada pocos segundos. Cuando el estado sea 'succeeded', descarga el archivo desde output_url. Si falló, los créditos ya están de vuelta en tu saldo.

   cURLJavaScriptPython

   Copiar

   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

Envía tu clave en el encabezado Authorization de cada solicitud. Las claves comienzan con nm_live_ y pertenecen a una cuenta.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

URL base

Todos los puntos finales están bajo https://novamotions.com/api/v1 y devuelven JSON.

Mantén las claves en secreto

Llama a la API desde tu servidor, nunca desde un navegador o app móvil. Una clave revocada deja de funcionar de inmediato.

Un solo saldo

Las llamadas a la API gastan los créditos del dueño de la clave, el mismo saldo que usa el estudio. También aplican los límites del plan por generación.

URLs de medios

Las imágenes, videos y audios que envíes deben ser URLs públicas https que carguen sin cookies ni inicio de sesión.

Todos los modelos que ofrece la API, con sus modos, duraciones, resoluciones, relaciones de aspecto, soporte de audio, límites de referencia y su precio más bajo en créditos. Úsalo para crear un selector de modelos en lugar de codificar opciones.

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

Los créditos que el dueño de la clave puede gastar ahora mismo, divididos en grupos con sus fechas de expiración, más el plan actual.

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

Texto a video, imagen a video (un cuadro inicial y opcionalmente uno final) o referencia a video (imágenes, clips y audio que guían el resultado). El modo se elige según las entradas si lo omites.

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 toma lenta con dolly por una calle neón lluviosa de noche, reflejos en asfalto mojado, cinematográfico",
    "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
}

Texto a imagen, o editar una imagen existente con un prompt. Pide hasta cuatro imágenes por solicitud, cada una es una tarea independiente.

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 de producto en estudio de una taza de cerámica sobre roble, luz suave de ventana, poca profundidad de campo",
    "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 canción completa desde una descripción, con tus propias letras o como 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 cálido con piano suave, crujido de vinilo y un ritmo relajado de madrugada",
    "duration": 60,
    "instrumental": false
  }'

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

Consulta una tarea por su id. Cuando el estado sea 'succeeded', output_url apunta al archivo terminado. Consultar usa el límite de lectura, así que no consume tu presupuesto de envío.

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 toma lenta con dolly por una calle neón lluviosa de noche, reflejos en asfalto mojado, cinematográfico",
  "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"
}

Tareas que creaste vía API en los últimos 30 días, las más recientes primero, con la misma estructura que una tarea individual. Pasa next_cursor como cursor para cargar la siguiente página.

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 toma lenta con dolly por una calle neón lluviosa de noche, reflejos en asfalto mojado, cinematográfico",
      "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
}

Una tarea pasa de en cola a en ejecución y termina como completada o fallida. Deja de consultar en cualquiera de los estados finales.

queued

Aceptada y esperando un espacio para renderizar. Sigue consultando.

running

Renderizando ahora. el progreso va de 0 a 99.

succeeded

Hecho. output_url y thumbnail_url apuntan a los archivos terminados.

failed

Terminó sin resultado. error explica por qué y refunded es true, los créditos vuelven a tu saldo.

Cada error tiene la misma estructura. Ramifica según el código y muestra el mensaje a una persona. Una tarea aceptada puede fallar después, así que revisa su estado cuando consultes.

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

Los límites se cuentan por clave en un minuto móvil. Si excedes el límite recibes HTTP 429 con un encabezado Retry-After en segundos. Cada respuesta lleva los encabezados X-RateLimit para que puedas reducir la velocidad antes de eso.

Enviar

30 por minuto

Crear videos, imágenes y canciones.

Leer

120 por minuto

Tareas, saldo y modelos. Contados por separado de los envíos.

Ejecutándose a la vez

3

Tareas por cuenta renderizando al mismo tiempo.

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

Los modelos que puedes usar hoy con sus identificadores y el precio más bajo. El endpoint de modelos devuelve la misma lista con todas las opciones.