Automatización

Crea videos y conecta los resultados terminados a tu flujo de trabajo mediante suscripciones de finalización de Reela CLI.

Reela ofrece comandos para producir videos y suscripciones de finalización para videos terminados. Un agente u otra herramienta puede enviar una descripción y recibir el resultado mediante el daemon de CLI sin tener que mantener abierto el sitio web de Reela.

De la descripción al videoCopiar enlace al encabezado

create convierte una descripción de texto y archivos multimedia opcionales en una tarea de video. Puedes proporcionar una instrucción directamente o leerla desde un archivo, elegir la duración y el diseño, incluir avatares y adjuntar imágenes de referencia, secuencias de video o música de fondo.

reela create --prompt-file brief.txt \
  --visual ai-video --layout portrait --duration 30 \
  --session "Product campaign" --output json

La generación de video es una tarea de larga duración. Inicia el daemon y configura una suscripción de finalización antes de enviar la solicitud; Reela ejecuta la generación en segundo plano y entrega el resultado terminado a tu script. Si reutilizas el título de una sesión, los videos relacionados se agrupan en un proyecto. Consulta Entrega automática a continuación para ver cómo configurarla.

Antes de enviar la solicitud, agrega --dry-run para validar la solicitud y obtener una vista previa de los créditos estimados, sin subir archivos ni crear una tarea. Enviar una tarea puede consumir créditos.

Consulta opciones de creación de videos para conocer los elementos visuales y archivos multimedia compatibles.

Elige la calidad y el costo con los nivelesCopiar enlace al encabezado

Los niveles te permiten elegir la opción de generación para cada solicitud. Reela proporciona descripciones que te ayudan a ti o a un agente a seleccionar una opción según el resultado deseado y, antes del envío, calcula una estimación de los créditos para esa solicitud.

reela tiers list
reela tiers list --output json

La lista muestra la etiqueta y la descripción de cada nivel, e indica cuál es el predeterminado. En la salida JSON, tiers contiene entradas con label, content y is_default; default_tier indica el nivel predeterminado. Lee content para entender cada opción, en lugar de elegirla por su posición en la lista. Que un nivel aparezca en la lista no garantiza que tu cuenta pueda usarlo; Reela comprueba el acceso al validar o enviar una solicitud.

Pasa la etiqueta exacta a --tier. Reemplaza <tier-label> a continuación por una etiqueta de tu lista; conserva las comillas si contiene espacios:

reela create --prompt-file brief.txt --visual ai-video \
  --tier "<tier-label>" --duration 30 --layout portrait \
  --dry-run --output json

La vista previa devuelve credits_cost y quota_after. Para enviar la solicitud, quita --dry-run y conserva el nivel seleccionado y las demás opciones. Un nivel describe una opción de generación; usa la vista previa para estimar el costo de tu solicitud concreta.

Si omites --tier, Reela usa el nivel predeterminado disponible actualmente para la CLI. Si no hay un nivel predeterminado disponible, ejecuta reela tiers list para actualizar las opciones o especifica un nivel. Al seleccionar un nivel explícitamente, tu flujo de trabajo no depende de los cambios en el nivel predeterminado; la disponibilidad y los precios aun así pueden cambiar. Usa el mismo perfil para listar las opciones, obtener una vista previa y enviar la solicitud.

Consulta la referencia del comando de niveles para obtener detalles sobre la salida y el comportamiento de selección.

Resultados estructurados para agentes y herramientasCopiar enlace al encabezado

--output json ofrece los resultados de los comandos como datos estructurados, incluidas las opciones de nivel, las estimaciones de créditos y las confirmaciones de envío. El código de salida 0 indica que el comando se ejecutó correctamente; los errores usan códigos de salida distintos de cero y texto sin formato en stderr, incluso en el modo JSON.

Tras enviar una solicitud correctamente, el daemon se encarga de esperar a que finalice y ejecuta el script al que te suscribiste con el resultado. La respuesta al envío y el evento de finalización incluyen un task_id para que tu flujo de trabajo pueda asociar el video terminado con la descripción original.

Entrega automáticaCopiar enlace al encabezado

Reela CLI puede ejecutar tu propio programa cuando termina una tarea de video. Esta suscripción de finalización conecta el resultado de Reela con tu siguiente acción: entregar un video a una herramienta de publicación, actualizar un registro o enviar una notificación a otro sistema. Reela detecta cuándo termina la tarea y proporciona los detalles a tu script.

Registra tu scriptCopiar enlace al encabezado

Proporciona una ruta absoluta a un ejecutable en la máquina donde se ejecuta Reela CLI. Puede estar escrito en cualquier lenguaje, siempre que lea el evento desde stdin e indique que se ejecutó correctamente mediante su código de salida.

reela subscribe add script --path /absolute/path/on-video \
  --timeout-seconds 300 --max-retries 3

Cada perfil tiene una suscripción de script. Para cambiar el ejecutable de una suscripción existente, usa reela config set delivery.script.path /absolute/path/on-video. Después de cambiar la suscripción o sus ajustes, reinicia el daemon si ya está en ejecución, tal como se describe a continuación.

Recibe el evento de finalizaciónCopiar enlace al encabezado

Reela inicia el ejecutable y escribe un objeto JSON en stdin:

{
  "event": "task.completed",
  "task_id": "12345",
  "status": "completed",
  "status_label": "completed",
  "title": "Product demo",
  "description": "A short product introduction",
  "download": {
    "filename": "product-demo.mp4",
    "download_url": "https://example.com/video.mp4"
  }
}

