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

El video generado por IA se vuelve mucho más útil cuando la persona en pantalla sigue siendo reconocible de una escena a otra. Los activos de humanos reales de AIHubMix proporcionan una forma basada en el consentimiento para usar un rostro aprobado en la generación de videos de Seedance, manteniendo la autorización, el procesamiento de activos y la generación como pasos separados y verificables.

Esta guía explica qué es el video de humanos reales, cómo funciona el flujo de trabajo de AIHubMix, por qué es útil y cómo crear un video 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 de Seedance 2.0.

¿Qué es el video de humanos reales?

El video de humanos reales es un video generado por IA que utiliza a una persona autorizada como referencia de identidad. El modelo puede cambiar el entorno, la vestimenta, la acción, el movimiento de la cámara, la voz o el idioma, mientras preserva la apariencia reconocible de la persona.

Esto es diferente de la generación de video ordinaria a partir de texto. Un aviso de texto describe lo que debería suceder, pero no identifica de manera confiable a una persona real específica. Un activo de humanos reales le da al modelo una referencia visual aprobada que puede reutilizarse en múltiples videos.

Las aplicaciones típicas incluyen avatares de creadores, presentadores virtuales, explicaciones de productos, campañas localizadas, videos de capacitación, personajes de marca y contenido social de formato corto.

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 en la imagen que complete el flujo de autorización.
Agregar un retrato y esperar hasta que el activo esté activo.
Referenciar el activo activo con un asset:// URI.
Enviar una tarea de video de Seedance y consultarla hasta su finalización.

La separación es deliberada. La autorización ocurre antes de la generación, la preparación del activo puede verificarse de forma independiente y cada etapa importante expone un estado que su aplicación puede monitorear.

¿Por qué usar AIHubMix?

Una API para todo el flujo de trabajo

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

Autorización explícita

La persona en el retrato completa la página de autorización. Esto crea un paso de consentimiento claro antes de que la imagen se use como una referencia reutilizable de humanos reales.

Activos de identidad reutilizables

Después de que una imagen se vuelve activa, las aplicaciones pueden reutilizar su ID de activo en múltiples solicitudes de video en lugar de cargar la imagen original cada vez.

Generación lista para Seedance

El punto final nativo de Seedance 2.5 admite referencias de texto, imagen, video y audio, además de controles para duración, resolución, relación de aspecto y generación de audio.

Estados observables y amigables para la producción

Su aplicación puede esperar por verified, active y completed en lugar de adivinar si una operación terminó. Esto facilita la implementación de reintentos y manejo de errores.

Tutorial paso a paso

Paso 1: Prepare una clave API y un retrato

Crear una clave API en la Consola de AIHubMix. Mantenla privada. En la Terminal, configúrela como una variable de entorno:

export AIHUBMIX_API_KEY="your_api_key"

Prepare una URL de imagen HTTPS directa. La URL debe devolver el archivo de imagen sin inicio de sesión ni encabezados personalizados y debe permanecer disponible mientras AIHubMix lo procesa.

Requisitos de imagen recomendados:

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: Crear un grupo de activos de humanos reales

Ejecute este comando en la 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"}'

Guarde el id devuelto, que se verá como ag_...:

GROUP_ID="ag_your_group_id"

Un nuevo grupo normalmente comienza con pending_auth.

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

Use 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 una verification_url temporal. Abra esa URL en un navegador y pida a la persona en el retrato que revise el propósito y complete el flujo de autorización.

La URL es sensible y temporal. No la publique, no la comprometa en un repositorio ni la incluya en capturas de pantalla.

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

Después de que la persona termine el flujo en el navegador, consulte 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úe 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; use el estado de la API.

Paso 5: Agregar el retrato

Envía la URL de imagen directa:

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

Guarde el ID de activo devuelto y consúltelo:

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

Use el activo solo cuando su estado sea active. creating y processing significan que aún no está listo.

Paso 6: Generar un video de Seedance 2.5

El activo de humanos reales pertenece a input_references[].url. No debe pegarse en el texto del aviso:

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\":\"Un vlog vertical realista. La persona sonríe, saluda y dice en japonés: やっほー！今日も笑顔でね！ Mantén el rostro consistente, sincroniza el movimiento de los labios, usa un movimiento de manos natural y no agregues subtítulos.\",
    \"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 video. Consulte GET /ai/v1/videos/{id} hasta que la tarea esté completed, luego descargue la salida rápidamente porque las URL de video son temporales.

Seedance 2.5 y Seedance 2.0

Seedance 2.5 utiliza el punto final 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 mezcle los dos formatos de solicitud. Antes de usar en producción, verifique el esquema del modelo en vivo para las duraciones, resoluciones, tipos de referencia, comportamiento de audio y rutas de punto final admitidos.

Mejores prácticas para la redacción de avisos

Describa el entorno, la acción, el tiempo, el movimiento de la cámara, la voz y las restricciones. Un aviso sólido podría especificar un kimono, flores de cerezo cayendo, una ola suave, diálogo en japonés, movimiento de labios sincronizado, movimiento natural del cabello y sin subtítulos.

Cinco segundos funcionan bien para un saludo corto. Si el video incluye varias acciones o una oración larga, use una duración más larga o acorte el guion para que la actuación no se sienta apresurada.

Use una referencia de identidad para una prueba simple. Agregue 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: espere a que la sesión de verificación se vuelva verified y el grupo se vuelva active.
El activo está procesando: consulte el ID de activo original; no cree duplicados con un nuevo ID.
La URL de la imagen falla: use una URL de archivo HTTPS pública, no una ruta local, página de inicio de sesión o página de compartir.
El video rechaza el activo: confirme que el activo esté active, pertenezca a la misma cuenta y use 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. Use el campo de referencia de API para activos registrados.

Lista de verificación final

Clave 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 video usa asset://<asset_id>.
La tarea de video se consulta hasta completed.

Los activos de humanos reales de AIHubMix brindan a los desarrolladores una forma práctica de construir experiencias de video basadas en el consentimiento y consistentes en identidad con Seedance. Comience con un retrato aprobado y un clip de prueba corto, luego expanda el mismo flujo de trabajo en herramientas para creadores, contenido de marca y aplicaciones de producción.