---
title: "Create a Runway character-performance task"
method: POST
path: "/runwayml/v1/character_performance"
---

# Create a Runway character-performance task

`POST /runwayml/v1/character_performance`

Submit a character asset plus a reference performance clip and receive a task id for later polling.

## Headers

- `X-Runway-Version` string, required

## Request body

- object
  - `character` object, required — The character to control. You can either provide a video or an image.
    - `type` string, required
    - `uri` string, required
  - `reference` object, required — Reference performance clip. Provide `type` (`video`) and `uri` (HTTPS URL).
    - `type` string, required
    - `uri` string, required
  - `bodyControl` boolean, required — Enable body control.
  - `expressionIntensity` integer, required — Intensity of the expression transfer. Higher values produce more exaggerated expressions.
  - `seed` integer, required — Random seed for reproducible results.
  - `model` string, required — The model variant to use. Must be act_two.
  - `ratio` string, 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
    - `publicFigureThreshold` string, required — Threshold for public-figure detection. Use `auto` for default behavior.

## Response `200`

Task accepted.

- object
  - `id` string, required

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)