Genera imágenes y vídeo desde tu terminal con OpenArt CLI

Qué es OpenArt CLI

OpenArt CLI es un único binario que da a tu terminal acceso a un OpenArt cuenta en macOS, Linux y Windows. Inicias sesión una vez a través de un navegador con openart login. El flujo de OAuth elimina la necesidad de instalar Python o Node, crear una clave de API o guardar una clave de larga duración en los scripts.

El comando de inicio de sesión usa el flujo OAuth estándar con PKCE, el mismo patrón de redirección al navegador que utilizan las apps de escritorio para evitar manejar directamente una contraseña. La CLI almacena la credencial resultante en ~/.openart/cli-credentials.json (modo 0600, de modo que solo tu cuenta de usuario puede leerlo; Windows lo almacena en %USERPROFILE%\.openart\cli-credentials.json) y lo actualiza automáticamente. openart logout revoca la credencial y borra ese estado local.

OpenArt construyó la CLI como su propia superficie de producto, no como un script que hace clics por ti en la aplicación web. Sus comandos exponen imagen y generación de vídeo, información de modelos, estado de creaciones, subidas, proyectos y espacios de trabajo directamente a scripts de shell y agentes de programación. La salida legible por máquina, las vistas previas de solicitudes, los trabajos asíncronos y el sondeo acotado facilitan la automatización repetible.

La CLI gasta los créditos de tu propia cuenta de OpenArt, el mismo saldo del que tira la aplicación web. No es un producto de API aparte con su propia clave y facturación. El Repositorio de OpenArt CLI en GitHub tiene las instrucciones de instalación canónicas, la referencia de comandos y los detalles de la versión actual.

Cómo instalar OpenArt CLI

OpenArt CLI es compatible con macOS, Linux y Windows como un único binario precompilado. En macOS o Linux, ejecuta el instalador oficial.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

En Windows, abre PowerShell y ejecuta el instalador de una línea.

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

El instalador elige la compilación adecuada para tu equipo, la verifica con las sumas de comprobación de la versión y coloca openart en un directorio de ejecutables estándar. En macOS y Linux, usa /usr/local/bin cuando esa ubicación permite escritura o ~/.local/bin para una instalación a nivel de usuario, en lugar de pedir sudo de forma inesperada. Si el instalador usa ~/.local/bin, asegúrate de que ese directorio esté en el PATH. En Windows, se instala en %LOCALAPPDATA%\Programs\openart\bin y añade esa carpeta a tu PATH automáticamente, así que no se necesitan permisos de administrador.

Ambos scripts de instalación aceptan una ubicación de instalación personalizada o una versión fijada. En macOS o Linux, añade las flags después del script.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh -s -- --prefix "$HOME/.local" --version 0.1.0

Un script de PowerShell canalizado no puede recibir parámetros directamente, así que define primero la versión como variable de entorno.

$env:OPENART_VERSION = '0.1.0'
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

¿Prefieres no canalizar un script a tu shell? Descarga el archivo para tu plataforma desde el última versión (macOS con Apple silicon o Intel, Linux x86-64 o arm64, Windows x86-64 o arm64), extráelo y coloca openart en tu PATH. Cada versión incluye un checksums.txt puedes verificar con shasum -a 256 -c checksums.txt --ignore-missing.

Para actualizar más adelante, vuelve a ejecutar el mismo instalador. Sobrescribe el binario existente en el sitio.

Confirma la instalación en una nueva ventana de terminal.

openart --help

Luego conecta la CLI a tu cuenta de OpenArt.

openart login

El comando de inicio de sesión abre un navegador para la autenticación OAuth. Después de aprobar el acceso, la CLI puede usar tu cuenta sin una clave de API ni un entorno de ejecución de lenguaje como Python o Node.

Los comandos principales de un vistazo

La superficie de comandos principal

Autenticación y acceso a la cuenta

