API do Gerador de Dança com IA: Gere Vídeos de Dança Programaticamente

A API pública do AI Dance Generator permite gerar vídeos de dança programaticamente — a partir dos seus próprios apps, scripts de automação ou workflows. Faça upload de uma imagem de personagem, forneça um vídeo de dança de referência (ou um link do TikTok), e nosso gerador de vídeos de dança com IA cuida do resto.

Seja para construir um pipeline de criação de conteúdo, integrar geração de vídeo com IA ao seu produto, ou automatizar workflows de mídias sociais, a API REST do Dance Generator oferece controle total sobre o processo de criação de vídeos de dança.

Este guia cobre autenticação, todos os endpoints disponíveis, exemplos de requisição/resposta e melhores práticas para integrar a API do gerador de dança com IA ao seu projeto.

Começando com a API do Dance Generator

1. Criar uma API Key

Faça login na sua conta Dance Generator e navegue até Configurações → API Keys. Clique em Criar para gerar uma nova chave.

Sua chave terá o formato sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Copie-a imediatamente — ela só é exibida uma vez.

2. Autenticação

Todas as requisições API requerem um token Bearer no cabeçalho Authorization:

Authorization: Bearer sk-your-api-key-here

3. URL Base

https://dancegenerator.ai/api/v1

Todos os endpoints têm o prefixo /api/v1.

Endpoints da API do Gerador de Dança com IA

Verificar Créditos

Verifique seu saldo de créditos atual antes de gerar vídeos de dança com IA.

GET /api/v1/credits

Exemplo:

curl https://dancegenerator.ai/api/v1/credits \
  -H "Authorization: Bearer sk-your-api-key"

Resposta:

{
  "remaining_credits": 500,
  "cost_reference": {
    "per_second": 7,
    "example_10s_video": 70
  }
}

O custo é calculado como duração_do_vídeo_em_segundos × 7 créditos.

Upload de Imagem do Personagem

Faça upload da imagem do personagem que será animado no vídeo de dança.

POST /api/v1/upload/image

• Formato: multipart/form-data
• Tipos permitidos: JPG, PNG, WebP
• Tamanho máximo: 10 MB

Exemplo:

curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@/path/to/character.jpg"

Resposta:

{
  "url": "https://file.dancegenerator.ai/abc123.jpg",
  "filename": "character.jpg",
  "size": 1024000
}

Salve a url — você precisará dela para a requisição de geração.

Upload de Vídeo de Referência (Opcional)

Se você tem um vídeo de dança local como referência, faça o upload primeiro.

POST /api/v1/upload/video

• Formato: multipart/form-data
• Tipos permitidos: MP4, MOV
• Tamanho máximo: 100 MB

Exemplo:

curl https://dancegenerator.ai/api/v1/upload/video \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@/path/to/dance.mp4"

Resposta:

{
  "url": "https://file.dancegenerator.ai/videos/def456.mp4",
  "filename": "dance.mp4",
  "size": 5120000
}

Gerar um Vídeo de Dança com IA

Este é o endpoint principal da API do gerador de dança com IA. Envie uma imagem de personagem e um vídeo de dança de referência (ou uma URL do TikTok) para gerar um vídeo de dança usando IA.

POST /api/v1/generate

Corpo da requisição (JSON):

Exemplo com vídeo enviado:

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "reference_video_url": "https://file.dancegenerator.ai/videos/def456.mp4",
    "prompt": "Faça o personagem dançar com energia",
    "character_orientation": "image"
  }'

Exemplo com URL do TikTok:

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "tiktok_url": "https://www.tiktok.com/@user/video/1234567890",
    "character_orientation": "image"
  }'

Resposta (201):

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "cost_credits": 70,
  "remaining_credits": 430,
  "estimated_duration_seconds": 180,
  "created_at": "2026-03-09T10:00:00.000Z"
}

A geração normalmente leva 2-3 minutos. Use o ID da tarefa para consultar os resultados.

Verificar Status da Tarefa

Consulte este endpoint para verificar se seu vídeo está pronto.

