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 и сохраните возвращённый task 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.