Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
Controlar un personaje
Usa CometAPI con la API Control a character de Runway para iniciar tareas de interpretación de personajes a partir de un video de referencia, controlando las expresiones faciales y el movimiento corporal.
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/character_performance \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"character": {
"type": "video",
"uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
},
"reference": {
"type": "video",
"uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
},
"bodyControl": true,
"expressionIntensity": 3,
"seed": 4294967295,
"model": "act_two",
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}
'{
"id": "<string>"
}Antes de llamarlo
- Envía el encabezado
X-Runway-Versionrequerido, por ejemplo2024-11-06 - Usa
model: act_two - Proporciona un recurso
charactery un recursoreferencecomo URLs HTTPS accesibles - Comienza con
bodyControl: truey unaexpressionIntensitymoderada antes de ajustar el estilo
Flujo de la tarea
Enviar la solicitud de interpretación del personaje
Guardar el id de la tarea devuelto
id devuelto, porque lo necesitas para consultarlo más tarde.Consultar el estado de la tarea
Roles de entrada
characteres el sujeto que quieres animarreferencees el clip de origen que proporciona la interpretación facial o el movimiento corporalbodyControldecide si la transferencia de movimiento incluye movimiento corporal además de la transferencia de expresionescontentModerationaplica los umbrales de moderación del proveedor a la solicitud
Autorizaciones
Bearer token authentication. Use your CometAPI key.
Encabezados
Runway version header, for example 2024-11-06.
Cuerpo
The character to control. You can either provide a video or an image.
Show child attributes
Show child attributes
Reference performance clip. Provide type (video) and uri (HTTPS URL).
Show child attributes
Show child attributes
Enable body control.
Intensity of the expression transfer. Higher values produce more exaggerated expressions.
Random seed for reproducible results.
The model variant to use. Must be act_two.
Aspect ratio of the output video, e.g. 1280:720.
Show child attributes
Show child attributes
Respuesta
Task accepted.
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/character_performance \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"character": {
"type": "video",
"uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
},
"reference": {
"type": "video",
"uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
},
"bodyControl": true,
"expressionIntensity": 3,
"seed": 4294967295,
"model": "act_two",
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}
'{
"id": "<string>"
}