Skip to main content
POST
cURL
Use 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 model to act_two.
  • Supply character.type as image or video, with the asset in character.uri. Keep a recognizable face visible and inside the frame.
  • Supply reference.type as video, with a performance clip of 3 to 30 seconds in reference.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

Only model, 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 returned id 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

Authorization
string
header
required

Your CometAPI API key.

Body

application/json

Act-Two character-performance request.

model
enum<string>
required

Model ID for this request.

Available options:
act_two
character
object
required

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

reference
object
required

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.

Required range: 0 <= x <= 5
seed
integer

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

Required range: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Available options:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Response

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

id
string
required

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.

Last modified on September 18, 2026