PiAPI CLI Quick Start: gere imagens e vídeos com IA pelo terminal
PiAPI CLI é a interface oficial de linha de comando da PiAPI. Ela chama modelos de IA multimodais para imagens, vídeos, áudio, 3D e LLM diretamente pelo terminal.
Este quick start cobre instalação, autenticação com API key, sua primeira imagem, uma tarefa de vídeo async e a descoberta dos modelos disponíveis.
O que é PiAPI CLI?
Definição rápida
PiAPI CLI é uma ferramenta de linha de comando em Node.js para executar modelos PiAPI sem abrir o dashboard web.
Uma AI CLI é útil quando o fluxo começa no terminal: você salva comandos, executa de novo, muda parâmetros e integra em scripts ou agentes de IA.
- Gerar assets a partir de prompts repetíveis
- Testar rápido durante o desenvolvimento
- Enviar arquivos locais de uma pasta de projeto
- Salvar outputs em uma pasta previsível
- Retornar JSON para scripts, CI ou agentes
PiAPI CLI em resumo
| Pacote | piapi-cli |
|---|---|
| Comando | piapi |
| Runtime | Node.js 18+ |
| Uso principal | Geração de IA multimodal no terminal |
| Útil para | Desenvolvedores, automação e agentes de IA |
Pré-requisitos
- Node.js 18 ou mais recente
- Uma API key da PiAPI
- Um aplicativo de terminal
Instalar PiAPI CLI
Instale o pacote piapi-cli com seu package manager JavaScript preferido.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpAutenticar com sua API key da PiAPI
Depois da instalação, conecte o CLI à sua conta PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Gerar sua primeira imagem com IA pelo terminal
Depois de autenticar, gere uma imagem com IA pelo terminal usando piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Gerar seu primeiro vídeo com IA pelo terminal
Vídeos geralmente levam mais tempo que imagens, então modelos de vídeo devem começar como tarefas async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Enviar arquivos locais e baixar resultados
PiAPI CLI pode enviar arquivos locais quando o valor começa com @ e baixar os resultados para a pasta escolhida.
piapi run remove-bg image=@./photo.png --download --out-dir ./outExplorar modelos e verificar quota
Use comandos model para navegar por modelos, schemas e quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaFlags úteis do PiAPI CLI
Flags úteis para automação:
--async | Opção de workflow CLI |
--download | Opção de workflow CLI |
--out-dir <path> | Opção de workflow CLI |
--stream | Opção de workflow CLI |
--dry-run | Opção de workflow CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | Opção de workflow CLI |
--quiet | Opção de workflow CLI |
--non-interactive | Opção de workflow CLI |
Usar PiAPI CLI com agentes de IA e automação
PiAPI CLI também funciona em agentes de IA, shell scripts, jobs CI e workflows de automação.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Resolver problemas comuns do PiAPI CLI
Se o primeiro comando não funcionar, confira estes problemas comuns antes de mudar o prompt ou modelo.
Comando piapi não encontrado
npx piapi-cli@latest --help
API key inválida ou ausente
piapi auth status
O comando de vídeo retorna um task ID em vez de um arquivo
piapi task get <id>
Quando usar PiAPI CLI em vez da Web UI?
Use PiAPI CLI quando quiser um workflow repetível, scriptável ou pronto para agentes de IA. A Web UI é boa para exploração visual; o CLI é melhor para automação.
FAQ
O que é PiAPI CLI?
PiAPI CLI é uma ferramenta de linha de comando em Node.js para executar modelos PiAPI sem abrir o dashboard web.
Como instalo o PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Posso gerar imagens e vídeos com IA pelo terminal?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Comece a construir com PiAPI CLI
PiAPI CLI oferece a desenvolvedores e agentes de IA uma forma prática de gerar imagens, vídeos, áudio, assets 3D e respostas LLM pela linha de comando.
