Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Start generating

Control a character

This endpoint will start a new task to control a character's facial expressions and body movements using a reference video.

post/v1/character_performance

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

seedinteger

If unspecified, a random number is chosen. Varying the seed integer is a way to get different results for the same other request parameters. Using the same seed integer for an identical request will produce similar results.

bodyControlboolean

A boolean indicating whether to enable body control. When enabled, non-facial movements and gestures will be applied to the character in addition to facial expressions.

expressionIntensityinteger

An integer between 1 and 5 (inclusive). A larger value increases the intensity of the character's expression.

ratio'1280:720' | '720:1280' | '960:960' | '1104:832' | '832:1104' | '1584:672'

The resolution of the output video.

model'act_two' required

Example request

{
  "character": {
    "uri": "https://example.com/image.jpg"
  },
  "reference": {
    "type": "video",
    "uri": "https://example.com/reference-performance.mp4"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}

Response

The task that was created.

idstring uuid required

The ID of the task that was created. Use this to retrieve the task later.