PiAPI CLI Quick Start: генеруйте AI-зображення та відео з terminal
PiAPI CLI — офіційний інтерфейс командного рядка для PiAPI. Він дозволяє запускати мультимодальні AI-моделі для зображень, відео, аудіо, 3D і LLM прямо з terminal.
Цей quick start охоплює встановлення, авторизацію через API key, першу image command, async video task і перегляд доступних моделей.
Що таке PiAPI CLI?
Коротке визначення
PiAPI CLI — це Node.js command line tool для запуску моделей PiAPI без відкриття web dashboard.
AI CLI корисний, коли workflow починається в terminal: команду можна зберегти, повторити, змінити параметри та використати в scripts або AI agents.
- Генерувати assets із повторюваних prompts
- Швидко тестувати під час розробки app або prototype
- Upload локальних файлів із папки проєкту
- Зберігати outputs у передбачувану папку
- Повертати JSON для scripts, CI або agents
PiAPI CLI коротко
| Package | piapi-cli |
|---|---|
| Command | piapi |
| Runtime | Node.js 18+ |
| Основний use case | Terminal-based multimodal AI generation |
| Корисно для | Developers, automation workflows і AI agents |
Вимоги
- Node.js 18 або новіший
- PiAPI API key
- Terminal app
Встановити PiAPI CLI
Встановіть package piapi-cli через ваш JavaScript package manager.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpАвторизація через PiAPI API key
Після встановлення підключіть CLI до свого акаунта PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Створити перше AI image з terminal
Після авторизації можна створити AI image з terminal через piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Створити перше AI video з terminal
Генерація video зазвичай триває довше, ніж image, тому video models краще запускати як async tasks.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Upload локальних файлів і download результатів
PiAPI CLI може upload локальні файли, коли input починається з @, і download результати у вибрану папку.
piapi run remove-bg image=@./photo.png --download --out-dir ./outПереглянути models і перевірити quota
Використовуйте model commands, щоб переглядати models, schema і quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaКорисні PiAPI CLI flags
Корисні flags для automation:
--async | Опція CLI workflow |
--download | Опція CLI workflow |
--out-dir <path> | Опція CLI workflow |
--stream | Опція CLI workflow |
--dry-run | Опція CLI workflow |
--output json | JSON output for scripts and automation |
--webhook <url> | Опція CLI workflow |
--quiet | Опція CLI workflow |
--non-interactive | Опція CLI workflow |
Використання PiAPI CLI з AI agents і automation
PiAPI CLI також працює в AI agents, shell scripts, CI jobs і 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
Вирішення типових проблем PiAPI CLI
Якщо перша команда не працює, перевірте ці типові проблеми перед зміною prompt або model.
Команду piapi не знайдено
npx piapi-cli@latest --help
API key недійсний або відсутній
piapi auth status
Video command повертає task ID замість файлу
piapi task get <id>
Коли використовувати PiAPI CLI замість Web UI?
Використовуйте PiAPI CLI, коли потрібен repeatable, scriptable або AI agent-ready workflow. Web UI зручний для візуального дослідження; CLI краще для automation.
FAQ
Що таке PiAPI CLI?
PiAPI CLI — це Node.js command line tool для запуску моделей PiAPI без відкриття web dashboard.
Як встановити PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Чи можна генерувати AI images і videos з terminal?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Почніть будувати з PiAPI CLI
PiAPI CLI дає developers і AI agents практичний спосіб генерувати images, videos, audio, 3D assets і LLM responses з command line.
