Skip to main content
POST
cURL
Використовуйте цей endpoint, щоб трансформувати наявний вихідний кліп за допомогою workflow video-to-video від Runway. Він запускає асинхронне завдання замість негайного повернення фінального результату.

Перед викликом

  • Підготуйте вихідне відео, яке відповідає вимогам провайдера до вхідних даних
  • Додайте обов’язковий заголовок X-Runway-Version для потрібного вам набору функцій
  • Почніть з одного короткого Prompt, який описує зміну, а не повного сторіборду

Співвідношення сторін виходу

Цей endpoint очікує значення ratio, розділені двокрапкою. Використовуйте 1280:720 для виходу 1280x720 і 720:1280 для 720x1280; 1280x720 підтримується не в кожному маршруті Runway video-to-video.

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

1

Надішліть вихідний кліп і Prompt

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

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

Використовуйте Отримати завдання Runway, доки завдання не досягне кінцевого стану.
3

Збережіть трансформований результат

Завантажте або збережіть готовий asset через ваш стандартний медіапайплайн.

Авторизації

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

Bearer token authentication. Use your CometAPI key.

Заголовки

X-Runway-Version
string
обов'язково

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

Тіло

application/json
videoUri
string
за замовчуванням:https://your-video-host/source.mp4
обов'язково

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
за замовчуванням:A cat yawning in slow motion.
обов'язково

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
за замовчуванням:1
обов'язково

Random seed for reproducible results. Range: 0–4294967295.

model
string
за замовчуванням:gen4_aleph
обов'язково

Model variant to use.

references
object[]
обов'язково

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
за замовчуванням:1280:720
обов'язково

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

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

Відповідь

200 - application/json

success

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

The ID of the task that was created. Use this to retrieve the task later.