OpenArt usa OAuth de navegador para el acceso a la cuenta. Inicia una sesión con openart login, termínalo con openart logout, y consulta tu plan o tu saldo de créditos con openart account.

openart login
openart account
openart logout

Generación de imágenes y vídeo

OpenArt mantiene el tipo de medio explícito en cada comando de generación. Separa image y video significan que un script no puede dirigir una petición al tipo de modelo equivocado por accidente.

Para generación de texto a imagen o edición de imagen a imagen, usa el comando de imagen con un prompt y un ID de modelo. Añade --image al proporcionar un archivo local o una URL como referencia.

openart generate image "A ceramic mug on a studio table" \
  --model nano-banana-2 \
  -o ./out/

El ejemplo anterior usa nano-banana-2; cambia por cualquier modelo openart model list te muestra.

Para texto a vídeo o imagen a vídeo, usa el comando de vídeo. Las opciones admitidas pueden incluir duración, relación de aspecto y resolución, según el modelo.

openart generate video "Slow camera orbit around the product" \
  --model kling-3-omni \
  --image ./start-frame.png \
  --duration 8

Selección de modelo y parámetros de la solicitud

Los comandos de modelo te permiten inspeccionar las opciones actuales en lugar de dar por hecho suposiciones. openart model list muestra los modelos disponibles y sus modos compatibles. Los nombres de los modelos pueden cambiar a medida que OpenArt añade nuevas opciones.

openart model list
openart model cost
openart model cost --model nano-banana-2 --mode text2image
openart model form nano-banana-2 text2image

openart model cost por sí solo cotiza todos los modelos, del más barato primero, sin gastar créditos. Añade --model y --mode para poner precio a una combinación concreta. El form devuelve los parámetros exactos que acepta un modelo y modo concretos. Si estás eligiendo entre dos de ellos, mira cómo GPT Image 2 comparado con Nano Banana 2 antes de comprometer una tarea por lotes con uno.

Creaciones y recursos almacenados

Los comandos de creación permiten a los scripts inspeccionar el historial de generación y gestionar las tareas enviadas. Usa list para creaciones anteriores, get para un trabajo, y wait cuando un script debe pausarse hasta que termine un trabajo asíncrono.

openart creation list --type video --limit 10
openart creation get <creation-id>
openart creation wait <creation-id>

Los comandos de proyecto y espacio de trabajo controlan dónde se guarda el nuevo trabajo.

openart project list
openart project create --name "<name>"
openart workspace list
openart workspace select <workspace-id>
openart workspace select

workspace select sin argumento vuelve a tu espacio de trabajo personal, y workspace list marca el activo con un asterisco.

Para archivos de referencia reutilizables, openart upload add <file> sube el recurso una vez e imprime una URL para comandos posteriores, y openart upload list --type image muestra lo que ya has subido. El repositorio oficial de la CLI tiene la referencia actual de comandos a medida que la superficie evoluciona.

Desinstalar es un paso manual, ya que la CLI no tiene comando de desinstalación integrado. En macOS o Linux, elimina el binario y sus credenciales guardadas con rm "$(command -v openart)" y rm -rf ~/.openart. En Windows, elimina %LOCALAPPDATA%\Programs\openart, elimínalo de tu PATH, y elimina %USERPROFILE%\.openart. Si te topas con un fallo que merezca la pena reportar, incluye la salida de openart version en tu incidencia. Informa de la build exacta, la plataforma y el commit.

Flags pensados para scripts, no para clics

OpenArt CLI ofrece controles que hacen que la generación sea predecible dentro de los scripts. Cada uno aborda un problema habitual de automatización: análisis estructurado, gasto accidental, tareas de larga duración y procesos bloqueados.

El --json escribe resultados legibles por máquina en la salida estándar. Los mensajes de progreso y paginación van a la salida de error estándar, de modo que un trabajo de CI o la llamada de una herramienta de agente puede canalizar JSON limpio a otro comando sin tener que extraer texto legible para humanos. Un script puede extraer de forma fiable los ID de creación, estados y URLs de resultados.

