Поддерживаемые провайдеры
Runway ML
Конвертация Runway ML API в Meridian — text-to-video, image-to-video и video-to-video генерация через асинхронный task-based API.
Обзор
Runway ML предоставляет генерацию видео через асинхронный task-based API. Meridian маппит унифицированную video-схему в Runway task API и поллит до завершения.
Поддерживаемые операции
| Операция | Поддержка | Endpoint |
|---|---|---|
| Video Generation | ✅ | /v1/text_to_video, /v1/image_to_video, /v1/video_to_video |
| Video Retrieve | ✅ | /v1/tasks/{task_id} |
| Video Download | ✅ | через Retrieve + загрузку по URL |
| Video Delete | ✅ | /v1/tasks/{task_id} (cancel) |
| Video List | ❌ | — |
| Video Remix | ❌ | — |
1. Video Generation
Generate (POST /v1/videos)
Параметры запроса
| Параметр | Тип | Обязательный | Примечания |
|---|---|---|---|
model | string | ✅ | Модель Runway |
prompt | string | ✅ | Текстовое описание видео |
input_reference | string | ❌ | Входное изображение для image-to-video |
seconds | string | ❌ | Длительность в секундах (по умолчанию: "2") |
size | string | ❌ | Разрешение в формате WxH (например, 1280x720; по умолчанию: 1280x720) — конвертируется в соотношение W:H |
seed | int | ❌ | Только Gen-модели |
audio | bool | ❌ | Включить генерацию аудио. Только Veo-модели |
video_uri | string | ❌ | URL исходного видео для video-to-video. Только gen4_aleph |
Extra-параметры
| Ключ | Тип | Примечания |
|---|---|---|
references | array | Объекты видео-референсов [{"uri": "...", "tag": "..."}] для video-to-video |
content_moderation | object | Конфигурация content moderation |
reference_images | array | Объекты reference-изображений для управления стилем/ассетами |
Режимы генерации (определяются автоматически по входным данным)
- Text-to-video: только
prompt; - Image-to-video:
prompt+input_reference; - Video-to-video:
prompt+video_uri— только gen4_aleph.
Ответ: BifrostVideoGenerationResponse с полями id, status, videos[].
Статусы Meridian (нормализованные): queued → in_progress → completed / failed.
Это нормализованное представление, возвращаемое API Meridian. Нативные статусы Runway: PENDING, THROTTLED, RUNNING, SUCCEEDED, FAILED, CANCELLED.
Retrieve / Download / Delete
| Операция | Endpoint | Примечания |
|---|---|---|
| Получить статус | GET /v1/videos/{id} | Полить до status: completed |
| Скачать контент | GET /v1/videos/{id}/content | Возвращает сырые байты видео (MP4) |
| Cancel/Delete | DELETE /v1/videos/{id} | Отменяет запущенную задачу |
Конфигурация
curl --location 'http://localhost:8080/api/providers' \
--header 'Content-Type: application/json' \
--data '{
"provider": "runway",
"keys": [
{
"name": "runway-key-1",
"value": "env.RUNWAY_API_KEY",
"models": ["*"],
"weight": 1.0
}
]
}'См. Настройка провайдеров для полного набора опций конфигурации.