PiAPI CLI Quick Start: genera immagini e video AI dal terminale
PiAPI CLI è l'interfaccia ufficiale da riga di comando per PiAPI. Permette di richiamare modelli AI multimodali per immagini, video, audio, 3D e LLM direttamente dal terminale.
Questa quick start copre installazione, autenticazione con API key, prima immagine, task video async e scoperta dei modelli disponibili.
Cos'è PiAPI CLI?
Definizione rapida
PiAPI CLI è uno strumento Node.js da riga di comando per eseguire modelli PiAPI senza aprire la dashboard web.
Una AI CLI è utile quando il workflow parte dal terminale: puoi salvare il comando, rieseguirlo, cambiare parametri e inserirlo in script o AI agent.
- Generare asset da prompt ripetibili
- Fare test rapidi durante lo sviluppo
- Caricare file locali da una cartella di progetto
- Salvare output in una cartella prevedibile
- Restituire JSON per script, CI o agent
PiAPI CLI in breve
| Pacchetto | piapi-cli |
|---|---|
| Comando | piapi |
| Runtime | Node.js 18+ |
| Uso principale | Generazione AI multimodale nel terminale |
| Utile per | Sviluppatori, automazione e AI agents |
Prerequisiti
- Node.js 18 o superiore
- Una PiAPI API key
- Un'app terminale
Installare PiAPI CLI
Installa il pacchetto piapi-cli con il package manager JavaScript che preferisci.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpAutenticarsi con la PiAPI API key
Dopo l'installazione, collega la CLI al tuo account PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Generare la prima immagine AI dal terminale
Dopo l'autenticazione, puoi generare un'immagine AI dal terminale con piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Generare il primo video AI dal terminale
La generazione video richiede di solito più tempo delle immagini, quindi avvia i modelli video come task async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Caricare file locali e scaricare i risultati
PiAPI CLI può caricare file locali quando un valore input inizia con @ e scaricare i risultati nella cartella scelta.
piapi run remove-bg image=@./photo.png --download --out-dir ./outEsplorare modelli e controllare la quota
Usa i comandi model per vedere modelli, schema e quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaFlag utili di PiAPI CLI
Flag utili per l'automazione:
--async | Opzione di workflow CLI |
--download | Opzione di workflow CLI |
--out-dir <path> | Opzione di workflow CLI |
--stream | Opzione di workflow CLI |
--dry-run | Opzione di workflow CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | Opzione di workflow CLI |
--quiet | Opzione di workflow CLI |
--non-interactive | Opzione di workflow CLI |
Usare PiAPI CLI con AI agents e automazione
PiAPI CLI funziona anche in AI agent, shell script, job CI e workflow di automazione.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Risolvere problemi comuni di PiAPI CLI
Se il primo comando non funziona, controlla questi problemi comuni prima di cambiare prompt o modello.
Comando piapi non trovato
npx piapi-cli@latest --help
API key non valida o mancante
piapi auth status
Il comando video restituisce un task ID invece di un file
piapi task get <id>
Quando usare PiAPI CLI invece della Web UI?
Usa PiAPI CLI quando vuoi un workflow ripetibile, scriptabile o adatto a un AI agent. La Web UI è utile per esplorare; la CLI è migliore per automatizzare.
FAQ
Cos'è PiAPI CLI?
PiAPI CLI è uno strumento Node.js da riga di comando per eseguire modelli PiAPI senza aprire la dashboard web.
Come installo PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Posso generare immagini e video AI dal terminale?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Inizia a costruire con PiAPI CLI
PiAPI CLI offre a sviluppatori e AI agent un modo pratico per generare immagini, video, audio, asset 3D e risposte LLM dalla riga di comando.
