Skip to main content
POST
cURL
Використовуйте act_two, щоб застосувати performance з еталонного відео до зображення персонажа або відео. Запит повертає id завдання для отримання готового результату.

Підготуйте ресурси

  • Пройдіть автентифікацію за допомогою ключа API CometAPI.
  • Установіть model на act_two.
  • Надайте character.type як image або video, розмістивши ресурс у character.uri. Зберігайте впізнаване обличчя видимим і в межах кадру.
  • Надайте reference.type як video із кліпом performance тривалістю від 3 до 30 секунд у reference.uri.
  • Замініть приклади URL-адрес медіа на доступні HTTPS URL-адреси. Поля медіа також приймають URI даних Base64 із закодованим розміром до 5 МБ.

Налаштуйте performance

Обов’язковими є лише model, character і reference. bodyControl: false вважається пропуском, тому явно не вимикає керування тілом. Значення seed або expressionIntensity, що дорівнює 0, також вважається пропуском. Не вказуйте необов’язкові поля замість надсилання null. Необов’язковими значеннями ratio є 1280:720, 720:1280, 960:960, 1104:832, 832:1104або 1584:672.

Отримайте результат

Збережіть повернений id і використовуйте Отримати завдання Runway щоб отримати статус завдання. Коли status має значення SUCCEEDED, прочитайте URL-адреси результатів з output. Якщо завдання завершиться помилкою, перевірте failure і failureCode, якщо вони наявні.

Авторизації

Authorization
string
header
обов'язково

Your CometAPI API key.

Тіло

application/json

Act-Two character-performance request.

model
enum<string>
обов'язково

Model ID for this request.

Доступні опції:
act_two
character
object
обов'язково

Character image or video to animate. Keep a recognizable face visible and inside the frame.

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

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

Необхідний діапазон: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Необхідний діапазон: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Доступні опції:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Відповідь

The task was created. Save its id for task retrieval.

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

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Останнє оновлення 18 вересня 2026 р.