PiAPI CLI Quick Start: AI-afbeeldingen en video's genereren vanuit je terminal
PiAPI CLI is de officiële command line interface voor PiAPI. Je roept multimodale AI-modellen voor afbeeldingen, video, audio, 3D en LLM direct vanuit de terminal aan.
Deze quick start behandelt installatie, authenticatie met je API key, je eerste afbeelding, een async video task en het bekijken van beschikbare modellen.
Wat is PiAPI CLI?
Korte definitie
PiAPI CLI is een Node.js command line tool om PiAPI-modellen uit te voeren zonder het web dashboard te openen.
Een AI CLI is handig wanneer de workflow in de terminal begint: je kunt commands opslaan, opnieuw uitvoeren, parameters wijzigen en ze in scripts of AI agents gebruiken.
- Assets genereren uit herhaalbare prompts
- Snel testen tijdens app- of prototypebouw
- Lokale bestanden uploaden vanuit een projectmap
- Outputs opslaan in een voorspelbare map
- JSON teruggeven voor scripts, CI of agents
PiAPI CLI in het kort
| Package | piapi-cli |
|---|---|
| Command | piapi |
| Runtime | Node.js 18+ |
| Belangrijkste gebruik | Terminal-based multimodal AI generation |
| Handig voor | Developers, automatisering en AI agents |
Vereisten
- Node.js 18 of nieuwer
- Een PiAPI API key
- Een terminal app
PiAPI CLI installeren
Installeer het piapi-cli package met je favoriete JavaScript package manager.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpAuthenticeren met je PiAPI API key
Koppel na installatie de CLI aan je PiAPI-account.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Je eerste AI-afbeelding vanuit de terminal genereren
Na authenticatie kun je met piapi run een AI-afbeelding vanuit de terminal genereren.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Je eerste AI-video vanuit de terminal genereren
Video generation duurt meestal langer dan images, dus start video models als async tasks.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Lokale bestanden uploaden en resultaten downloaden
PiAPI CLI kan lokale bestanden uploaden wanneer een inputwaarde met @ begint en resultaten downloaden naar de map die je kiest.
piapi run remove-bg image=@./photo.png --download --out-dir ./outModellen verkennen en quota controleren
Gebruik model commands om modellen, schema's en quota te bekijken.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaHandige PiAPI CLI flags
Handige flags voor automatisering:
--async | CLI workflow option |
--download | CLI workflow option |
--out-dir <path> | CLI workflow option |
--stream | CLI workflow option |
--dry-run | CLI workflow option |
--output json | JSON output for scripts and automation |
--webhook <url> | CLI workflow option |
--quiet | CLI workflow option |
--non-interactive | CLI workflow option |
PiAPI CLI gebruiken met AI agents en automatisering
PiAPI CLI werkt ook in AI agents, shell scripts, CI jobs en automation workflows.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Veelvoorkomende PiAPI CLI-problemen oplossen
Als je eerste command niet werkt, controleer dan deze veelvoorkomende problemen voordat je prompt of model wijzigt.
piapi command niet gevonden
npx piapi-cli@latest --help
API key ongeldig of ontbreekt
piapi auth status
Video command geeft een task ID terug in plaats van een bestand
piapi task get <id>
Wanneer PiAPI CLI gebruiken in plaats van Web UI?
Gebruik PiAPI CLI wanneer je een herhaalbare, scriptbare of AI-agent-ready workflow wilt. De Web UI is goed voor visuele verkenning; de CLI is beter voor automatisering.
FAQ
Wat is PiAPI CLI?
PiAPI CLI is een Node.js command line tool om PiAPI-modellen uit te voeren zonder het web dashboard te openen.
Hoe installeer ik PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Kan ik AI-afbeeldingen en video's vanuit de terminal genereren?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Begin met bouwen met PiAPI CLI
PiAPI CLI geeft developers en AI agents een praktische manier om afbeeldingen, video's, audio, 3D assets en LLM responses vanuit de command line te genereren.
