Start generating

Control a character

Changed on

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

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/character_performance
  • Auth
    HTTP bearer

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.

Changes

  • ef7e1923afafRevision changes
    • info

      added the optional property to the response with the status

  • 4491b57b5860Revision changes
    • breaking

      removed subschema #1 subschema #3 from the /// request property anyOf list

    • breaking

      removed subschema #1 subschema #3 from the /// request property anyOf list

    • info

      added subschema #1 subschema #3 to the /// request property anyOf list

    • info

      added subschema #1 subschema #3 to the /// request property anyOf list