Skip to main content
POST
cURL
Usa act_two para aplicar la actuación de un video de referencia a una imagen de personaje o un video. La solicitud devuelve un id de tarea para recuperar el resultado finalizado.

Preparar los recursos

  • Autentícate con tu clave de API de CometAPI.
  • Establece model en act_two.
  • Proporciona character.type como image o video, con el recurso en character.uri. Mantén un rostro reconocible visible y dentro del encuadre.
  • Proporciona reference.type como video, con un clip de actuación de 3 a 30 segundos en reference.uri.
  • Reemplaza las URL de medios de ejemplo por URL HTTPS accesibles. Los campos de medios también aceptan URI de datos Base64 con un tamaño codificado de hasta 5 MB.

Configurar la actuación

Solo se requieren model, character y reference. bodyControl: false se trata como una omisión, por lo que no desactiva explícitamente el control corporal. Un seed o expressionIntensity de 0 también se trata como una omisión. Omite los campos opcionales en lugar de enviar null. Los valores opcionales de ratio son 1280:720, 720:1280, 960:960, 1104:832, 832:1104, o 1584:672.

Recuperar el resultado

Guarda el id devuelto y usa Obtener una tarea de Runway para recuperar el estado de la tarea. Cuando status sea SUCCEEDED, lee las URL de resultados de output. Si la tarea falla, inspecciona failure y failureCode cuando estén presentes.

Autorizaciones

Authorization
string
header
requerido

Your CometAPI API key.

Cuerpo

application/json

Act-Two character-performance request.

model
enum<string>
requerido

Model ID for this request.

Opciones disponibles:
act_two
character
object
requerido

Character image or video to animate. Keep a recognizable face visible and inside the frame.

reference
object
requerido

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

Rango requerido: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Rango requerido: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Opciones disponibles:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Respuesta

The task was created. Save its id for task retrieval.

id
string
requerido

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Última modificación el 18 de septiembre de 2026