Especificaciones técnicas de runwayml-image-to-video
| Especificación | Detalles |
|---|---|
| ID del modelo | runwayml-image-to-video |
| Proveedor | Runway |
| Capacidad principal | Genera video a partir de una imagen inicial utilizando un prompt de texto y generación de movimiento condicionada por imagen. |
| Tipo de tarea de API | Tarea asíncrona de generación de imagen a video iniciada a través del endpoint de imagen a video de Runway. |
| Modelos subyacentes compatibles en la API de Runway | El endpoint de imagen a video de Runway acepta múltiples modelos de video, incluidos gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast y veo3. |
| Entradas requeridas | Una imagen de entrada más parámetros de generación específicos del modelo; el texto de prompt se usa habitualmente para describir el movimiento y el comportamiento de la escena. |
| Autenticación | Clave de API Bearer en el encabezado Authorization. |
| Encabezado de versión | La referencia de la API de Runway requiere el encabezado X-Runway-Version, con el valor documentado 2024-11-06 para el endpoint de imagen a video. |
| Formato de salida | Recurso de video generado devuelto mediante procesamiento basado en tareas. |
| Velocidad de fotogramas típica | La documentación de Runway indica 24 fps para salidas de imagen a video de Gen-3 Alpha. |
| Resolución de salida habitual | Runway documenta 1280×768 para Gen-3 Alpha y 1280×768 y 768×1280 para Gen-3 Alpha Turbo, según la orientación. |
| Recomendaciones para la imagen de entrada | Runway recomienda evitar imágenes de referencia más pequeñas de 640×640 px o mayores que 4K para las entradas de imagen. |
| Patrón de uso en CometAPI | Se accede a través de CometAPI usando el identificador de modelo de la plataforma runwayml-image-to-video. |
¿Qué es runwayml-image-to-video?
runwayml-image-to-video es el identificador de modelo de CometAPI para acceder a la capacidad de generación de imagen a video de Runway. En la práctica, este tipo de modelo toma una imagen fija como punto de partida visual y la transforma en un video generado, normalmente guiado por un prompt de texto que describe el movimiento, el comportamiento de la cámara, la atmósfera o la evolución de la escena.
Runway sitúa la función de imagen a video como parte de su pila más amplia de generación de video. Su documentación para Gen-3 Alpha describe la imagen a video como una forma de animar una imagen proporcionada, con el prompting centrado especialmente en el movimiento en lugar de volver a describir todo lo que ya es visible en el encuadre.
Desde la perspectiva de la API, Runway expone la generación de imagen a video como un endpoint de creación de tareas, lo que significa que las solicitudes normalmente inician primero un trabajo y luego requieren sondeo o pasos de recuperación para obtener el resultado de video final una vez que finaliza el procesamiento.
Características principales de runwayml-image-to-video
- Generación de video condicionada por imagen: Parte de una imagen fija y genera un video impulsado por el movimiento en lugar de crear video solo a partir de texto.
- Control del movimiento guiado por prompt: Funciona mejor cuando los prompts describen el movimiento, el desplazamiento de cámara y los cambios de escena para animar coherentemente el fotograma proporcionado.
- Flujo de trabajo de tareas asíncronas: Utiliza una solicitud de inicio de generación seguida de la recuperación de resultados, lo que encaja en sistemas de producción que ponen en cola y monitorizan trabajos de medios de larga duración.
- Varias opciones de modelos subyacentes: El endpoint de imagen a video de Runway admite varios modelos de video backend, ofreciendo a los desarrolladores flexibilidad en calidad, velocidad y coste.
- Autenticación de API de estilo producción: Usa autenticación estándar con token Bearer y encabezados de versión explícitos para integraciones controladas.
- Compatibilidad con salidas verticales y horizontales: Runway documenta tamaños de salida tanto para generación horizontal como vertical en las familias de modelos compatibles.
- Compatibilidad con flujo de imágenes de referencia: La API está diseñada en torno a imágenes de referencia, y Runway proporciona recomendaciones de tamaño de entrada para ayudar a mantener la calidad de generación.
- Encaje en una canalización creativa extensible: La plataforma más amplia de Runway incluye flujos relacionados de generación de video como keyframes, expansión y otros modos, haciendo que la imagen a video sea útil como una etapa dentro de una canalización creativa mayor.
Cómo acceder e integrar runwayml-image-to-video
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. Después de obtener la clave, almacénela de forma segura y úsela en el encabezado Authorization para todas las solicitudes.
Paso 2: Envíe solicitudes a la API runwayml-image-to-video
Use el formato oficial de la API de Runway a través de CometAPI. El endpoint es POST /runwayml/v1/image_to_video. Incluya el encabezado 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."
}'
Paso 3: Recupere y verifique los resultados
La API devuelve un objeto de tarea con un ID de tarea. Realice sondeos a GET /runwayml/v1/tasks/{task_id} para comprobar el estado de la generación y, a continuación, recupere la URL de salida de la respuesta de la tarea completada.