Runway

Runway Gen-4

Создание и редактирование видео

POSThttps://api.aisetup.ru/v1/video/generations

Header:Authorization: Bearer YOUR_KEY

Параметры

Параметр	Тип	Описание
model	string	"runway-gen4"
webhook_url*	string	URL для webhook (необязателен), поллинг: GET /v1/requests/{id}
input	object	Параметры запроса.
↳ prompt	string	Текстовое описание видео. Обязателен ВСЕГДА — в т.ч. при передаче image_url (image-to-video).
↳ image_url*	string	URL опорного изображения (ровно 1). Если задан — image-to-video, если нет — text-to-video. Форматы: JPG/PNG/WEBP.
↳ resolution*	string	Разрешение: "720" \| "1080". По умолчанию "720". Внимание: "1080" доступно ТОЛЬКО при duration=5. Комбинация 1080+10 будет отклонена с 400.
↳ duration*	number	Длительность в секундах: 5 \| 10. По умолчанию 5. Для duration=10 доступно только resolution=720.
↳ aspect_ratio*	string	Соотношение сторон: "16:9" \| "9:16" \| "1:1" \| "4:3" \| "3:4". По умолчанию "16:9".

* — опциональные поля.

Пример запроса

# text-to-video (prompt обязателен)
curl -s "https://api.aisetup.ru/v1/video/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"runway-gen4","input":{"prompt":"A lone surfer riding a massive wave at sunset","resolution":"720","duration":5,"aspect_ratio":"16:9"}}'

# image-to-video (prompt всё равно обязателен; 1080 только при duration=5)
curl -s "https://api.aisetup.ru/v1/video/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"runway-gen4","webhook_url":"https://your.site/hook","input":{"prompt":"Wind blows through the hair, cinematic","image_url":"https://example.com/portrait.jpg","resolution":"1080","duration":5}}'

Ответы API

Структура ответа

Поле	Тип	Описание
id	string	ID запроса для polling / webhook.
status	string	running — генерация запущена.

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "status": "running"
}

Получение результата

Webhook или polling, подробнее в карточке «Проверка статуса видео-запроса»

При успехе result.type = "video_generation", массив result.videos:

{
  "id": "REQUEST_ID",
  "status": "success",
  "result": {
    "type": "video_generation",
    "videos": [
      "https://cdn.aisetup.ru/.../result.mp4"
    ]
  }
}