Управление персонажем

Используйте CometAPI с API Runway Control a character, чтобы запускать задачи исполнения персонажа на основе референсного видео, управляя мимикой и движениями тела.

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
• Укажите один ресурс character и один ресурс reference в виде доступных HTTPS URL
• Начните с bodyControl: true и умеренного expressionIntensity, прежде чем настраивать стиль

​

Поток задачи

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

   Создайте задачу, указав ресурс персонажа, референсный ресурс и настройки движения.

2. Сохраните возвращённый id задачи

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

3. Опрос статуса задачи

   Продолжайте с Get Task Details, пока обёртка не достигнет терминального состояния и метаданные провайдера не будут содержать готовый результат.

​

Входные роли

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