Технические характеристики runway-video
| Спецификация | Сведения |
|---|---|
| Идентификатор модели | runway-video |
| Поставщик | Runway |
| Тип модели | Генерация видео с ИИ |
| Основные модальности | Text-to-video и image-to-video, в зависимости от выбранной базовой модели Runway |
| Входные данные | Текстовые запросы, референсные изображения и в некоторых случаях загруженные медиа-активы |
| Выходные данные | Сгенерированные видеоклипы |
| Шаблон API | Асинхронный рабочий процесс генерации, основанный на задачах |
| Аутентификация | Аутентификация с использованием Bearer API ключа |
| Обязательный заголовок версии | X-Runway-Version: 2024-11-06 |
| Базовый хост API | api.dev.runwayml.com |
| Официальные SDK | Доступны SDK для Node.js и Python |
| Работа с файлами | Поддерживаются временные загрузки, которые возвращают значения runwayUri для запросов генерации |
| Модель ценообразования | Тарификация на основе кредитов; доступные видеомодели Runway тарифицируются за секунду сгенерированного вывода |
| Примеры базовых видеомоделей | gen4.5, gen4_turbo, gen4_aleph, veo3, veo3.1, veo3.1_fast, gen3a_turbo |
Что такое runway-video?
runway-video — это платформенный идентификатор CometAPI для доступа к возможностям генерации видео Runway через унифицированный API. Согласно официальной документации API Runway, Runway предлагает несколько видеомоделей для генерации клипов из текстовых описаний или изображений, с эндпоинтами, ориентированными на задачи, для запуска генераций и последующего получения результатов.
На практике runway-video лучше рассматривать как шлюз к рабочим процессам создания видео на базе Runway, а не как название одной автономной базовой модели. Текущий каталог API Runway включает несколько видеомоделей с разными режимами ввода и ценовыми уровнями, например gen4.5 для генерации видео по тексту или изображению, gen4_turbo для сценариев «изображение-видео», а также дополнительные варианты: gen4_aleph, veo3, veo3.1, veo3.1_fast и gen3a_turbo.
Это делает runway-video подходящим для таких применений, как творческое прототипирование, создание маркетингового контента, производство клипов для социальных сетей, визуализация концептов и продуктовые сценарии, которым требуется автоматический синтез коротких видео. Поскольку базовый API Runway использует асинхронные задания, интеграции обычно сначала отправляют запрос на генерацию, а затем опрашивают соответствующий эндпоинт CometAPI или получают результат задачи после завершения обработки.
Основные возможности runway-video
- Генерация видео по тексту: Runway поддерживает создание видео из естественно-языковых описаний на поддерживаемых моделях, позволяя разработчикам генерировать клипы непосредственно из текста.
- Процессы от изображения к видео: Несколько видеомоделей Runway принимают изображения, что делает
runway-videoполезным для анимации статичных изображений или построения конвейеров генерации видео по референсам. - Несколько вариантов базовых моделей: API Runway предоставляет ряд видеомоделей с различными возможностями и стоимостью, позволяя оптимизировать качество, скорость или бюджет.
- Асинхронная обработка задач: Запросы на генерацию создают задачи, а не возвращают медиа сразу, что хорошо подходит для промышленных систем с очередями, повторными попытками и проверкой статуса.
- Временные загрузки ресурсов: Runway предоставляет эндпоинты загрузки, возвращающие ссылки
runwayUri, упрощающие передачу изображений, видео или аудио в дальнейшие запросы генерации. - Поддержка официальных SDK: Runway предлагает SDK для Node.js и Python, упрощающие аутентификацию, формирование запросов и получение результатов.
- Версионированная интеграция API: Запросы требуют явного заголовка
X-Runway-Version, что помогает работать с утвержденным контрактом API. - Тарификация на основе кредитов: Runway тарифицирует генерацию видео по количеству кредитов за секунду сгенерированного вывода, стоимость зависит от выбранной модели.
Как получить доступ и интегрировать runway-video
Шаг 1: Зарегистрируйтесь и получите ключ API
Чтобы получить доступ к runway-video, сначала создайте аккаунт и сгенерируйте ключ API в панели CometAPI. После входа скопируйте ключ и безопасно храните его в переменной окружения или менеджере секретов для продакшена.
Шаг 2: Отправьте запросы к API runway-video
Используйте ключ API для аутентификации запросов к конечной точке CometAPI для runway-video. Передайте текстовый запрос и поддерживаемые параметры во входных данных и укажите модель как runway-video.
curl -X POST "https://api.cometapi.com/v1/responses" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "runway-video",
"input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
}'
Шаг 3: Получите и проверьте результаты
После отправки проверьте ответ API на наличие сгенерированного результата, идентификатора задачи или полезной нагрузки, возвращенной для runway-video. Если генерация выполняется асинхронно, опрашивайте соответствующую конечную точку CometAPI до завершения обработки, затем проверьте возвращаемый URL видео, метаданные и содержимое перед использованием в приложении.