Control a character

POST

https://api.cometapi.com/runwayml/v1/character_performance

Maintainer:Not configured

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cometapi.com/runwayml/v1/character_performance' \
--header 'X-Runway-Version: 2024-11-06' \
--header 'Authorization: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "character": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "reference": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "seed": 4294967295,
  "model": "act_two",
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}'

Response Example

{}

Request

Authorization

Header Params

Body Params application/json

Examples

Responses

🟢200success

application/json

The task has been successfully created.

Body

Upscale a video

runway to get task details