Skip to main content
POST
/
runwayml
/
v1
/
character_performance
cURL
curl https://api.cometapi.com/runwayml/v1/character_performance \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "character": {
        "type": "video",
        "uri": "https://your-video-host/character.mp4"
      },
      "reference": {
        "type": "video",
        "uri": "https://your-video-host/performance.mp4"
      },
      "model": "act_two",
      "ratio": "1280:720"
    }'
{
  "id": "5b91e444-c232-deaf-a4d7-8aef3e57336b"
}
Use this endpoint to transfer performance from a reference clip onto a character image or character video.

​
Before you call it

  • Send the required X-Runway-Version header, for example 2024-11-06
  • Use model: act_two
  • Provide one character asset and one reference asset as accessible HTTPS URLs
  • Start with bodyControl: true and a moderate expressionIntensity before tuning style

​
Output ratio

SettingSupported valuesDefault starting pointBoundary behavior
ratio1280:720, 720:1280, or another ratio accepted by the selected Runway model/version1280:720Keep the character and reference assets close to the requested frame shape.

​
Task flow

1

Submit the character-performance request

Create the task with your character asset, reference asset, and motion settings.
2

Store the returned task id

Keep the returned id, because you need it for later polling.
3

Poll task status

Continue with Get a Runway task until the task reaches a terminal state and provider metadata includes the finished output.

​
Input roles

  • character is the subject you want to animate
  • reference is the source clip that provides facial performance or body motion
  • bodyControl decides whether motion transfer includes body movement in addition to expression transfer
  • contentModeration applies provider moderation thresholds to the request

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Headers

​
X-Runway-Version
string
required

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

Body

application/json
​
character
object
required

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

​
reference
object
required

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

​
bodyControl
boolean
default:true
required

Enable body control.

​
expressionIntensity
integer
default:1
required

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

​
seed
integer
default:1
required

Random seed for reproducible results.

​
model
string
default:act_two
required

The model variant to use. Must be act_two.

​
ratio
string
default:1280:720
required

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
required

Response

200 - application/json

Task accepted.

​
id
string
required