Cómo usar un rostro real en Seedance 2.5 con los activos de humanos reales de AIHubMix

El vídeo con IA resulta mucho más útil cuando la persona en pantalla sigue siendo reconocible de una escena a otra. Los activos de humanos reales de AIHubMix ofrecen una forma basada en el consentimiento de usar un rostro aprobado en la generación de vídeo de Seedance, manteniendo la autorización, el procesamiento del activo y la generación como pasos separados y verificables.

Esta guía explica qué es el vídeo con humanos reales, cómo funciona el flujo de trabajo de AIHubMix, por qué es útil y cómo crear un vídeo de Seedance 2.5 a partir de un rostro real. También explica la diferencia entre la API nativa de Seedance 2.5 y las integraciones compatibles con Seedance 2.0.

¿Qué es el vídeo con humanos reales?

El vídeo con humanos reales es vídeo generado con IA que utiliza a una persona autorizada como referencia de identidad. El modelo puede cambiar el escenario, la ropa, la acción, el movimiento de cámara, la voz o el idioma, al tiempo que conserva la apariencia reconocible de la persona.

Esto es distinto de la generación ordinaria de texto a vídeo. Un prompt de texto describe lo que debe ocurrir, pero no identifica de forma fiable a una persona real concreta. Un activo de humano real proporciona al modelo una referencia visual aprobada que puede reutilizarse en varios vídeos.

Las aplicaciones habituales incluyen avatares de creadores, presentadores virtuales, explicaciones de productos, campañas localizadas, vídeos de formación, personajes de marca y contenido corto para redes sociales.

Cómo funciona el flujo de trabajo de AIHubMix

El flujo de trabajo tiene cinco etapas principales:

Crear un grupo de activos para una persona.
Pedir a la persona de la imagen que complete el flujo de autorización.
Añadir un retrato y esperar hasta que el activo esté activo.
Hacer referencia al activo activo con un URI asset://.
Enviar una tarea de vídeo de Seedance y consultarla hasta que se complete.

La separación es deliberada. La autorización se produce antes de la generación, la disponibilidad del activo puede comprobarse de forma independiente y cada etapa importante muestra un estado que tu aplicación puede supervisar.

¿Por qué usar AIHubMix?

Una sola API para todo el flujo de trabajo

AIHubMix proporciona endpoints para grupos de activos, sesiones de verificación, activos humanos y generación de vídeo asíncrona. La misma cuenta y la misma clave de API pueden gestionar todo el proceso.

Autorización explícita

La persona del retrato completa la página de autorización. Esto crea un paso de consentimiento claro antes de que la imagen se utilice como referencia reutilizable de un humano real.

Activos de identidad reutilizables

Una vez que una imagen está activa, las aplicaciones pueden reutilizar su ID de activo en varias solicitudes de vídeo en lugar de subir la imagen original cada vez.

Generación lista para Seedance

El endpoint nativo de Seedance 2.5 admite referencias de texto, imagen, vídeo y audio, además de controles de duración, resolución, relación de aspecto y generación de audio.

Estados observables y aptos para producción

Tu aplicación puede esperar a verified, active y completed en lugar de suponer si una operación ha terminado. Esto facilita implementar reintentos y el manejo de errores.

Tutorial paso a paso

Paso 1: Prepara una clave de API y un retrato

Crea una clave de API en la consola de AIHubMix. Mantenla privada. En Terminal, configúrala como variable de entorno:

export AIHUBMIX_API_KEY="your_api_key"

Prepara una URL HTTPS directa de la imagen. La URL debe devolver el archivo de imagen sin inicio de sesión ni encabezados personalizados, y debe seguir disponible mientras AIHubMix la procesa.

Requisitos recomendados para la imagen:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF
Menos de 30 MB
Ancho y alto mayores de 300 píxeles y menores de 6000 píxeles
Relación de aspecto mayor que 0,4 y menor que 2,5
Un retrato claro de la misma persona que completa la autorización

Paso 2: Crea un grupo de activos de humanos reales

