runway_video2video

Технические характеристики runway-video2video

Что такое runway-video2video?

runway-video2video — это идентификатор модели CometAPI для возможности Runway по генерации видео на основе видео, то есть рабочего процесса, который берет существующий видеоклип и перерисовывает его в новом визуальном стиле или с иной, движением управляемой интерпретацией по текстовому промпту. На практике это используется для стилизации, трансформации сцен, разработки визуального образа, экспериментальных VFX и превращения сырого материала в более кинематографичные или фантазийные результаты.

Справочная документация Runway описывает Video to Video как способ менять стиль видео с помощью текстового промпта или входного изображения в качестве первого кадра. В более поздних продуктовых рекомендациях также отмечается, что хотя Gen-3 Alpha и Turbo поддерживали этот рабочий процесс, новые рекомендации Runway направляют пользователей к инструментам нового поколения для новейших сценариев video-to-video. С точки зрения интеграции CometAPI, однако, runway-video2video — это идентификатор модели платформы, который используется для доступа к этому классу возможностей.

Основные возможности runway-video2video

• Генерация на основе видео: Начинает работу с существующего входного видео, а не синтезирует движение с нуля, что полезно для сохранения структуры кадра, тайминга и композиции при изменении визуального результата.
• Преобразование по промпту: Использует инструкции на естественном языке для управления стилем, настроением, переосмыслением объекта или направлением визуальных эффектов.
• Перенос стиля и творческое перерисовывание: Хорошо подходит для превращения исходного материала в анимированные, кинематографичные, сюрреалистичные или брендированные визуальные решения без покадрового монтажа. Это вывод на основе описанного в Runway рабочего процесса стилизации video-to-video.
• Рабочие процессы с референсами: Документация Runway указывает на поддержку управления с опорой на изображение в смежных потоках генерации видео, что помогает направлять композицию и обеспечивать эстетическую согласованность.
• Портретные и альбомные варианты вывода: Поддерживаемые рабочие процессы включают стандартные горизонтальные и вертикальные форматы вывода, что полезно для соцсетей, мобильных и маркетинговых размещений.
• Эффективность для коротких форм: Упомянутый рабочий процесс поддерживает короткие клипы до 20 секунд, что подходит для рекламных креативов, концепт-кадров, постов в соцсетях и быстрых итераций.
• Доступ через API: Runway предоставляет документацию по API и паттерны доступа к моделям, что позволяет программно интегрировать в креативные приложения, внутренние инструменты и автоматизированные медиапайплайны.

Как получить доступ и интегрировать runway-video2video

Шаг 1: Зарегистрируйтесь и получите ключ API

Для начала зарегистрируйтесь в CometAPI и сгенерируйте ключ API в панели управления. Сохраните ключ в надежном месте и используйте его для аутентификации запросов к конечной точке CometAPI.

Шаг 2: Отправляйте запросы к API runway-video2video

Используйте официальный формат API Runway через CometAPI. Конечная точка — POST /runwayml/v1/video_to_video. Вы должны включить заголовок X-Runway-Version.

curl https://api.cometapi.com/runwayml/v1/video_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "videoUri": "https://example.com/your-source-video.mp4",
    "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence with dramatic atmosphere and smooth motion.",
    "seed": 1,
    "ratio": "1280:720",
    "references": [],
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

import os, requests

resp = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_to_video",
    headers={
        "Authorization": f"Bearer {os.environ['COMETAPI_API_KEY']}",
        "Content-Type": "application/json",
        "X-Runway-Version": "2024-11-06",
    },
    json={
        "model": "gen4_aleph",
        "videoUri": "https://example.com/your-source-video.mp4",
        "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence.",
        "seed": 1,
        "ratio": "1280:720",
        "references": [],
        "contentModeration": {"publicFigureThreshold": "auto"},
    },
)
print(resp.json())

Шаг 3: Получите и проверьте результаты

API возвращает объект задачи. Опрашивайте конечную точку статуса задачи, чтобы узнать, когда генерация видео завершена, затем получите URL выходного ролика. Для продакшн-использования добавьте повторы, опрос статуса и логирование, чтобы обеспечить надежную интеграцию с runway-video2video.