PiAPI CLI Quick Start: generuj AI obrazy i wideo z terminala
PiAPI CLI to oficjalny interfejs wiersza poleceń dla PiAPI. Pozwala uruchamiać multimodalne modele AI dla obrazów, wideo, audio, 3D i LLM bezpośrednio z terminala.
Ten quick start obejmuje instalację, uwierzytelnienie API key, pierwszą komendę obrazu, async video task oraz sprawdzanie dostępnych modeli.
Czym jest PiAPI CLI?
Krótka definicja
PiAPI CLI to narzędzie Node.js command line do uruchamiania modeli PiAPI bez otwierania web dashboard.
AI CLI przydaje się, gdy workflow zaczyna się w terminalu: możesz zapisać komendę, uruchomić ją ponownie, zmienić parametry i użyć w scripts lub AI agents.
- Generować assets z powtarzalnych prompts
- Szybko testować podczas budowy app lub prototype
- Uploadować lokalne pliki z folderu projektu
- Zapisywać output w przewidywalnym folderze
- Zwracać JSON dla scripts, CI lub agents
PiAPI CLI w skrócie
| Package | piapi-cli |
|---|---|
| Command | piapi |
| Runtime | Node.js 18+ |
| Główne użycie | Terminal-based multimodal AI generation |
| Przydatne dla | Developerów, automatyzacji i AI agents |
Wymagania
- Node.js 18 lub nowszy
- PiAPI API key
- Aplikacja terminala
Instalacja PiAPI CLI
Zainstaluj package piapi-cli wybranym JavaScript package managerem.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpUwierzytelnienie przez PiAPI API key
Po instalacji połącz CLI ze swoim kontem PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Wygeneruj pierwszy AI image z terminala
Po uwierzytelnieniu możesz wygenerować AI image z terminala przez piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Wygeneruj pierwsze AI video z terminala
Generowanie video zwykle trwa dłużej niż image, więc video models najlepiej uruchamiać jako async tasks.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Upload lokalnych plików i download wyników
PiAPI CLI może uploadować lokalne pliki, gdy input zaczyna się od @, i pobierać wyniki do wybranego folderu.
piapi run remove-bg image=@./photo.png --download --out-dir ./outPrzeglądaj modele i sprawdź quota
Użyj komend model, aby sprawdzić modele, schema i quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaPrzydatne PiAPI CLI flags
Przydatne flags do automatyzacji:
--async | Opcja CLI workflow |
--download | Opcja CLI workflow |
--out-dir <path> | Opcja CLI workflow |
--stream | Opcja CLI workflow |
--dry-run | Opcja CLI workflow |
--output json | JSON output for scripts and automation |
--webhook <url> | Opcja CLI workflow |
--quiet | Opcja CLI workflow |
--non-interactive | Opcja CLI workflow |
PiAPI CLI z AI agents i automatyzacją
PiAPI CLI działa też w AI agents, shell scripts, CI jobs i workflow automatyzacji.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Rozwiązywanie typowych problemów PiAPI CLI
Jeśli pierwsza komenda nie działa, sprawdź te typowe problemy przed zmianą prompt lub model.
Nie znaleziono command piapi
npx piapi-cli@latest --help
API key jest nieprawidłowy lub brakujący
piapi auth status
Video command zwraca task ID zamiast pliku
piapi task get <id>
Kiedy używać PiAPI CLI zamiast Web UI?
Użyj PiAPI CLI, gdy potrzebujesz workflow powtarzalnego, scriptable albo gotowego dla AI agent. Web UI jest dobre do eksploracji wizualnej; CLI lepsze do automatyzacji.
FAQ
Czym jest PiAPI CLI?
PiAPI CLI to narzędzie Node.js command line do uruchamiania modeli PiAPI bez otwierania web dashboard.
Jak zainstalować PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Czy mogę generować AI images i videos z terminala?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Zacznij budować z PiAPI CLI
PiAPI CLI daje developerom i AI agents praktyczny sposób generowania obrazów, wideo, audio, 3D assets i LLM responses z command line.