El --dry-run imprime la solicitud exacta que enviaría OpenArt, para cualquier comando que escriba o gaste créditos, sin enviarla. Úsalo para revisar las opciones de modelo y los parámetros antes de iniciar un bucle por lotes, o deja que un agente previsualice un comando generado antes de darle permiso para ejecutar una acción de escritura o gasto.

El --async envía una generación y devuelve inmediatamente su ID de creación en lugar de esperar. Un script por lotes puede enviar varios trabajos, hacer otras tareas y usar más tarde openart creation wait o openart creation get para recopilar resultados. Como --async devuelve antes de que exista un archivo para descargar, no se puede combinar con -o o --output.

Sin --async, OpenArt CLI envía la tarea y sondea hasta que termina. El sondeo se detiene en el --timeout, que por defecto es de cinco minutos. Una espera acotada evita que una generación fallida o un fallo de red deje un trabajo de CI ejecutándose indefinidamente, mientras que un timeout explícito te permite dar margen a trabajos de vídeo más lentos.

Por qué una CLI y no solo un navegador

Las interfaces de línea de comandos son anteriores al ratón. El primer intérprete de línea de comandos se ejecutó en el sistema CTSS del MIT en 1961, y la tradición de scripting de shell que inició, continuada con el primer shell de Unix en 1971 y el shell Bourne en 1977, sigue siendo hoy la forma en que se automatizan la mayoría de los servidores, canalizaciones de CI y herramientas de desarrollo (Wikipedia). la propia explicación de GitHub lo plantea sin rodeos: una CLI termina una tarea con unas pocas pulsaciones de tecla en lugar de una secuencia de clics, usa una fracción de los recursos que necesita una interfaz gráfica y convierte el trabajo repetitivo en un script en vez de una serie de pasos manuales.

Ese argumento cobra fuerza cuando quien emite los comandos es un agente de IA y no una persona. Los LLM son nativos de texto, así que el formato de texto de entrada y salida de una CLI significa que un agente nunca tiene que analizar una captura de pantalla para saber si un clic ha funcionado. El equipo de ingeniería de Parallel ha argumentado que las acciones de CLI también son deterministas y mucho más baratas que la automatización de navegador equivalente, ya que no hay página que renderizar, ni diseño que interpretar, ni ambigüedad sobre lo que ocurrió después de ejecutar el comando. Claude por sí solo no puede generar imágenes ni vídeo, que es justo por lo que un agente necesita una forma de acceder a un modelo que sí pueda. Esa es la misma razón por la que Claude Code y Codex usan la terminal como su espacio de trabajo, y por la que openart generate image ... encaja de forma más natural con esos agentes que controlar una sesión de navegador.

El propio término sigue siendo objeto de debate entre quienes lo usan a diario. En r/AskProgramming, los desarrolladores analizaron la diferencia entre una CLI y un programa de terminal a pantalla completa, una TUI: una CLI se basa en líneas, escribes un comando y obtienes una respuesta antes de pasar a la siguiente línea, mientras que algo como vim o htop redibuja toda la pantalla y te deja navegar por ella (r/AskProgramming). openart es una CLI en ese sentido más estricto. Cada comando es una entrada, un resultado, que es exactamente lo que espera un script o un agente, y parte de por qué no intenta ser un panel interactivo.

CLI vs MCP: elegir la superficie adecuada

OpenArt CLI encaja en flujos de trabajo que ya se ejecutan en un terminal: scripts, generación por lotes, tareas de CI y automatización basada en shell, donde los comandos y la salida legible por máquina alimentan el siguiente paso.

Los agentes de código como Claude Code y Codex pueden llamar a la CLI a través de su acceso al shell ya existente. Evitas añadir otra capa de integración y el agente usa los mismos comandos que ejecutarías tú a mano.

