Genera imágenes y videos desde tu terminal con OpenArt CLI

Qué es OpenArt CLI

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

El comando de inicio de sesión usa el flujo estándar de OAuth con PKCE, el mismo patrón de redirección de navegador que usan las apps de escritorio para evitar manejar una contraseña directamente. La CLI almacena la credencial resultante en ~/.openart/cli-credentials.json (modo 0600, para que solo tu cuenta de usuario pueda 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 creó la CLI como su propia superficie de producto, no como un script que hace clics por ti en la app web. Sus comandos exponen imagen y generación de video, información de modelos, estado de creación, 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 permiten una automatización repetible.

La CLI gasta los créditos de tu propia cuenta de OpenArt, el mismo saldo del que se nutre la app web. No es un producto de API aparte con su propia clave y facturación. El Repositorio de GitHub de OpenArt CLI 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 sola línea.

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

El instalador elige la compilación adecuada para tu máquina, la verifica contra 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 tiene permisos de escritura o ~/.local/bin para una instalación a nivel de usuario, en lugar de solicitar 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 agrega esa carpeta a tu usuario 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 fija. En macOS o Linux, agrega 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 primero define la versión como una 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 en 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 lugar.

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 con OAuth. Después de que apruebes el acceso, la CLI puede usar tu cuenta sin una clave de API ni un entorno de ejecución como Python o Node.

Comandos principales de un vistazo

La superficie de comandos principal

Autenticación y acceso a la cuenta

OpenArt usa OAuth del navegador para acceder a la cuenta. Inicia una sesión con openart login, termínalo con openart logout, e inspecciona tu plan o saldo de créditos con openart account.

openart login
openart account
openart logout

Generación de imágenes y video

OpenArt mantiene el tipo de medio explícito en cada comando de generación. Separa image y video comandos significan que un script no puede enrutar una solicitud 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. Agrega --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 video o imagen a video, usa el comando de video. Las opciones compatibles 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 codificar suposiciones de forma fija. openart model list muestra los modelos disponibles y los modos que admiten. Los nombres de los modelos pueden cambiar a medida que OpenArt agrega 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 cada modelo, del más barato primero, sin gastar créditos. Agrega --model y --mode para cotizar una combinación específica. El form comando devuelve los parámetros exactos que acepta un modelo y modo en particular. Si estás eligiendo entre dos de ellos, mira cómo GPT Image 2 se compara con Nano Banana 2 antes de asignarle una tarea por lotes.

Creaciones y recursos almacenados

Los comandos de creación permiten que los scripts inspeccionen el historial de generación y administren las tareas enviadas. Usa list para creaciones anteriores, get para un trabajo, y wait cuando un script debe pausarse hasta que termine un trabajo asincrónico.

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 va 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 ningún 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 subiste. El repositorio oficial de la CLI tiene la referencia de comandos actual a medida que la interfaz evoluciona.

Desinstalar es un paso manual, ya que la CLI no tiene un comando de desinstalación integrado. En macOS o Linux, elimina el binario y su credencial almacenada con rm "$(command -v openart)" y rm -rf ~/.openart. En Windows, elimina %LOCALAPPDATA%\Programs\openart, elimínalo de tu usuario PATH, y elimina %USERPROFILE%\.openart. Si encuentras un error que valga la pena reportar, incluye la salida de openart version en tu issue. Reporta la compilación, plataforma y commit exactos.

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 resuelve un problema común de automatización: análisis estructurado, gastos accidentales, trabajos de larga duración y procesos atascados.

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 una llamada a herramienta de un agente puede canalizar JSON limpio a otro comando sin tener que extraer texto legible para humanos. Un script puede extraer de forma confiable IDs 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 inspeccionar 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 de inmediato 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 los resultados. Debido a que --async regresa antes de que exista un archivo para descargar, no se puede combinar con -o o --output.

Sin --async, OpenArt CLI envía el trabajo y consulta su estado hasta que termina. La consulta se detiene en el --timeout, que tiene un valor predeterminado de cinco minutos. Una espera acotada evita que una generación fallida o un problema de red deje un trabajo de CI ejecutándose indefinidamente, mientras que un tiempo de espera explícito te permite adaptarte a trabajos de video más lentos.

Por qué una CLI y no solo un navegador

Las interfaces de línea de comandos son anteriores al mouse. El primer intérprete de línea de comandos se ejecutó en el sistema CTSS del MIT en 1961, y la tradición de scripts de shell que inició, continuada por el primer shell de Unix en 1971 y el shell Bourne en 1977, sigue siendo la forma en que se automatizan hoy la mayoría de los servidores, pipelines de CI y herramientas de desarrollo (Wikipedia). la explicación oficial de GitHub expone el caso práctico con claridad: una CLI termina una tarea en unas cuantas teclas 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.

El argumento cobra más fuerza cuando es un agente de IA, y no una persona, quien emite los comandos. 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 funcionó. El equipo de ingeniería de Parallel ha argumentado que las acciones de la CLI también son deterministas y mucho más económicas que la automatización de navegador equivalente, ya que no hay ninguna página que renderizar, ningún diseño que interpretar ni ambigüedad sobre lo que pasó después de ejecutar el comando. Claude por sí mismo no puede generar imágenes ni video, que es exactamente por lo que un agente necesita una forma de llegar a un modelo que sí pueda. Esa es la misma razón por la que Claude Code y Codex tratan la terminal como su espacio de trabajo, y es por lo que openart generate image ... encaja de forma más natural para esos agentes que controlar una sesión de navegador.

El término en sí sigue siendo debatido por las personas que 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 permite navegar por ella (r/AskProgramming). openart es una CLI en ese sentido más estricto. Cada comando es una línea de entrada, un resultado de salida, que es exactamente la forma que espera un script o un agente, y parte del motivo por el que no intenta ser un panel interactivo.

CLI vs MCP: cómo elegir la interfaz adecuada

OpenArt CLI se adapta a los flujos de trabajo que ya funcionan en una 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 programación como Claude Code y Codex pueden llamar a la CLI a través de su acceso existente a la shell. Así evitas agregar otra capa de integración, y el agente usa los mismos comandos que ejecutarías manualmente.

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

Ninguno reemplaza la aplicación web de OpenArt. La app web sigue siendo la opción correcta cuando quieres controles visuales e inspección directa; la CLI sirve para trabajo repetible en terminal, y MCP sirve para la interacción basada en chat. Elige la superficie donde ya ocurre el resto de tu trabajo: si estás decidiendo entre CLI y MCP para un agente que estás construyendo, pregúntate si ese agente te habla en una ventana de chat (MCP) o se ejecuta sin supervisión en una 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

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

openart login

Encuentra un modelo de imagen actual y copia su identificador.

openart model list

Reemplaza el modelo del comando de abajo con 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

Después de revisar la previsualización, 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 único binario para generar imágenes y videos desde una terminal. Se conecta a tu cuenta de OpenArt mediante OAuth basado en el navegador, y puedes usarlo en scripts, trabajos por lotes, tareas de CI y agentes de programación con acceso al shell.

¿La instalación de OpenArt CLI es gratis?

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

¿OpenArt CLI requiere 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?

Usa la CLI cuando el trabajo ya ocurre en una terminal: scripts de shell, pipelines de CI o un agente de código como Claude Code o Codex con acceso a shell. Usa el de OpenArt Servidor MCP cuando quieras un agente basado en chat en Claude, ChatGPT o Cursor para generar y refinar imágenes o video en medio de una conversación, como lo harías generar anuncios de productos directamente desde Claude. Los dos no son excluyentes; algunos equipos automatizan las partes repetibles con la CLI y usan MCP para la parte exploratoria.

¿En qué se diferencia OpenArt CLI de la app web?

La CLI expone las operaciones de generación y de cuenta como comandos con salida estructurada, ejecuciones de prueba y manejo asíncrono de tareas. La app web te da 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 hacer clic en 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.