API del Generador de Baile con IA: Genera Videos de Baile Programáticamente

La API pública de AI Dance Generator te permite generar videos de baile programáticamente — desde tus propias aplicaciones, scripts de automatización o flujos de trabajo. Sube una imagen de personaje, proporciona un video de baile de referencia (o un enlace de TikTok), y nuestro generador de videos de baile con IA se encarga del resto.

Ya sea que estés construyendo un pipeline de creación de contenido, integrando generación de video con IA en tu producto, o automatizando flujos de trabajo en redes sociales, la API REST de Dance Generator te da control total sobre el proceso de creación de videos de baile.

Esta guía cubre autenticación, todos los endpoints disponibles, ejemplos de solicitud/respuesta y mejores prácticas para integrar la API del generador de baile con IA en tu proyecto.

Primeros Pasos con la API de Dance Generator

1. Crear una API Key

Inicia sesión en tu cuenta de Dance Generator y navega a Configuración → API Keys. Haz clic en Crear para generar una nueva clave.

Tu clave tendrá el formato sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Cópiala inmediatamente — solo se muestra una vez.

2. Autenticación

Todas las solicitudes API requieren un token Bearer en el encabezado Authorization:

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

3. URL Base

https://dancegenerator.ai/api/v1

Todos los endpoints tienen el prefijo /api/v1.

Endpoints de la API del Generador de Baile con IA

Consultar Créditos

Consulta tu saldo de créditos actual antes de generar videos de baile con IA.

GET /api/v1/credits

Ejemplo:

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

Respuesta:

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

El costo se calcula como duración_del_video_en_segundos × 7 créditos.

Subir Imagen del Personaje

Sube la imagen del personaje que será animado en el video de baile.

POST /api/v1/upload/image

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

Ejemplo:

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

Respuesta:

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

Guarda la url — la necesitarás para la solicitud de generación.

Subir Video de Referencia (Opcional)

Si tienes un video de baile local como referencia, súbelo primero.

POST /api/v1/upload/video

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

Ejemplo:

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

Respuesta:

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

Generar un Video de Baile con IA

Este es el endpoint principal de la API del generador de baile con IA. Envía una imagen de personaje y un video de baile de referencia (o una URL de TikTok) para generar un video de baile usando IA.

POST /api/v1/generate

Cuerpo de la solicitud (JSON):

Ejemplo con video subido:

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": "Haz que el personaje baile con energía",
    "character_orientation": "image"
  }'

Ejemplo con URL de 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"
  }'

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

La generación suele tardar 2-3 minutos. Usa el ID de la tarea para consultar los resultados.

Consultar Estado de la Tarea

Consulta este endpoint para verificar si tu video está listo.

GET /api/v1/tasks/:taskId

Ejemplo:

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

Respuesta (en progreso):

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

Respuesta (completado):

{
  "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 estado:

Listar Tareas

Obtén tu historial de tareas con paginación y filtro de estado opcional.

GET /api/v1/tasks

Parámetros de consulta:

Ejemplo:

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

Respuesta:

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

Flujo Completo de Generación de Videos de Baile con IA

Aquí tienes un flujo completo mostrando cómo generar un video de baile vía API de principio a fin usando curl:

# Paso 1: Sube tu imagen del personaje
curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "[email protected]"
# → Anota la "url" de la respuesta

# Paso 2: Genera un video de baile usando una referencia de 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"
  }'
# → Anota el "task_id" de la respuesta

# Paso 3: Consulta los resultados (repite hasta que el status sea "success" o "failed")
curl https://dancegenerator.ai/api/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-api-key"
# → Cuando el status sea "success", descarga el video desde result.video_url

Manejo de Errores de la API

Todos los errores de la API de Dance Generator siguen un formato JSON consistente:

{
  "error": "error_code",
  "message": "Descripción legible",
  "details": {}
}

Códigos de error comunes:

Consejos para Usar la API del Generador de Baile con IA

• Intervalo de consulta: Recomendamos consultar el estado cada 5-10 segundos. La mayoría de los videos de baile con IA se completan en 2-3 minutos.
• Reembolso de créditos: Si una tarea de generación de video falla, los créditos se reembolsan automáticamente.
• Integración con TikTok: Puedes pasar directamente una URL de TikTok como referencia de baile — la API se encarga de descargar y procesar el video.
• Deduplicación de archivos: Subir el mismo archivo dos veces devuelve la misma URL sin consumir almacenamiento adicional.
• CORS habilitado: Todos los endpoints soportan solicitudes cross-origin, por lo que puedes llamar a la API del generador de baile desde aplicaciones web.

Preguntas Frecuentes

¿Qué es la API de AI Dance Generator?

La API de AI Dance Generator es una API pública RESTful que permite a los desarrolladores generar videos de baile programáticamente. Proporcionas una imagen de personaje y un video de baile de referencia, y nuestra IA crea una animación realista del personaje realizando los movimientos de baile.

¿Qué formatos de video soporta la API del generador de baile?

La API acepta archivos MP4 y MOV para videos de referencia, y JPG, PNG y WebP para imágenes de personajes. También puedes pasar directamente una URL de TikTok en lugar de subir un archivo de video.

¿Cuánto cuesta generar un video de baile vía API?

El generador de baile con IA usa un modelo de precios por créditos. Cada segundo de video generado cuesta 7 créditos. Por ejemplo, un video de baile de 10 segundos cuesta 70 créditos. Si la generación falla, los créditos se reembolsan automáticamente.

¿Puedo usar la API del generador de baile en mi propia aplicación?

Sí. La API pública de Dance Generator está diseñada para integración. Todos los endpoints soportan CORS, por lo que puedes llamarlos desde apps web, backends móviles, scripts de automatización o cualquier cliente HTTP.

¿Listo para construir con la API del generador de baile con IA? Ve a Configuración → API Keys para crear tu primera clave.