PiAPI CLI Quick Start: генерируйте AI-изображения и видео из терминала
PiAPI CLI — официальная командная строка для PiAPI. Она позволяет запускать мультимодальные AI-модели для изображений, видео, аудио, 3D и LLM прямо из терминала.
Этот quick start показывает установку, авторизацию по API key, первую генерацию изображения, async video task и просмотр доступных моделей.
Что такое PiAPI CLI?
Краткое определение
PiAPI CLI — это Node.js CLI-инструмент для запуска моделей PiAPI без открытия web dashboard.
AI CLI удобен, когда workflow начинается в терминале: команду можно сохранить, повторить, изменить параметры и использовать в scripts или AI agents.
- Генерировать assets из повторяемых prompts
- Быстро тестировать во время разработки
- Загружать локальные файлы из папки проекта
- Сохранять output в предсказуемую папку
- Возвращать JSON для scripts, CI или agents
PiAPI CLI вкратце
| Пакет | piapi-cli |
|---|---|
| Команда | piapi |
| Runtime | Node.js 18+ |
| Основной сценарий | Мультимодальная AI-генерация в терминале |
| Полезно для | Разработчиков, автоматизации и AI agents |
Требования
- Node.js 18 или новее
- PiAPI API key
- Терминал
Установить PiAPI CLI
Установите пакет 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-изображение из терминала
После авторизации можно создать AI-изображение из терминала с помощью 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 models лучше запускать как async tasks.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Загрузить локальные файлы и скачать результаты
PiAPI CLI может загружать локальные файлы, когда input начинается с @, и скачивать результаты в выбранную папку.
piapi run remove-bg image=@./photo.png --download --out-dir ./outИзучить модели и проверить quota
Используйте команды model, чтобы просматривать модели, schema и quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaПолезные flags PiAPI CLI
Полезные flags для автоматизации:
--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 и автоматизацией
PiAPI CLI также подходит для AI agents, shell scripts, CI jobs и workflow автоматизации.
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, когда нужен повторяемый, scriptable workflow или workflow для AI agent. Web UI удобен для визуального исследования; CLI лучше для автоматизации.
FAQ
Что такое PiAPI CLI?
PiAPI CLI — это Node.js CLI-инструмент для запуска моделей PiAPI без открытия web dashboard.
Как установить PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Можно ли генерировать AI-изображения и видео из терминала?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Начать работу с PiAPI CLI
PiAPI CLI дает разработчикам и AI agents практичный способ генерировать изображения, видео, аудио, 3D assets и LLM responses из командной строки.