Usa task_id para vincular el evento con el envío original. title, description y download pueden ser null. Cuando está presente, download proporciona el nombre de archivo sugerido y la URL de descarga del video terminado para que tu script los use directamente. Antes de ejecutar una acción que requiera el video, gestiona el caso en que falte el valor download.

Los enlaces firmados download_url caducan 6 horas después de su generación. Descarga el video o cópialo a tu propio almacenamiento poco después de recibir el evento de finalización. Mantén privadas las URL de descarga y trátalas como enlaces de acceso temporales, no como direcciones permanentes de los videos.

La suscripción recibe las tareas terminadas de la cuenta seleccionada, incluidos los videos creados fuera de la CLI. Si tu acción corresponde a un flujo de trabajo específico, compara el ID de tarea del evento con el de tus tareas enviadas. Actualmente, las suscripciones de finalización solo gestionan las tareas que terminan correctamente; las tareas fallidas, canceladas o parciales no activan este evento.

Ejecución e intentosCopiar enlace al encabezado

• Éxito: devuelve 0 después de que tu acción se ejecute correctamente. Reela descarta la salida estándar del script; no usa lo que este imprima como resultado.
• Tiempo de espera: --timeout-seconds 300 permite hasta 300 segundos por ejecución. Si se agota el tiempo de espera o el script termina con un código distinto de cero, la entrega falla.
• Reintentos: Reela reintenta las entregas fallidas. Si solo falla el método del script, --max-retries 3 permite tres intentos en total, incluido el primero. Los errores relacionados con otros métodos habilitados usan delivery.max_retries.
• Entregas repetidas: procura que las acciones puedan repetirse de forma segura para el mismo task_id, para que otra ejecución no publique el mismo video ni agregue dos veces el mismo registro.

Mantén la suscripción en ejecuciónCopiar enlace al encabezado

El daemon de la CLI gestiona los eventos de finalización y ejecuta los métodos de entrega habilitados. Después de elegir tus métodos, inícialo y comprueba el estado de la entrega:

reela daemon start
reela subscribe status

Al agregar un método, también se intenta iniciar el daemon si está detenido. Si ya está en ejecución, reinícialo después de cambiar los ajustes de entrega para que los cambios surtan efecto. Si iniciaste el daemon manualmente, usa reela daemon stop seguido de reela daemon start.

Reela guarda el progreso de la entrega y lo retoma desde ese punto cuando se reinicia el daemon. Si no hay progreso guardado, sigue los eventos nuevos de forma predeterminada. reela daemon start --keep-backlog también procesa eventos anteriores de tareas terminadas que todavía estén disponibles cuando no haya progreso guardado.

Usa reela daemon install para habilitar el inicio automático del daemon al iniciar sesión. Si está instalado como servicio, reinícialo desde el administrador de servicios de tu sistema operativo después de cambiar la configuración. Consulta reela daemon status o reela daemon logs --tail 50 para revisar la entrega.

Para que la entrega automática funcione, la máquina donde se ejecuta el daemon debe permanecer encendida y conectada. Inícialo antes de enviar videos cuya finalización deba activar tu script.

daemon y subscribe están disponibles en Linux y macOS. Windows x64 admite comandos de video, consultas de estado y descargas manuales.

Entrega opcional de descargas y correos electrónicosCopiar enlace al encabezado

Además de tu script, puedes habilitar las descargas automáticas o los correos electrónicos con los videos terminados. Las descargas están habilitadas en los ajustes de entrega predeterminados; define el destino con reela config set delivery.download ~/Videos/reela. Si están deshabilitadas, habilítalas con reela subscribe add download --dir ~/Videos/reela. Habilita el correo electrónico con reela subscribe add email y, si quieres usar una dirección distinta al correo electrónico de tu cuenta, agrega --address me@example.com.

Se pueden activar varios métodos a la vez y el fallo de uno no impide que se ejecuten los demás. Cada ejecución del script recibe su propia carga útil de finalización, incluida la información de descarga cuando esté disponible. Consulta la referencia del comando de entrega para ver todos los métodos.

Reutiliza tu configuración de producciónCopiar enlace al encabezado

Reela ofrece otras capacidades que pueden convertirse en pasos de tu flujo de trabajo:

• Marca coherente: enumera los paquetes de marca existentes con brand list y aplica uno a una tarea con brand apply. El comando espera a que se genere el resultado con la marca aplicada. Consulta los comandos de marca.
• Edición programática: descarga el JSON de edición, valida los cambios, guarda un borrador para previsualizarlo y envía un render con edit. Consulta los comandos de edición.
• Cuentas y preferencias separadas: selecciona un perfil con --profile o REELA_PROFILE. Los métodos y ajustes de entrega se aplican al perfil seleccionado. Consulta perfiles y configuración.

Por ejemplo, un flujo de trabajo para videos de productos puede enviar una descripción con imágenes de referencia y usar una suscripción de finalización del daemon para entregar el video terminado a tu herramienta de publicación. Reela ofrece generación en segundo plano y entrega al finalizar; tu herramienta decide cuándo enviar la solicitud y qué acción llevar a cabo cuando llegue el resultado.

Consulta la referencia del comando de entrega para ver todas las opciones de suscripción y del daemon. Para instalar y autorizar tu cuenta, empieza por Introducción.