Gere imagens e vídeos direto do seu terminal com a OpenArt CLI

O que é o OpenArt CLI

OpenArt CLI é um único binário que dá ao seu terminal acesso a um OpenArt conta no macOS, Linux e Windows. Você faz login uma vez pelo navegador com openart login. O fluxo OAuth elimina a necessidade de instalar Python ou Node, criar uma chave de API ou armazenar uma chave de longa duração em scripts.

O comando de login usa o fluxo OAuth padrão com PKCE, o mesmo padrão de redirecionamento de navegador que apps de desktop usam para evitar lidar diretamente com uma senha. A CLI armazena a credencial resultante em ~/.openart/cli-credentials.json (modo 0600, então só a sua conta de usuário pode lê-la; o Windows a armazena em %USERPROFILE%\.openart\cli-credentials.json) e a atualiza automaticamente. openart logout revoga a credencial e limpa esse estado local.

O OpenArt construiu o CLI como sua própria superfície de produto, não um script que clica pelo app web por você. Seus comandos expõem imagem e geração de vídeo, informações de modelo, status de criação, uploads, projetos e workspaces diretamente para scripts de shell e agentes de código. Saída legível por máquina, prévias de solicitação, jobs assíncronos e polling limitado dão suporte a automações repetíveis.

O CLI gasta os créditos da sua própria conta OpenArt, o mesmo pool de onde o app web puxa. Não é um produto de API separado com chave e cobrança próprias. O Repositório do OpenArt CLI no GitHub tem as instruções canônicas de instalação, a referência de comandos e os detalhes da versão atual.

Como instalar a OpenArt CLI

O OpenArt CLI é compatível com macOS, Linux e Windows como um único binário pré-compilado. No macOS ou Linux, execute o instalador oficial.

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

No Windows, abra o PowerShell e execute o instalador de uma linha.

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

O instalador escolhe a build certa para sua máquina, verifica ela em relação aos checksums da versão e coloca openart em um diretório de executáveis padrão. No macOS e no Linux, ele usa /usr/local/bin quando esse local permite gravação ou ~/.local/bin para uma instalação em nível de usuário, em vez de solicitar sudo de forma inesperada. Se o instalador usar ~/.local/bin, verifique se esse diretório está no PATH. No Windows, ele é instalado em %LOCALAPPDATA%\Programs\openart\bin e adiciona essa pasta ao seu PATH automaticamente, então não são necessários direitos de administrador.

Ambos os scripts de instalação aceitam um local de instalação personalizado ou uma versão fixada. No macOS ou Linux, adicione as flags após o script.

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

Um script PowerShell via pipe não pode receber parâmetros diretamente, então defina a versão como uma variável de ambiente primeiro.

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

Prefere não canalizar um script para seu shell? Baixe o arquivo para sua plataforma no versão mais recente (macOS Apple silicon ou Intel, Linux x86-64 ou arm64, Windows x86-64 ou arm64), extraia-o e coloque openart no seu PATH. Cada versão inclui um checksums.txt você pode verificar com shasum -a 256 -c checksums.txt --ignore-missing.

Para atualizar depois, execute o mesmo instalador novamente. Ele sobrescreve o binário existente no lugar.

Confirme a instalação em uma nova janela de terminal.

openart --help

Depois, conecte o CLI à sua conta OpenArt.

openart login

O comando login abre um navegador para autenticação OAuth. Depois que você aprovar o acesso, o CLI pode usar sua conta sem uma chave de API ou um runtime de linguagem como Python ou Node.

Principais comandos em resumo

A superfície principal de comandos

Autenticação e acesso à conta

O OpenArt usa OAuth do navegador para acesso à conta. Inicie uma sessão com openart login, encerre com openart logout, e verifique seu plano ou saldo de créditos com openart account.

openart login
openart account
openart logout

Geração de imagens e vídeos

A OpenArt mantém o tipo de mídia explícito em todo comando de geração. Separe image e video significam que um script não pode rotear uma solicitação para o tipo de modelo errado por acidente.

Para geração de texto para imagem ou edição de imagem para imagem, use o comando image com um prompt e o ID do modelo. Adicione --image ao fornecer um arquivo local ou URL como referência.

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

O exemplo acima usa nano-banana-2; troque por qualquer modelo openart model list mostra para você.

Para texto para vídeo ou imagem para vídeo, use o comando de vídeo. As opções compatíveis podem incluir duração, proporção e resolução, dependendo do modelo.

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

Seleção de modelo e parâmetros de requisição

