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

Збережіть повернений id завдання

Збережіть повернений id, оскільки він знадобиться вам для подальшого polling.
3

Опитуйте статус завдання

Продовжуйте з Отримання завдання Runway, доки завдання не досягне кінцевого стану і метадані провайдера не міститимуть завершений результат.

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

  • 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
обов'язково