API de transferencia de movimiento: pon a una persona nueva en cualquier vídeo

Tienes un vídeo que funciona. Ahora lo quieres con otra persona: tu propio creador, un cliente o alguien que todavía no existe. La API de Hermoso lo hace en una sola petición. Envía el vídeo y la persona, y la persona nueva hace cada movimiento, gesto y forma de la boca del original, con los mismos tiempos y cortes, en la misma sala y con la misma luz. El sonido original se mantiene.

Lee la documentación de la API →

¿Cómo es una llamada?

Envía el vídeo y quién debe aparecer en él. Con "dry_run": true no se ejecuta nada, y la respuesta es el precio exacto.

curl -sX POST https://app.hermoso.ai/v1/recasts \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{
    "video": "https://www.tiktok.com/@someone/video/7400000000000000000",
    "person": { "describe": "a woman in her 30s, curly dark hair, denim jacket" },
    "dry_run": true
  }'

Envía la misma petición sin "dry_run": true y empieza. Recibes un trabajo al instante, y el vídeo terminado cuando esté listo: minutos para un clip corto, más para uno largo.

¿A quién puedes poner en el vídeo?

• Tu creador guardado, o uno de los creadores de IA ya hechos, por id.
• Una foto de la persona, por enlace.
• Una persona de IA a partir de tus palabras. Descríbela (edad, pelo, estilo, actitud) y Hermoso la crea primero y luego la pone en el vídeo. Queda en tu Biblioteca, así que puedes volver a usarla.

¿Quieres que también suene distinta? Añade una voz nueva con las mismas palabras y los mismos tiempos, o haz que hable otro idioma con la boca ajustada a las nuevas palabras. Es la misma petición y el mismo trabajo.

¿Qué vídeos sirven?

Un enlace de TikTok, Reel, Facebook, X o YouTube, un enlace a un archivo de vídeo o un archivo que hayas subido a Hermoso. Una llamada cubre hasta 60 segundos, y puedes elegir un tramo con un inicio y un final.

¿Cuánto cuesta?

Depende de la duración del vídeo y de si añades una voz nueva, así que nunca lo adivinamos. Una prueba sin ejecución te da el precio exacto, paso a paso, antes de que se ejecute nada. La llamada real reserva esa cantidad y se liquida por lo que de verdad costó el render, nunca más. Consulta los precios para saber cuánto vale un crédito.

¿Puedes cambiar un objeto en lugar de una persona?

Sí. Un segundo endpoint cambia una cosa de un clip a partir de una instrucción sencilla: "cambia solo la taza a rojo", "cambia la botella por nuestro producto", "haz que sea de noche". El movimiento, los tiempos y el encuadre se mantienen. Añade una imagen del producto o material real y el cambio se ajusta a él.

curl -sX POST https://app.hermoso.ai/v1/edits \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{ "video": "https://example.com/clip.mp4", "instruction": "change only the mug to red", "dry_run": true }'

¿No sabes cómo quedará? Pide primero una vista previa de un solo fotograma. Ves el cambio en una imagen fija, con el precio del clip completo al lado, y el clip solo se ejecuta cuando tú lo dices.

Hecho para tu backend

• Asíncrono. Una llamada real responde al instante con un trabajo. Consulta el trabajo, o danos un enlace y te enviamos el vídeo terminado.
• Seguro de reintentar. Envía de nuevo la misma clave de idempotencia y recibes el mismo trabajo, nunca un segundo render.
• Rechazos claros. Cuando algo no se puede ejecutar, sabes por qué antes de que se cobre nada, con un código que tu código puede usar para decidir.
• Una sola clave de API desde la app, la misma que usan el servidor MCP y la línea de comandos.

¿Y las personas reales?

Una foto de una persona real necesita un plan de pago, y al enviarla confirmas que tienes su permiso. Una persona de IA a partir de tus palabras, o un creador de IA ya hecho, funciona en todos los planes. Las peticiones que pondrían a alguien en una escena en la que nunca debería estar se rechazan antes de que se ejecute nada.

¿Prefieres hacer clic en lugar de programar?

El mismo cambio está en la app, en cambiar a una persona en un vídeo, y tu agente de IA puede hacerlo por MCP. Los tres usan el mismo motor y cuestan lo mismo.

Preguntas frecuentes

¿Qué es una API de transferencia de movimiento?

Toma un vídeo y una persona distinta y devuelve el vídeo con esa persona, haciendo exactamente lo que hacía la persona original: los mismos movimientos, gestos, tiempos y cortes. La versión de Hermoso además mantiene el sonido original y puede darle a la persona nueva otra voz u otro idioma.

¿Cuánto cuesta cambiar a la persona de un vídeo?

Depende de la duración del vídeo y de si añades una voz nueva. Envía la petición con dry_run y recibes el precio exacto antes de que se ejecute nada. La llamada real nunca cobra más que eso.

¿Puedo usar la foto de una persona real?

Sí, con un plan de pago y solo con el permiso de esa persona. Al enviar la foto confirmas que lo tienes. Una persona de IA creada a partir de una descripción, o un creador de IA ya hecho, funciona en todos los planes.

¿Cuánto tarda?

Depende de la duración: minutos para un clip corto, más para uno largo o con voz nueva. La llamada responde al instante con un trabajo, y tú lo consultas o recibes el vídeo terminado en un enlace que elijas.

¿Puedo cambiar un objeto en lugar de una persona?

Sí. El endpoint de ediciones cambia una cosa de un clip a partir de una instrucción sencilla, como cambiar el color de una taza o sustituir una botella por tu producto, y deja todo lo demás como estaba.