Os comandos de modelo permitem inspecionar as opções atuais em vez de fixar suposições no código. openart model list mostra os modelos disponíveis e os modos que eles suportam. Os nomes dos modelos podem mudar conforme o OpenArt adiciona novas opções.

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 sozinho cota todos os modelos, do mais barato ao mais caro, sem gastar créditos. Adicione --model e --mode para calcular o preço de uma combinação específica. O form retorna os parâmetros exatos aceitos por um determinado modelo e modo. Se estiver escolhendo entre dois deles, veja como o GPT Image 2 se compara ao Nano Banana 2 antes de dedicar um trabalho em lote a ele.

Criações e recursos armazenados

Comandos de criação permitem que scripts inspecionem o histórico de geração e gerenciem tarefas enviadas. Use list para criações anteriores, get para um job, e wait quando um script precisa pausar até que um trabalho assíncrono termine.

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

Os comandos de projeto e espaço de trabalho controlam onde os novos trabalhos ficam.

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

workspace select sem argumento volta para o seu espaço de trabalho pessoal, e workspace list marca o ativo com um asterisco.

Para arquivos de referência reutilizáveis, openart upload add <file> envia o recurso uma vez e imprime uma URL para comandos posteriores, e openart upload list --type image mostra o que você já enviou. O repositório oficial do CLI tem a referência atual de comandos conforme a interface evolui.

Desinstalar é uma etapa manual, já que o CLI não tem comando de desinstalação embutido. No macOS ou Linux, remova o binário e a credencial armazenada com rm "$(command -v openart)" e rm -rf ~/.openart. No Windows, exclua %LOCALAPPDATA%\Programs\openart, remova-o do seu PATH, e exclua %USERPROFILE%\.openart. Se você encontrar um bug que valha reportar, inclua a saída de openart version no seu issue. Ele informa o build, a plataforma e o commit exatos.

Flags feitas para scripts, não para cliques

O OpenArt CLI expõe controles que tornam a geração previsível dentro de scripts. Cada um resolve um problema comum de automação: parsing estruturado, gastos acidentais, jobs de longa duração e processos travados.

O --json escreve resultados legíveis por máquina na saída padrão. Mensagens de progresso e paginação vão para a saída de erro, então um job de CI ou uma chamada de ferramenta de agente pode canalizar JSON limpo para outro comando sem raspar texto legível por humanos. Um script consegue extrair de forma confiável IDs de criação, status e URLs de resultado.

O --dry-run imprime a requisição exata que o OpenArt enviaria, para qualquer comando que gravaria ou gastaria créditos, sem enviá-la. Use para inspecionar escolhas de modelo e parâmetros antes de iniciar um loop em lote, ou deixe um agente pré-visualizar um comando gerado antes de ter permissão para executar uma ação de gravação ou gasto.

O --async envia uma geração e retorna imediatamente o ID da criação em vez de esperar. Um script em lote pode enviar vários jobs, fazer outros trabalhos e depois usar openart creation wait ou openart creation get para coletar os resultados. Como --async retorna antes de existir um arquivo para baixar, não pode ser combinado com -o ou --output.

Sem --async, o OpenArt CLI envia o job e faz polling até ele terminar. O polling para no --timeout, que tem o padrão de cinco minutos. Uma espera limitada evita que uma geração falha ou um problema de rede deixe um job de CI rodando indefinidamente, enquanto um timeout explícito permite acomodar jobs de vídeo mais lentos.

Por que um CLI, e não só um navegador

As interfaces de linha de comando são anteriores ao mouse. O primeiro interpretador de linha de comando rodou no sistema CTSS do MIT em 1961, e a tradição de scripts de shell que ele iniciou, levada adiante pelo primeiro shell Unix em 1971 e pelo shell Bourne em 1977, ainda é como a maioria dos servidores, pipelines de CI e ferramentas de desenvolvimento são automatizados hoje (Wikipedia). a própria explicação do GitHub coloca o caso prático de forma clara: um CLI conclui uma tarefa em poucas teclas em vez de uma sequência de cliques, usa uma fração dos recursos que uma interface gráfica precisa e transforma trabalho repetível em um script em vez de uma série de etapas manuais.

Esse argumento fica ainda mais forte quando é um agente de IA, e não uma pessoa, que emite os comandos. LLMs são nativos em texto, então o formato de entrada e saída em texto de uma CLI faz com que o agente nunca precise analisar uma captura de tela para saber se um clique funcionou. Equipe de engenharia da Parallel argumentou que as ações da CLI também são determinísticas e muito mais baratas do que a automação de navegador equivalente, já que não há página para renderizar, layout para interpretar nem ambiguidade sobre o que aconteceu depois que o comando é executado. o próprio Claude não consegue gerar imagens ou vídeos, que é exatamente por isso que um agente precisa de uma forma de alcançar um modelo capaz disso. É a mesma razão pela qual o Claude Code e o Codex tratam um terminal como seu espaço de trabalho, e é por isso que openart generate image ... se encaixa melhor com esses agentes do que controlar uma sessão de navegador.