GET /api/v1/tasks/:taskId

Exemplo:

curl https://dancegenerator.ai/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk-your-api-key"

Resposta (em andamento):

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "progress": 50,
  "result": null,
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": null,
  "error": null
}

Resposta (concluído):

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "progress": 100,
  "result": {
    "video_url": "https://..."
  },
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": "2026-03-09T10:03:22.000Z",
  "error": null
}

Valores de status:

Listar Tarefas

Recupere seu histórico de tarefas com paginação e filtro de status opcional.

GET /api/v1/tasks

Parâmetros de consulta:

Exemplo:

curl "https://dancegenerator.ai/api/v1/tasks?status=success&page=1&limit=10" \
  -H "Authorization: Bearer sk-your-api-key"

Resposta:

{
  "tasks": [
    {
      "task_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "success",
      "cost_credits": 70,
      "created_at": "2026-03-09T10:00:00.000Z",
      "completed_at": "2026-03-09T10:03:22.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42
  }
}

Workflow Completo de Geração de Vídeo de Dança com IA

Aqui está um workflow completo mostrando como gerar um vídeo de dança via API, do início ao fim usando curl:

# Passo 1: Faça upload da sua imagem de personagem
curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "[email protected]"
# → Anote a "url" da resposta

# Passo 2: Gere um vídeo de dança usando uma referência do TikTok
curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "YOUR_UPLOADED_IMAGE_URL",
    "tiktok_url": "https://www.tiktok.com/@dancer/video/1234567890"
  }'
# → Anote o "task_id" da resposta

# Passo 3: Consulte os resultados (repita até que o status seja "success" ou "failed")
curl https://dancegenerator.ai/api/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-api-key"
# → Quando o status for "success", baixe o vídeo de result.video_url

Tratamento de Erros da API

Todos os erros da API Dance Generator seguem um formato JSON consistente:

{
  "error": "error_code",
  "message": "Descrição legível",
  "details": {}
}

Códigos de erro comuns:

Dicas para Usar a API do Gerador de Dança com IA

• Intervalo de consulta: Recomendamos consultar o status a cada 5-10 segundos. A maioria dos vídeos de dança com IA é concluída em 2-3 minutos.
• Reembolso de créditos: Se uma tarefa de geração de vídeo falhar, os créditos são automaticamente reembolsados.
• Integração TikTok: Você pode passar diretamente uma URL do TikTok como referência de dança — a API cuida do download e processamento do vídeo.
• Deduplicação de arquivos: Fazer upload do mesmo arquivo duas vezes retorna a mesma URL sem consumir armazenamento adicional.
• CORS habilitado: Todos os endpoints suportam requisições cross-origin, então você pode chamar a API do gerador de dança a partir de aplicações web.

Perguntas Frequentes

O que é a API do AI Dance Generator?

A API do AI Dance Generator é uma API pública RESTful que permite aos desenvolvedores gerar vídeos de dança programaticamente. Você fornece uma imagem de personagem e um vídeo de dança de referência, e nossa IA cria uma animação realista do personagem executando os movimentos de dança.

Quais formatos de vídeo a API do gerador de dança suporta?

A API aceita arquivos MP4 e MOV para vídeos de referência, e JPG, PNG e WebP para imagens de personagens. Você também pode passar diretamente uma URL do TikTok em vez de fazer upload de um arquivo de vídeo.

Quanto custa gerar um vídeo de dança via API?

O gerador de dança com IA usa um modelo de preços por créditos. Cada segundo de vídeo gerado custa 7 créditos. Por exemplo, um vídeo de dança de 10 segundos custa 70 créditos. Se a geração falhar, os créditos são automaticamente reembolsados.

Posso usar a API do gerador de dança na minha própria aplicação?

Sim. A API pública do Dance Generator foi projetada para integração. Todos os endpoints suportam CORS, então você pode chamá-los de apps web, backends mobile, scripts de automação ou qualquer cliente HTTP.

Pronto para começar a construir com a API do gerador de dança com IA? Vá para Configurações → API Keys para criar sua primeira chave.