Технические характеристики runwayml-image-to-video
| Спецификация | Подробности |
|---|---|
| Идентификатор модели | runwayml-image-to-video |
| Провайдер | Runway |
| Основная возможность | Генерирует видео из исходного изображения с использованием текстового промпта и генерации движения, обусловленной изображением. |
| Тип задачи API | Асинхронная задача генерации видео из изображения, запускаемая через конечную точку image-to-video Runway. |
| Поддерживаемые базовые модели в Runway API | Конечная точка image-to-video Runway принимает несколько видеомоделей, включая gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast и veo3. |
| Требуемые входные данные | Входное изображение плюс специфичные для модели параметры генерации; текстовый промпт обычно используется для описания желаемого движения и поведения сцены. |
| Аутентификация | Ключ API типа Bearer в заголовке Authorization. |
| Заголовок версионирования | В документации Runway требуется заголовок X-Runway-Version; для конечной точки image-to-video задокументировано значение 2024-11-06. |
| Формат вывода | Сгенерированный видеоресурс возвращается через задачную обработку API. |
| Типичная частота кадров | В документации Runway указано 24 fps для выводов image-to-video Gen-3 Alpha. |
| Типичное разрешение вывода | В документации Runway указано 1280×768 для Gen-3 Alpha и 1280×768 и 768×1280 для Gen-3 Alpha Turbo в зависимости от ориентации. |
| Рекомендации по входным изображениям | Runway рекомендует избегать референс-изображений меньше 640×640 px или больше 4K для входных изображений. |
| Схема использования в CometAPI | Доступ через CometAPI с использованием платформенного идентификатора модели runwayml-image-to-video. |
Что такое runwayml-image-to-video?
runwayml-image-to-video — это идентификатор модели CometAPI для доступа к возможности генерации image-to-video от Runway. На практике этот класс моделей берет неподвижное изображение в качестве визуальной отправной точки и преобразует его в сгенерированное видео, как правило, с помощью текстового промпта, описывающего движение, поведение камеры, атмосферу или развитие сцены.
Runway позиционирует image-to-video как часть своего более широкого стека генерации видео. В документации для Gen-3 Alpha image-to-video описывается как способ анимировать предоставленное изображение, при этом промптинг сосредоточен прежде всего на описании движения, а не на повторном описании уже видимого в кадре.
С точки зрения API Runway предоставляет генерацию image-to-video через конечную точку создания задач; это означает, что запросы обычно сначала запускают задачу, после чего для получения итогового видео требуются шаги опроса либо извлечения результата после завершения обработки.
Основные возможности runwayml-image-to-video
- Генерация видео, обусловленная изображением: стартует с неподвижного изображения и создает видео с движением, а не формирует видео исключительно по тексту.
- Управление движением с помощью промптов: лучше всего работает, когда в промпте описаны движение, перемещения камеры и изменения сцены для согласованной анимации исходного кадра.
- Асинхронный рабочий процесс задач: использует запрос на запуск генерации с последующим получением результата, что подходит для продакшен-систем, которые ставят в очередь и отслеживают долгие медиа-задачи.
- Несколько вариантов базовых моделей: конечная точка API image-to-video Runway поддерживает несколько бэкенд-видеомоделей, предоставляя разработчикам гибкость по качеству, скорости и стоимости.
- Промышленный стиль аутентификации API: использует стандартную аутентификацию токеном Bearer и явные заголовки версии API для контролируемых интеграций.
- Поддержка горизонтальной и вертикальной ориентаций: в документации Runway указаны размеры вывода для обоих режимов генерации в поддерживаемых семействах моделей.
- Совместимость с рабочим процессом референс-изображений: API ориентирован на работу с изображениями-референсами, а Runway предоставляет рекомендации по размерам входных данных для поддержания качества генерации.
- Вписывается в расширяемый креативный конвейер: более широкая платформа Runway включает связанные рабочие процессы генерации видео, такие как ключевые кадры, расширение и другие режимы, что делает image-to-video полезным этапом в более крупном творческом пайплайне.
Как получить доступ и интегрировать runwayml-image-to-video
Шаг 1: Зарегистрируйтесь и получите ключ API
Для начала зарегистрируйтесь в CometAPI и сгенерируйте ключ API в панели управления. После получения ключа храните его в безопасности и указывайте в заголовке Authorization во всех запросах.
Шаг 2: Отправляйте запросы к API runwayml-image-to-video
Используйте официальный формат API Runway через CometAPI. Конечная точка: POST /runwayml/v1/image_to_video. Добавьте заголовок X-Runway-Version.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Шаг 3: Получите и проверьте результаты
API возвращает объект задачи с идентификатором. Опросите GET /runwayml/v1/tasks/{task_id} для проверки статуса генерации, затем извлеките URL результата из ответа завершенной задачи.