Especificaciones técnicas de runwayml-character-performance
| Especificación | Detalles |
|---|---|
| ID del modelo | runwayml-character-performance |
| Proveedor | Runway |
| Tipo de modelo | Interpretación de personajes / captura de interpretación con IA |
| Función principal | Transfiere un video de actuación guía a una imagen o un video del personaje |
| Entradas principales | Video de actuación guía + imagen o video de referencia del personaje |
| Tipo de salida | Clip de video generado con el movimiento, las expresiones faciales y la sincronía del habla transferidos |
| Entrada de personaje admitida | Imagen o video |
| Transferencia de gestos | Compatible para flujos de trabajo con imagen del personaje; no compatible cuando la entrada del personaje es un video |
| Control facial | Admite expresividad facial ajustable / intensidad de la expresión |
| Movimiento ambiental | Se añade automáticamente cuando la entrada del personaje es una imagen |
| Resoluciones de salida | 1280×720, 720×1280, 960×960, 1104×832, 832×1104, 1584×672 |
| Relaciones de aspecto | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| Velocidad de fotogramas | 24 FPS |
| Duración del clip | Mínimo de 3 segundos, hasta 30 segundos |
| Patrón de acceso en CometAPI | API REST a través del endpoint de interpretación de personajes compatible con Runway |
¿Qué es runwayml-character-performance?
runwayml-character-performance es el identificador de plataforma de CometAPI para el flujo de trabajo de generación de interpretación de personajes de Runway, descrito por Runway como Act-Two. El modelo está diseñado para animar un personaje a partir de un clip de interpretación humana: proporcionas un video de alguien actuando y una imagen o video del personaje, y el sistema transfiere el movimiento facial, la expresión, la sincronía del habla y el movimiento corporal a una toma del personaje generada.
Este modelo está pensado para flujos de trabajo de creadores que necesitan animación de personajes rápida sin un sistema tradicional de captura de movimiento. Runway lo describe como una forma de dar vida a los personajes con movimiento, habla y expresión realistas, a la vez que admite personajes no humanos y estilos visuales variados. Cuando el personaje objetivo es una imagen fija, el sistema también puede sintetizar movimiento ambiental para que la toma se sienta más natural.
En CometAPI, esta capacidad se expone a través del endpoint de interpretación de personajes de Runway, lo que lo hace adecuado para equipos de producto, herramientas creativas, canalizaciones de prototipado y flujos de trabajo de medios automatizados que desean acceso programable a la animación de personajes impulsada por la interpretación. (cometapi.com)
Funciones principales de runwayml-character-performance
- Transferencia de interpretación: Mapea la interpretación de una persona desde un video fuente sobre un personaje objetivo, incluyendo movimiento facial, expresiones y movimiento corporal más amplio.
- Entrada de personaje flexible: Acepta una imagen o un video del personaje, ofreciendo a los desarrolladores distintos compromisos entre control de movimiento y preservación de la escena.
- Control de gestos para personajes basados en imagen: Al usar una imagen del personaje, el modelo puede transferir gestos y poses corporales desde el clip de interpretación, habilitando una animación más expresiva.
- Animación de imagen sensible a la escena: Para entradas de personaje con imagen fija, el sistema añade automáticamente movimiento ambiental o tipo cámara para evitar resultados estáticos o artificialmente congelados.
- Flujo de trabajo que preserva el video del personaje: Cuando la entrada del personaje es un video, el resultado conserva el sujeto, la escena y el movimiento de cámara originales mientras aplica la transferencia de interpretación facial.
- Expresividad facial ajustable: Admite controles de intensidad de la expresión, permitiendo equilibrar una transferencia de actuación más fuerte frente a la estabilidad y la consistencia visual.
- Opciones de salida aptas para producción: Admite múltiples relaciones de aspecto y resoluciones comunes a 24 FPS, haciéndolo útil para formatos horizontal, vertical, cuadrado y cinematográficos en social/video.
- Optimización para animación de formato corto: Ideal para clips cortos, con un mínimo de 3 segundos y hasta 30 segundos, lo que encaja con anuncios, clips sociales, fragmentos de diálogo, previs y escenas de prototipo.
Cómo acceder e integrar runwayml-character-performance
Paso 1: Regístrate para obtener una clave de API
Inicia sesión en CometAPI. Si aún no eres usuario, regístrate primero. Luego abre tu centro personal, crea un token de API y copia tu clave para la autenticación en solicitudes posteriores. CometAPI expone este modelo a través de su infraestructura de API compatible con Runway. (cometapi.com)
Paso 2: Envía solicitudes a la API runwayml-character-performance
Usa el endpoint de interpretación de personajes de Runway en CometAPI y establece el campo del modelo en runwayml-character-performance en tu capa de aplicación. El flujo de solicitud subyacente usa la ruta de interpretación de personajes con entrada JSON para la actuación guía, el recurso del personaje, los controles de movimiento y la configuración de salida. (cometapi.com)
curl --location --request POST 'https://api.cometapi.com/runwayml/v1/character_performance' \
--header 'X-Runway-Version: 2024-11-06' \
--header 'Authorization: Bearer YOUR_COMETAPI_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"character": {
"type": "video",
"uri": "https://your-file-host.example/character.mp4"
},
"reference": {
"type": "video",
"uri": "https://your-file-host.example/performance.mp4"
},
"bodyControl": true,
"expressionIntensity": 3,
"seed": 4294967295,
"model": "runwayml-character-performance",
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}'
Paso 3: Recupera y verifica los resultados
Tras el envío, procesa la respuesta de la API en tu backend o aplicación cliente y verifica que la generación devuelta se ajuste a la duración, el encuadre y la calidad expresiva esperados. En la práctica, también deberías validar que los recursos de entrada sigan las mejores prácticas de Runway: metraje de interpretación con un único sujeto claro, rostro visible, encuadre estable y referencias de personaje adecuadas, para mejorar la fiabilidad del resultado. (cometapi.com)