O próprio termo ainda é debatido pelas pessoas que o usam diariamente. No r/AskProgramming, desenvolvedores discutiram a diferença entre um CLI e um programa de terminal em tela cheia, um TUI: um CLI é baseado em linhas, você digita um comando e recebe uma resposta antes de passar para a próxima linha, enquanto algo como o vim ou o htop redesenha a tela inteira e permite navegar por ela (r/AskProgramming). openart é um CLI nesse sentido mais restrito. Cada comando é uma linha de entrada e um resultado de saída, que é exatamente o formato que um script ou agente espera, e parte do motivo pelo qual ele não tenta ser um painel interativo.

CLI vs MCP: escolhendo a interface certa

O OpenArt CLI se encaixa em fluxos de trabalho que já rodam no terminal: scripts, geração em lote, jobs de CI e automações baseadas em shell em que os comandos e a saída legível por máquina alimentam a próxima etapa.

Agentes de código como Claude Code e Codex podem chamar o CLI por meio do acesso ao shell que já têm. Você evita adicionar mais uma camada de integração, e o agente usa os mesmos comandos que você executaria manualmente.

OpenArt's Servidor MCP encaixa o trabalho criativo conversacional dentro do Claude (veja um exemplo de geração de vídeo a partir do Claude), ChatGPT, ou Cursor. O MCP permite que o agente chame ferramentas do OpenArt no meio do chat, o que combina com solicitações iterativas em que você descreve uma imagem ou vídeo e o refina por conversa em vez de por script. Se você estiver comparando opções de forma mais ampla, veja como ele se compara a outros servidores MCP para geração de imagens e vídeos.

Nenhum deles substitui o aplicativo web do OpenArt. O aplicativo web ainda é a escolha certa quando você quer controles visuais e inspeção direta; o CLI serve para trabalho repetível no terminal, e o MCP serve para interação baseada em chat. Escolha a superfície onde o resto do seu trabalho já acontece: se estiver decidindo entre CLI e MCP para um agente que você está construindo, pergunte-se se esse agente fala com você numa janela de chat (MCP) ou roda sem supervisão em um shell ou pipeline (CLI).

Início rápido: instalar, entrar, gerar

No macOS ou Linux, execute o instalador.

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

Usuários do Windows podem executar o instalador do PowerShell.

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

Em seguida, autentique-se pela janela do navegador aberta pelo comando de login.

openart login

Encontre um modelo de imagem atual e copie seu identificador.

openart model list

Substitua o modelo no comando abaixo por um identificador dessa lista, como nano-banana-2. Pré-visualize sua primeira requisição com --dry-run para que o OpenArt não gaste créditos.

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

Depois de conferir a pré-visualização, remova --dry-run para enviar a geração.

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

Perguntas Frequentes

O que é o OpenArt CLI?

O OpenArt CLI é um único binário para gerar imagens e vídeos a partir do terminal. Ele se conecta à sua conta OpenArt por meio de OAuth no navegador, e você pode usá-lo em scripts, jobs em lote, tarefas de CI e agentes de código com acesso ao shell.

A instalação do OpenArt CLI é gratuita?

Instalar o CLI não custa nada por si só. A geração de imagens e vídeos usa os créditos disponíveis na sua conta e no seu plano OpenArt, igual à geração pelo app web. Execute openart model cost para verificar quanto um determinado modelo cobra antes de gerar.

O OpenArt CLI exige uma chave de API?

Não. openart login abre um login OAuth no navegador para sua conta OpenArt, então você não precisa armazenar nem rotacionar um segredo separado na configuração local.

Quais plataformas são compatíveis com o OpenArt CLI?

macOS, Linux e Windows, distribuído como um binário independente pelo repositório oficial no GitHub. Você não precisa ter o Python ou o Node instalados.

CLI ou MCP: qual devo 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 quando você quer um agente de chat no Claude, ChatGPT ou Cursor para gerar e refinar imagens ou vídeos no meio da conversa, do jeito que você faria gerando anúncios de produtos direto do Claude. Os dois não se excluem; algumas equipes automatizam as partes repetitivas com o CLI e usam o MCP para a parte exploratória.

Qual é a diferença entre o OpenArt CLI e o app web?

O CLI expõe operações de geração e de conta como comandos com saída estruturada, execuções de teste e tratamento assíncrono de jobs. O app web oferece uma interface visual para criação e edição interativas. Escolha o CLI quando precisar de comandos de shell repetíveis ou automação em vez de clicar por uma interface.

Como faço para desinstalar o OpenArt CLI?

Não há um comando de desinstalação integrado, então remova o binário e a credencial armazenada manualmente. Execute rm "$(command -v openart)" e rm -rf ~/.openart no macOS ou Linux, ou exclua %LOCALAPPDATA%\Programs\openart e %USERPROFILE%\.openart no Windows.