runway_video2video

Especificaciones técnicas de runway-video2video

¿Qué es runway-video2video?

runway-video2video es el identificador de modelo de CometAPI para la capacidad de generación de video a video de Runway, un flujo de trabajo que toma un clip de video existente y lo vuelve a renderizar en un nuevo estilo visual o una interpretación guiada por el movimiento usando instrucciones basadas en prompts. En la práctica, se utiliza para estilización, transformación de escenas, desarrollo de apariencia, VFX experimentales y convertir metraje sin procesar en resultados más cinematográficos o imaginativos.

La ayuda de Runway describe Video to Video como una forma de cambiar el estilo de los videos usando un prompt de texto o una imagen de entrada como primer fotograma. Su orientación de producto más reciente también indica que, mientras Gen-3 Alpha y Turbo admitían este flujo de trabajo, las recomendaciones más nuevas de Runway dirigen a los usuarios hacia herramientas de nueva generación para los casos de uso más recientes de video a video. Sin embargo, desde la perspectiva de integración con CometAPI, runway-video2video es el ID de modelo de la plataforma que se utiliza para acceder a esta clase de capacidad.

Características principales de runway-video2video

• Generación guiada por video: Parte de un video de entrada existente en lugar de generar el movimiento desde cero, lo que resulta útil para preservar la estructura del plano, la temporización y la composición mientras se modifica el resultado visual.
• Transformación basada en prompts: Usa instrucciones en lenguaje natural para controlar el estilo, el ambiente, la reinterpretación del sujeto o la dirección del efecto visual de la salida.
• Transferencia de estilo y re-renderizado creativo: Muy adecuado para convertir metraje en tratamientos visuales animados, cinematográficos, surreales o de marca sin edición manual fotograma a fotograma. Esta es una inferencia basada en el flujo de trabajo de estilizado de video a video descrito por Runway.
• Flujos de trabajo con referencias: La documentación de Runway indica compatibilidad con orientación informada por imágenes en flujos relacionados de generación de video, lo que ayuda a dirigir la composición o la consistencia estética.
• Opciones de salida vertical y horizontal: Los flujos de trabajo compatibles incluyen formatos estándar horizontal y vertical, lo cual es útil para entregas sociales, móviles y de marketing.
• Eficiencia para producción de formatos cortos: El flujo de trabajo de referencia admite clips de hasta 20 segundos, lo que encaja con creatividades publicitarias, planos de concepto, publicaciones sociales y ciclos de iteración rápida.
• Accesibilidad vía API: Runway proporciona documentación de API y patrones de acceso al modelo, lo que permite la integración programática en aplicaciones creativas, herramientas internas y canalizaciones automatizadas de medios.

Cómo acceder e integrar runway-video2video

Paso 1: Regístrese para obtener una clave de API

Para comenzar, regístrese en CometAPI y genere su clave de API desde el panel. Una vez que tenga su clave, guárdela de forma segura y úsela para autenticar solicitudes al endpoint de CometAPI.

Paso 2: Envíe solicitudes a la API de runway-video2video

Use el formato de API oficial de Runway a través de CometAPI. El endpoint es POST /runwayml/v1/video_to_video. Debe incluir el encabezado 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())

Paso 3: Recuperar y verificar los resultados

La API devuelve un objeto de tarea. Sondee el endpoint de estado de la tarea para comprobar cuándo se completa la generación del video y, luego, recupere la URL del video de salida. Para uso en producción, agregue reintentos, sondeo de estado y registro para garantizar una integración confiable con runway-video2video.