Керування персонажем

Використовуйте CometAPI з Runway Control a character API, щоб запускати завдання виконання персонажа з еталонного відео, керуючи мімікою та рухами тіла.

POST /runwayml/v1/character_performance

Create a Runway character-performance task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/character_performance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "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"
  }
}
'

200

{
  "id": "<string>"
}

Використовуйте цей endpoint, щоб перенести виконання з еталонного кліпу на зображення персонажа або відео персонажа.

​

Перш ніж викликати його

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

​

Потік завдання

1. Надішліть запит на виконання персонажа

   Створіть завдання з asset персонажа, еталонним asset і параметрами руху.

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

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

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

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

​

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

• 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.

Show child attributes

reference · object · обов'язково

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

Show child attributes

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

Aspect ratio of the output video, e.g. 1280:720.

contentModeration · object · обов'язково

Show child attributes

Відповідь

200 - application/json

Task accepted.

id · string · обов'язково