OpenArt's Servidor MCP encaja el trabajo creativo conversacional dentro de Claude (consulta un ejemplo de generación de vídeo desde Claude), ChatGPT, o Cursor en su lugar. MCP permite que el agente llame a las herramientas de OpenArt en mitad del chat, lo que se adapta a solicitudes iterativas en las que describes una imagen o vídeo y lo refinas mediante conversación en lugar de un script. Si comparas opciones de forma más amplia, así se compara con otros servidores MCP para generación de imágenes y vídeo.

Ninguno sustituye a la aplicación web de OpenArt. La web sigue siendo la opción adecuada cuando quieres controles visuales e inspección directa; la CLI sirve para trabajo repetible en terminal, y MCP para la interacción por chat. Elige la superficie donde ya sucede el resto de tu trabajo: si estás decidiendo entre CLI y MCP para un agente que estás creando, pregúntate si ese agente habla contigo en una ventana de chat (MCP) o se ejecuta sin supervisión en un shell o pipeline (CLI).

Inicio rápido: instala, inicia sesión, genera

En macOS o Linux, ejecuta el instalador.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

Los usuarios de Windows pueden ejecutar el instalador de PowerShell en su lugar.

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

A continuación, autentícate a través de la ventana del navegador que abre el comando de inicio de sesión.

openart login

Busca un modelo de imagen actual y copia su identificador.

openart model list

Sustituye el modelo del comando de abajo por un identificador de esa lista, como nano-banana-2. Previsualiza tu primera solicitud con --dry-run para que OpenArt no gaste créditos.

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2 \
  --dry-run

Tras revisar la vista previa, quita --dry-run para enviar la generación.

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2

Preguntas frecuentes

¿Qué es OpenArt CLI?

OpenArt CLI es un binario único para generar imágenes y vídeos desde un terminal. Se conecta a tu cuenta de OpenArt mediante OAuth en el navegador, y puedes usarlo en scripts, trabajos por lotes, tareas de CI y agentes de programación con acceso a shell.

¿OpenArt CLI es gratis de instalar?

Instalar la CLI no cuesta nada por sí solo. La generación de imágenes y vídeos consume los créditos disponibles en tu cuenta y plan de OpenArt, igual que al generar desde la aplicación web. Ejecuta openart model cost para comprobar cuánto cobra un modelo determinado antes de generar.

¿OpenArt CLI necesita una clave de API?

No. openart login abre un inicio de sesión OAuth en el navegador para tu cuenta de OpenArt, así no tienes que almacenar ni rotar un secreto aparte en la configuración local.

¿Qué plataformas son compatibles con OpenArt CLI?

macOS, Linux y Windows, distribuido como un binario independiente a través del repositorio oficial de GitHub. No necesitas tener instalado Python ni Node.

CLI vs MCP: ¿cuál debería usar?

Use the CLI when the work already happens in a terminal: shell scripts, CI pipelines, or a coding agent like Claude Code or Codex that has shell access. Use OpenArt's Servidor MCP cuando quieras un agente de chat en Claude, ChatGPT o Cursor que genere y perfeccione imágenes o vídeo en plena conversación, como harías generar anuncios de productos directamente desde Claude. Ambos no son excluyentes; algunos equipos automatizan con la CLI las partes repetibles y usan MCP para la parte exploratoria.

¿En qué se diferencia OpenArt CLI de la aplicación web?

La CLI expone las operaciones de generación y de cuenta como comandos con salida estructurada, ejecuciones de prueba y gestión asíncrona de trabajos. La aplicación web te ofrece una interfaz visual para crear y editar de forma interactiva. Usa la CLI cuando necesites comandos de shell repetibles o automatización en lugar de ir haciendo clic por una interfaz.

¿Cómo desinstalo OpenArt CLI?

No hay un comando de desinstalación integrado, así que elimina el binario y su credencial almacenada manualmente. Ejecuta rm "$(command -v openart)" y rm -rf ~/.openart en macOS o Linux, o elimina %LOCALAPPDATA%\Programs\openart y %USERPROFILE%\.openart en Windows.