Gere vídeos, imagens e músicas com seu próprio código

Três passos do zero até um vídeo finalizado. Toda requisição é HTTPS simples com JSON, então qualquer linguagem ou ferramenta funciona.

1. 1

   Crie uma chave

   Abra a página da API na sua conta e crie uma chave. A chave completa é mostrada uma única vez, então armazene-a em uma variável de ambiente chamada API_KEY.

   Criar uma chave
2. 2

   Envie uma tarefa

   Envie o modelo, um prompt e quaisquer opções. Os créditos são cobrados uma vez, no envio, e a resposta informa quantos foram usados e o saldo restante.

   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": "Um movimento lento de câmera por uma rua neon chuvosa à noite, reflexos no asfalto molhado, cinematográfico",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Consulte até estar pronta

   Verifique a tarefa a cada poucos segundos. Quando o status for concluído, baixe o arquivo em output_url. Se falhar, os créditos já foram devolvidos ao seu 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

Envie sua chave no cabeçalho Authorization de cada requisição. As chaves começam com nm_live_ e pertencem a uma conta.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

URL base

Todos os endpoints estão sob https://novamotions.com/api/v1 e retornam JSON.

Mantenha as chaves em segredo

Chame a API do seu servidor, nunca do navegador ou app móvel. Uma chave revogada para de funcionar imediatamente.

Um saldo único

Chamadas à API gastam os créditos do dono da chave, o mesmo saldo usado pelo estúdio. Limites do plano por geração também se aplicam.

URLs de mídia

Imagens, vídeos e áudios que você enviar devem ser URLs https públicas que carreguem sem cookies ou login.

Todos os modelos que a API oferece, com seus modos, durações, resoluções, proporções, suporte a áudio, limites de referência e o menor preço em créditos. Use para criar um seletor de modelos em vez de codificar opções fixas.

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

Os créditos que o dono da chave pode gastar agora, divididos em grupos com suas datas de expiração, além do plano atual.

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 para vídeo, imagem para vídeo (um quadro inicial e opcionalmente um quadro final) ou referência para vídeo (imagens, clipes e áudio que guiam o resultado). O modo é escolhido pelos inputs quando omitido.

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": "Um movimento lento de câmera por uma rua neon chuvosa à noite, reflexos no asfalto molhado, 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 para imagem, ou editar uma imagem existente com um prompt. Peça até quatro imagens por requisição, cada uma é uma tarefa separada.

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 produto em estúdio de uma xícara de cerâmica sobre carvalho, luz suave da janela, profundidade de campo rasa",
    "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
}

Uma música completa a partir de uma descrição, com suas próprias letras ou 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": "Lo-fi hip hop quente com piano suave, estalo de vinil e groove relaxado 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
}

Consulte uma tarefa pelo seu id. Quando o status for concluído, output_url aponta para o arquivo finalizado. Consultas usam o limite de leitura, então não consomem seu orçamento de envio.

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": "Um movimento lento de câmera por uma rua neon chuvosa à noite, reflexos no asfalto molhado, 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"
}

Tarefas criadas pela API nos últimos 30 dias, da mais nova para a mais antiga, com o mesmo formato de uma tarefa única. Use next_cursor como cursor para carregar a próxima 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": "Um movimento lento de câmera por uma rua neon chuvosa à noite, reflexos no asfalto molhado, 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
}

Uma tarefa passa de na fila para em execução e termina como concluída ou falhou. Pare de consultar em qualquer estado final.

queued

Aceita e aguardando uma vaga para renderização. Continue consultando.

running

Renderizando agora. progresso vai de 0 a 99.

succeeded

Concluído. output_url e thumbnail_url apontam para os arquivos finalizados.

failed

Terminou sem resultado. error explica o motivo e refunded é true, os créditos voltam para seu saldo.

Todo erro tem o mesmo formato. Baseie-se no código e mostre a mensagem para o usuário. Uma tarefa aceita pode falhar depois, então verifique seu status ao consultar.

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

Os limites contam por chave em um minuto móvel. Se ultrapassar, você recebe HTTP 429 com um cabeçalho Retry-After em segundos. Cada resposta traz os cabeçalhos X-RateLimit para você desacelerar antes disso.

Enviar

30 por minuto

Criar vídeos, imagens e músicas.

Ler

120 por minuto

Tarefas, saldo e modelos. Contados separadamente dos envios.

Execuções simultâneas

3

Tarefas por conta renderizando ao mesmo tempo.

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

Os modelos que você pode usar hoje com seus slugs e o menor preço. O endpoint de modelos retorna a mesma lista com todas as opções.