Skip to main content
POST
cURL
Usa este endpoint para transferir la actuación de un clip de referencia a una imagen o video de personaje.

Antes de llamarlo

  • Envía el encabezado X-Runway-Version requerido, por ejemplo 2024-11-06
  • Usa model: act_two
  • Proporciona un recurso character y un recurso reference como URLs HTTPS accesibles
  • Comienza con bodyControl: true y una expressionIntensity moderada antes de ajustar el estilo

Proporción de salida

Flujo de la tarea

1

Enviar la solicitud de actuación de personaje

Crea la tarea con tu recurso de personaje, recurso de referencia y configuración de movimiento.
2

Guardar el id de la tarea devuelto

Conserva el id devuelto, porque lo necesitarás para consultarlo más adelante.
3

Consultar el estado de la tarea

Continúa con Obtener una tarea de Runway hasta que la tarea alcance un estado terminal y los metadatos del proveedor incluyan la salida finalizada.

Roles de entrada

  • character es el sujeto que quieres animar
  • reference es el clip de origen que proporciona la actuación facial o el movimiento corporal
  • bodyControl decide si la transferencia de movimiento incluye movimiento corporal además de la transferencia de expresiones
  • contentModeration aplica los umbrales de moderación del proveedor a la solicitud

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

X-Runway-Version
string
requerido

Runway version header, for example 2024-11-06.

Cuerpo

application/json
character
object
requerido

The character to control. You can either provide a video or an image.

reference
object
requerido

Reference performance clip. Provide type (video) and uri (HTTPS URL).

bodyControl
boolean
predeterminado:true
requerido

Enable body control.

expressionIntensity
integer
predeterminado:1
requerido

Intensity of the expression transfer. Higher values produce more exaggerated expressions.

seed
integer
predeterminado:1
requerido

Random seed for reproducible results.

model
string
predeterminado:act_two
requerido

The model variant to use. Must be act_two.

ratio
string
predeterminado:1280:720
requerido

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
requerido

Respuesta

200 - application/json

Task accepted.

id
string
requerido