Create a Runway character performance
Create a Runway Act-Two character-performance task through CometAPI using a character image or video and a reference performance clip.
act_two to apply a reference video’s performance to a character image
or video. The request returns a task id for retrieving the finished output.
Prepare the assets
- Authenticate with your CometAPI API key.
- Set
modeltoact_two. - Supply
character.typeasimageorvideo, with the asset incharacter.uri. Keep a recognizable face visible and inside the frame. - Supply
reference.typeasvideo, with a performance clip of 3 to 30 seconds inreference.uri. - Replace the example media URLs with accessible HTTPS URLs. Media fields also accept Base64 data URIs with an encoded size of up to 5 MB.
Configure the performance
Onlymodel, character, and reference are required.
bodyControl: false is treated as omission, so it does not explicitly
disable body control. A seed or expressionIntensity of 0 is also
treated as omission. Omit optional fields instead of sending null.
Optional ratio values are 1280:720,
720:1280, 960:960, 1104:832, 832:1104, or 1584:672.
Retrieve the result
Save the returnedid and use
Get a Runway task to retrieve the task status.
When status is SUCCEEDED, read the result URLs from output. If the task
fails, inspect failure and failureCode when present.Authorizations
Your CometAPI API key.
Body
Act-Two character-performance request.
Model ID for this request.
act_two Character image or video to animate. Keep a recognizable face visible and inside the frame.
- Option 1
- Option 2
Reference video containing the performance to apply. The video must be 3 to 30 seconds long.
Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.
Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.
0 <= x <= 5Sampling seed. Omit for a random seed; 0 is treated as omission.
0 <= x <= 4294967295Optional requested frame dimensions.
1280:720, 720:1280, 960:960, 1104:832, 832:1104, 1584:672 Content moderation settings. Omit to use the standard settings.
Response
The task was created. Save its id for task retrieval.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Task cost metadata, when returned.