Skip to main content
POST
cURL
Используйте этот endpoint, чтобы перенести performance из референсного клипа на изображение персонажа или видео персонажа.

Перед вызовом

  • Отправьте обязательный заголовок X-Runway-Version, например 2024-11-06
  • Используйте model: act_two
  • Укажите один asset character и один asset reference в виде доступных HTTPS URL
  • Начните с bodyControl: true и умеренного expressionIntensity, прежде чем настраивать стиль

Соотношение сторон вывода

Поток задачи

1

Отправьте запрос character-performance

Создайте задачу с вашим asset character, asset reference и настройками движения.
2

Сохраните возвращённый task id

Сохраните возвращённый id, потому что он понадобится для последующего опроса.
3

Опрашивайте статус задачи

Продолжайте с Get a Runway task, пока задача не достигнет конечного состояния и metadata провайдера не будет включать готовый результат.

Роли входных данных

  • character — это объект, который вы хотите анимировать
  • reference — это исходный клип, который задаёт мимику или движения тела
  • bodyControl определяет, включает ли перенос движения движения тела в дополнение к переносу мимики
  • contentModeration применяет пороги модерации провайдера к запросу

Авторизации

Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Заголовки

X-Runway-Version
string
обязательно

Runway version header, for example 2024-11-06.

Тело

application/json
character
object
обязательно

The character to control. You can either provide a video or an image.

reference
object
обязательно

Reference performance clip. Provide type (video) and uri (HTTPS URL).

bodyControl
boolean
по умолчанию:true
обязательно

Enable body control.

expressionIntensity
integer
по умолчанию:1
обязательно

Intensity of the expression transfer. Higher values produce more exaggerated expressions.

seed
integer
по умолчанию:1
обязательно

Random seed for reproducible results.

model
string
по умолчанию:act_two
обязательно

The model variant to use. Must be act_two.

ratio
string
по умолчанию:1280:720
обязательно

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
обязательно

Ответ

200 - application/json

Task accepted.

id
string
обязательно