---
title: "RunWay Act Two Character Performance"
method: POST
path: "/v1/ai/video/runway-act-two"
tags: ["video"]
---

# RunWay Act Two Character Performance

`POST /v1/ai/video/runway-act-two`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/video/runway-act-two`
- Auth: API key in header `x-magnific-api-key`

Generate a character performance video using RunWay Act Two model. Transfer facial expressions and body movements from a reference video to a character image or video.

## Request body

- RunwayActTwoRequest
  - `webhook_url` string, uri: Webhook URL to notify the user when the task is completed
  - `character` RunwayActTwoRequestCharacter, required: The character to control. A visually recognizable face must be visible.
    - `type` 'video' | 'image', required: Type of character input (video or image)
    - `uri` string, uri, required: URL to the character video/image (must be publicly accessible)
  - `reference` RunwayActTwoRequestReference, required: Reference video of a person performing the desired actions
    - `type` 'video', required: Must be 'video'
    - `uri` string, uri, required: URL to the reference performance video (3-30 seconds)
  - `ratio` '1280:720' | '720:1280' | '1104:832' | '832:1104' | '960:960' | '1584:672': Aspect ratio for the generated video (width:height)
  - `body_control` boolean: Enable body control for non-facial movements and gestures
  - `expression_intensity` integer: Intensity of character's expressions (1-5)
  - `seed` integer: Random seed for reproducibility

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)