runway_video

Especificaciones técnicas de runway-video

¿Qué es runway-video?

runway-video es el identificador de plataforma de CometAPI para acceder a las capacidades de generación de video de Runway a través de una API unificada. Según la documentación oficial de la API de Runway, Runway ofrece varios modelos de video para generar clips a partir de indicaciones de texto o de imágenes, con endpoints basados en tareas para iniciar las generaciones y, posteriormente, recuperar los resultados.

En la práctica, runway-video se entiende mejor como una puerta de enlace a flujos de trabajo de creación de video impulsados por Runway, más que como el nombre de un único modelo base independiente. El catálogo actual de la API de Runway incluye varios modelos de video con diferentes modos de entrada y niveles de precios, como gen4.5 para texto o imagen a video, gen4_turbo para imagen a video, y opciones adicionales como gen4_aleph, veo3, veo3.1, veo3.1_fast y gen3a_turbo.

Esto hace que runway-video sea adecuado para aplicaciones como el prototipado creativo, la generación de contenido de marketing, la producción de clips para redes sociales, la visualización de conceptos y experiencias de producto que requieren síntesis automatizada de videos de formato corto. Dado que la API subyacente de Runway utiliza trabajos asíncronos, las integraciones suelen enviar primero una solicitud de generación y luego sondear o recuperar la salida de la tarea una vez que el procesamiento finaliza.

Funcionalidades principales de runway-video

• Generación de texto a video: Runway admite la creación de videos a partir de indicaciones en lenguaje natural en los modelos compatibles, lo que permite a los desarrolladores generar clips directamente desde texto descriptivo.
• Flujos de trabajo de imagen a video: Varios modelos de video de Runway aceptan entradas de imagen, lo que hace que runway-video sea útil para animar imágenes fijas o construir canalizaciones de generación de video guiadas por referencias.
• Múltiples opciones de modelos subyacentes: La API de Runway expone varios modelos de video con diferentes capacidades y perfiles de costo, brindando a los desarrolladores flexibilidad para optimizar por calidad, velocidad o presupuesto.
• Procesamiento de tareas asíncronas: Las solicitudes de generación crean tareas en lugar de devolver el medio final de inmediato, lo cual es adecuado para sistemas de producción que requieren encolado, reintentos y verificación de estado.
• Cargas temporales de recursos: Runway proporciona endpoints de carga que devuelven referencias runwayUri, lo que facilita el paso de recursos de imagen, video o audio a solicitudes de generación posteriores.
• Compatibilidad con SDK oficiales: Runway ofrece SDK de Node.js y Python, que pueden simplificar la autenticación, la construcción de solicitudes y la obtención de resultados.
• Integración de API versionada: Las solicitudes requieren un encabezado explícito X-Runway-Version, lo que ayuda a los desarrolladores a trabajar con un contrato de API conocido.
• Precios basados en créditos: Runway cobra la generación de video por créditos por segundo, con precios que varían según el modelo subyacente seleccionado.

Cómo acceder e integrar runway-video

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

Para acceder a runway-video, primero cree una cuenta y genere una clave de API a través de su panel de CometAPI. Después de iniciar sesión, copie su clave de API y guárdela de forma segura en una variable de entorno o en un gestor de secretos para uso en producción.

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

Utilice su clave de API para autenticar las solicitudes al endpoint de CometAPI para runway-video. Incluya su indicación y cualquier parámetro de entrada admitido en el cuerpo de la solicitud, y especifique el modelo como 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."
  }'

Paso 3: Recupere y verifique los resultados

Tras el envío, inspeccione la respuesta de la API para encontrar la salida generada, el identificador de la tarea o la carga de resultados devuelta para runway-video. Si la generación se ejecuta de forma asíncrona, sondee el endpoint correspondiente de CometAPI hasta que el procesamiento finalice; luego valide la URL de video devuelta, los metadatos y el contenido antes de usarlo en su aplicación.