API de AI Dance Replace para video con movimiento de referencia

Acceda a ai_dance_replace a través de la API de GoEnhance para sustituir a la persona del video de baile de referencia por la persona de una imagen fuente, conservando el movimiento de referencia. Envíe una tarea asíncrona, guarde su img_uuid y luego consulte mediante polling o use callbacks para conocer la finalización.
Obtener API Key
Bailarín actuando en un estudio de producción cinematográfica para flujos de trabajo de la API AI Dance Replace

Cree flujos de trabajo de videos de baile con reemplazo de persona

Defina la persona de reemplazo

Proporcione una image_url pública. La persona en esa imagen se convierte en el sujeto utilizado en el video de baile generado, así que valide la URL antes de enviarla.
Configuración de captura de retrato para una imagen de persona utilizada por una API de reemplazo de baile

Impulse el movimiento a partir de un video de baile

Proporcione una video_url pública que contenga el baile de referencia. El límite documentado es de 30 segundos; los videos más largos se rechazan.
Bailarín y cámara de cine capturando movimiento para un flujo de trabajo de reemplazo de baile con IA
Valide el identificador exacto del modelo, las URL de los medios y la resolución de salida antes de enviar la solicitud.

Capacidades y entradas de la API AI Dance Replace

Identificador exacto del modelo

Establezca model en ai_dance_replace; es un campo obligatorio de la solicitud.

Imagen de persona requerida

Pase image_url como una URI pública válida de la persona que aparecerá en el resultado.

Video de baile requerido

Pase video_url como un video de referencia público de no más de 30 segundos, según el máximo documentado.

Dos opciones de resolución

Elija 480p o 720p. El valor predeterminado documentado es 480p.

Entrega opcional de callbacks

Agregue una custom_callback_url HTTPS pública para recibir actualizaciones de procesamiento, éxito y fallo.

Respuesta de tarea asíncrona

Una solicitud exitosa devuelve img_uuid; consérvelo para las comprobaciones de estado y el manejo de resultados.
La facturación usa la duración redondeada hacia arriba del video de entrada. Calcule el costo a partir de la resolución seleccionada y los segundos facturados.

Precios de la API AI Dance Replace

Precio de 480p

2 tokens por segundo de video de entrada, lo que equivale a $0.04 por segundo o $0.20 por 5 segundos a $0.02 por token.

Precio de 720p

4 tokens por segundo de video de entrada, lo que equivale a $0.08 por segundo o $0.40 por 5 segundos a $0.02 por token.

Facturación basada en la duración

La duración del video de entrada se redondea hacia arriba para la facturación; calcule el costo como los segundos facturados multiplicados por la tarifa seleccionada.

Integre la API de GoEnhance en seis pasos

1

1. Cree una clave de API

Cree una clave de API de GoEnhance y envíela como bearer token en el encabezado Authorization.
2

2. Valide ambas URLs de los medios.

Confirme que la imagen de la persona y el video de baile sean accesibles públicamente y que el video no dure más de 30 segundos.
3

3. Construya la solicitud

Establezca model: ai_dance_replace, agregue image_url y video_url, luego seleccione 480p o 720p.
4

4. Envíe la tarea

Envía el cuerpo JSON a https://api.goenhance.ai/api/v1/videos/generations.
5

5. Persistir y rastrear

Guarde el img_uuid devuelto, luego consulte GET /api/v1/jobs/detail o reciba eventos de devolución de llamada.
6

6. Maneje los estados terminales

Procese el éxito y el fracaso de forma idempotente, verifique el recurso devuelto y evite duplicar el trabajo posterior.
Obtener clave de API
Utilice una canalización de medios que tenga en cuenta el consentimiento para herramientas de creadores, producción de campañas y automatización de vídeo repetible.

Casos de uso para desarrolladores de video de reemplazo de baile

Plantillas de baile para creadores

Permita que los usuarios apliquen una imagen de persona aprobada a un baile de referencia con licencia dentro de un flujo de creación guiado.

Variantes de video de campaña

Genere variantes del sujeto a partir del material fuente aprobado para revisión interna y edición posterior.

Pruebas de rendimiento de personajes

Explore cómo una imagen de personaje suministrada sigue una referencia de movimiento existente antes de la producción.

Recursos de creador localizados

Reutilice una referencia de baile aprobada con diferentes sujetos autorizados para pipelines de contenido regional.

Colas de contenido automatizadas

Conecte los ID de tarea y las devoluciones de llamada a la orquestación de lotes sin bloquear el hilo de solicitud de su aplicación.

Prototipe experiencias de movimiento

Valide un concepto de producto de imagen y movimiento antes de invertir en un proceso de captura personalizado.
Respuestas a preguntas comunes sobre entrada, precios, estado, callback e integración.

Preguntas frecuentes sobre la API de AI Dance Replace

¿Qué endpoint utiliza la API de AI Dance Replace?

Envía POST https://api.goenhance.ai/api/v1/videos/generations con model: ai_dance_replace, una image_url pública y una video_url pública.

¿Cómo funciona el precio de la API de AI Dance Replace?

El precio se basa en la duración del vídeo de entrada redondeada al alza: 2 tokens por segundo a 480p y 4 tokens por segundo a 720p, lo que equivale a $0.20 y $0.40 por 5 segundos, respectivamente.

¿Qué campos son obligatorios?

Los campos obligatorios documentados son model, image_url y video_url. La resolución y la URL de devolución de llamada son opcionales.

¿Cuánto tiempo puede durar el video de baile de referencia?

El máximo documentado es de 30 segundos. Valide la duración antes del envío, ya que los videos más largos son rechazados.

¿Qué resoluciones de salida están disponibles?

El endpoint acepta 480p y 720p. Si se omite, el valor predeterminado documentado es 480p.

¿Cómo consulto el estado de la tarea?

Conserve el img_uuid devuelto y consulte GET /api/v1/jobs/detail, o proporcione una URL de callback HTTPS pública.

¿Cómo se gestionan los fallos de callback?

GoEnhance documenta hasta tres reintentos cuando su endpoint de callback no devuelve HTTP 200, con un tiempo de espera de tres segundos por cada intento.

¿Qué permisos debería solicitar mi aplicación?

Utilice únicamente imágenes y vídeos de baile que esté autorizado a procesar, y obtenga el consentimiento adecuado de las personas identificables en el material de origen.

Desarrolle con la API de AI Dance Replace