img_uuid devuelto y gestione el resultado asíncrono mediante sondeo o callback HTTPS.AI Dance Move API
Use la API de AI Dance Move a través de GoEnhance para animar a la persona de una imagen de origen con el movimiento de un video de baile de referencia. Envíe ambas URLs públicas, elija 480p o 720p, guarde el
Crear una API Key
Impulse un retrato con movimiento de baile de referencia
Una imagen de origen define al bailarín
Envíe un image_url público requerido. La persona en esa imagen se convierte en el sujeto del video de baile generado, así que use una fuente de cuerpo completo clara y sin obstrucciones cuando la legibilidad del movimiento sea importante.
Un video de referencia aporta el movimiento
Envíe un video_url público requerido que contenga el movimiento de baile a seguir. La duración máxima documentada del video de entrada es de 30 segundos; las referencias más largas se rechazan.
Valide las URLs de origen, la duración, la resolución y el manejo de la finalización antes de realizar el envío.
Capacidades y límites de la API de AI Dance Move
Identificador exacto del modelo
Establezca <code>model</code> en <code>ai_dance_move</code> para esta ruta.
Dos URLs de medios obligatorias
Proporcione tanto el <code>image_url</code> de la persona como el <code>video_url</code> del baile de referencia.
Límite de entrada de 30 segundos
Los videos de baile de referencia no pueden superar los 30 segundos; las entradas más largas se rechazan.
Salida de 480p o 720p
Elija <code>480p</code> o <code>720p</code>. El valor predeterminado documentado es <code>480p</code>.
ID de tarea asíncrona
Un envío correcto devuelve <code>data.img_uuid</code>, no el video final.
Sondeo o callbacks
Sondee el endpoint de detalle del trabajo o proporcione una URL de callback HTTPS pública para los cambios de estado.
GoEnhance factura cada segundo redondeado hacia arriba del video de referencia de entrada según la resolución de salida seleccionada.
Precios de la API de AI Dance Move
480p: 2 tokens por segundo
Una entrada de cinco segundos son 10 tokens, indicados como $0.20 en la documentación actual de GoEnhance.
720p: 4 tokens por segundo
Una entrada de cinco segundos son 20 tokens, indicados como $0.40 en la documentación actual de GoEnhance.
Estime a partir de la duración de la entrada
Redondee la duración del video de entrada al segundo completo y luego multiplique por 2 tokens para 480p o por 4 tokens para 720p. Consulte la referencia de precios en vivo antes de los lotes de producción.
Integre la API de AI Dance Move en seis pasos
1
1. Crea y protege una API key
Cree una clave de GoEnhance y envíe la autorización desde código de servidor de confianza.
2
2. Aloje los medios de origen.
Proporcione URL públicas accesibles para una imagen de una persona y un video de baile de referencia de no más de 30 segundos.
3
3. Construya la solicitud
Haga una solicitud POST a
https://api.goenhance.ai/api/v1/videos/generations con model: ai_dance_move, ambas URLs y una resolución de 480p o 720p. 4
4. Guarde el identificador de la tarea
Confirme el éxito a nivel de respuesta y persista el
data.img_uuid devuelto antes de salir del controlador de la solicitud. 5
5. Haga un seguimiento de cada estado
Consulte
GET /api/v1/jobs/detail o reciba eventos de procesamiento, éxito y fallo en una URL de callback HTTPS pública. 6
6. Gestione el resultado final
Procese el éxito y el fallo de forma idempotente, verifique el contenido multimedia devuelto y evite el trabajo posterior duplicado cuando el sondeo y los callbacks se superpongan.
Construya flujos de trabajo controlados de transferencia de movimiento en torno a contenido multimedia de origen que esté autorizado a utilizar.
Casos de uso de la API de AI Dance Move
Clips de baile de creadores
Convierta un retrato de cuerpo completo aprobado en un concepto de baile breve impulsado por una rutina de referencia elegida.
Estudios de movimiento de personajes
Pruebe cómo se percibe en movimiento un personaje original o un intérprete antes de una producción de mayor envergadura.
Variantes de concepto de campaña
Parametrice las imágenes de origen y las referencias de coreografía aprobadas para colas de revisión creativa.
Previsualización de videos musicales
Explore la dirección de baile y el encuadre antes de invertir tiempo en un rodaje o una edición final.
Creativos sociales localizados
Ejecute activos de origen regionales a través de un pipeline validado de envío y finalización.
Flujos de trabajo multimedia automatizados
Conecte la generación, la persistencia del estado de la tarea, el manejo de callbacks, el almacenamiento y la aprobación humana en su aplicación.
Respuestas sobre entradas, precios, duración, resolución y entrega asíncrona.