Configuración de la API de video de Runway
Runway es una plataforma de generación de video. Por lo general, no se utiliza como una Base URL para rellenar en Chatbox. En su lugar, cree una API Key en la plataforma Runway y luego use el SDK oficial o solicitudes HTTP para crear tareas de video.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
¿Para qué escenarios es adecuado?
Texto a videoImagen a videoTareas asíncronasSDK oficial
Comprenda primero el flujo de trabajo de las tareas de video
- Cree una API Key y asegúrese de que su cuenta tenga permisos para la API de video y saldo disponible.
- Seleccione el tipo de tarea: texto a video, imagen a video u otras tareas de video actualmente compatibles según la documentación oficial.
- No obtendrá el archivo de video inmediatamente después de enviar una tarea; por lo general, primero recibirá un objeto de tarea o un ID de tarea.
- Espere a que la tarea se complete y luego consulte la dirección de salida o descargue los resultados.
- En caso de fallo, revise primero el estado de la tarea y los detalles del error; no se limite a verificar la Key.
Preparar parámetros
| Elemento de configuración | Método de cumplimentación |
|---|---|
| API Key | Creación en el panel de Runway; el SDK oficial lee <code>RUNWAYML_API_SECRET</code> por defecto |
| Task | texto a video / imagen a video |
| Prompt | Descripción del contenido del video |
| Ratio / Size | Horizontal, vertical o tamaño especificado |
| Duration | Duración del video |
| Status | Hacer sondeo (polling) de la tarea hasta su finalización |
| Parámetro | Descripción | Consejos para principiantes |
|---|---|---|
| API Key | Credenciales de solicitud para la API de Runway | Guárdelas únicamente en las variables de entorno de su equipo local o servidor, utilizando el nombre de variable RUNWAYML_API_SECRET |
| Prompt | Descripción del contenido del video | Escriba primero descripciones breves y luego refínelas tras confirmar el estilo |
| Image | La imagen inicial para imagen a video | Suba imágenes nítidas con un sujeto claro |
| Duration | Segundos de video | Pruebe primero el costo y el efecto con una duración más corta |
| Status | Estado de la tarea | La generación de video es asíncrona y requiere esperar a que finalice. |
Ejemplo de SDK
Nombre de la variable de entorno de Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYEjemplo de tarea en Node.js de Runway
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }Los campos de la plataforma de video se actualizan con las versiones del modelo. El ejemplo de esta página sirve para comprender la estructura de configuración; los campos reales deben consultarse en la versión actual de la documentación oficial.
| Problema | Comprobación prioritaria | Solución |
|---|---|---|
| El video no se devuelve inmediatamente tras el envío | ¿Está la tarea todavía en cola o generándose? | La generación de video es una tarea asíncrona; espere hasta que el estado sea completado antes de recuperar el resultado. |
| La tarea falló | Nombre del modelo, escala, duración o si la imagen de entrada cumple con los requisitos del modelo actual | Ajuste los parámetros de acuerdo con los detalles del error devueltos y no modifique demasiados elementos a la vez. |
| El cobro es mayor de lo esperado | Duración, resolución, versión del modelo | Pruebe primero con duraciones cortas y parámetros de bajo costo antes de generar por lotes |