Используйте Runway Aleph через Rivya Public API v1: ID модели runway-aleph, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIГотовностьВидео

ID модели API

runway-aleph

Входные данные

file

Files API

Требуется для референсных режимов

Базовые кредиты

per_video · default=90 · ⌈total⌉

Возможность

Видео

Биллинг

FIXED

Лимит промпта

5000 символов

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

Ключ	Тип	Обязательно	По умолчанию	Описание
model	string	Да	runway-aleph	Используйте runway-aleph как ID модели API.
prompt	string	Да	-	Максимум 5000 символов для этой модели.
params	object	Нет	-	Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_id	string	Нет	-	Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
aspectRatio	select	Нет	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9	Соотношение сторон
waterMark	text	Нет	-	-	-	Водяной знак
seed	number	Нет	-	-	-	Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1.

Политика загрузки

Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.

Правило референсных материалов

Входные медиа: Загрузите исходный клип, который Aleph должен трансформировать. Добавляйте одно необязательное статичное изображение только когда нужно дополнительное направление по стилю или субъекту.

Макс. файлов

Принимаемые типы файлов

video, image

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kind	Макс. размер	MIME-типы
video	95 MB	video/mp4, video/quicktime
image	10 MB	image/jpeg, image/png, image/webp

Минимальный запрос

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Оставьте пустым, чтобы отключить водяной знак",
    "seed": 1
  }
}

Запрос с референсным файлом

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Оставьте пустым, чтобы отключить водяной знак",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api"
      }
    ]
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_runway_aleph_example",
  "status": "queued",
  "model": "runway-aleph",
  "reserved_credits": 90,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Некоторым режимам нужны референсные файлы, загруженные через Files API.

Интеграция Runway Aleph API