Ejecuta este comando en Terminal:

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

Guarda el id devuelto, que tiene un formato como ag_...:

GROUP_ID="ag_your_group_id"

Un grupo nuevo normalmente comienza con pending_auth.

Paso 3: Crea una sesión de autorización

Usa el ID del grupo para solicitar una sesión de verificación:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

La respuesta contiene un verification_url temporal. Abre esa URL en un navegador y pide a la persona del retrato que revise la finalidad y complete el flujo de autorización.

La URL es sensible y temporal. No la publiques, no la subas a un repositorio ni la incluyas en capturas de pantalla.

Paso 4: Verifica la autorización y el estado del grupo

Cuando la persona termine el flujo en el navegador, consulta ambos recursos:

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Continúa solo cuando la sesión de verificación esté verified y el grupo de activos esté active. Una página de error del navegador no determina el resultado final; usa el estado de la API.

Paso 5: Añade el retrato

Envía la URL directa de la imagen:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

Guarda el ID de activo devuelto y consúltalo:

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Usa el activo solo cuando su estado sea active. creating y processing significan que todavía no está listo.

Paso 6: Genera un vídeo de Seedance 2.5

El activo de humano real debe ir en input_references[].url. No debe pegarse en el texto del prompt:

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

La respuesta devuelve un ID de tarea de vídeo. Consulta GET /ai/v1/videos/{id} hasta que la tarea esté completed y descarga el resultado pronto, ya que las URL de los vídeos son temporales.

Seedance 2.5 y Seedance 2.0

Seedance 2.5 utiliza el endpoint nativo /ai/v1/videos descrito anteriormente. Las integraciones más antiguas pueden usar Seedance 2.0 con el protocolo compatible /v1/videos y una estructura de contenido diferente.

No mezcles los dos formatos de solicitud. Antes de usarlo en producción, revisa el esquema del modelo en vivo para comprobar las duraciones, resoluciones, tipos de referencia, comportamiento del audio y rutas de endpoint admitidas.

Buenas prácticas para los prompts

Describe el entorno, la acción, el ritmo, el movimiento de cámara, la voz y las restricciones. Un prompt sólido podría especificar un kimono, pétalos de cerezo cayendo, un saludo con la mano, diálogo en japonés, movimiento de labios sincronizado, movimiento natural del cabello y sin subtítulos.

Cinco segundos funcionan bien para un saludo breve. Si el vídeo incluye varias acciones o una frase larga, usa una duración mayor o acorta el guion para que la interpretación no parezca apresurada.

Usa una sola referencia de identidad para una prueba sencilla. Añade referencias adicionales solo cuando el esquema del modelo las admita y cada activo pertenezca al mismo grupo de activos.

Problemas comunes

El grupo no está activo: espera a que la sesión de verificación pase a verified y el grupo a active.
El activo se está procesando: consulta el ID de activo original; no crees duplicados con un ID nuevo.
La URL de la imagen falla: usa una URL pública de archivo HTTPS, no una ruta local, una página de inicio de sesión ni una página de compartir.
El vídeo rechaza el activo: confirma que el activo está active, pertenece a la misma cuenta y usa el tipo de medio correcto.
Playground no muestra asset://: la carga de imágenes en Playground y el registro de activos de humanos reales son flujos de trabajo separados. Usa el campo de referencia de la documentación de la API para los activos registrados.

Lista de verificación final

Clave de API configurada de forma segura.
Grupo de activos creado.
Autorización de la persona completada.
El estado del grupo es active.
El estado del activo de retrato es active.
La solicitud de vídeo usa asset://<asset_id>.
La tarea de vídeo se consulta hasta que esté completed.

Los activos de humanos reales de AIHubMix ofrecen a los desarrolladores una forma práctica de crear experiencias de vídeo basadas en el consentimiento y con identidad consistente con Seedance. Empieza con un retrato aprobado y un clip de prueba corto, y luego amplía el mismo flujo de trabajo a herramientas para creadores, contenido de marca y aplicaciones de producción.