PiAPI CLI Quick Start: Buat gambar dan video AI dari terminal
PiAPI CLI adalah command line interface resmi untuk PiAPI. Dengan tool ini, Anda bisa memanggil model AI multimodal untuk gambar, video, audio, 3D, dan LLM langsung dari terminal.
Quick start ini membahas instalasi, autentikasi API key, command gambar pertama, task video async, dan cara melihat model yang tersedia.
Apa itu PiAPI CLI?
Definisi singkat
PiAPI CLI adalah tool command line Node.js untuk menjalankan model PiAPI tanpa membuka dashboard web.
AI CLI berguna ketika workflow dimulai dari terminal: command bisa disimpan, dijalankan ulang, diubah parameternya, lalu dipakai di script atau AI agent.
- Membuat asset dari prompt yang bisa diulang
- Tes cepat saat membangun app atau prototype
- Upload file lokal dari folder proyek
- Simpan output ke folder yang jelas
- Kembalikan JSON untuk script, CI, atau agent
Sekilas tentang PiAPI CLI
| Package | piapi-cli |
|---|---|
| Command | piapi |
| Runtime | Node.js 18+ |
| Use case utama | Generasi AI multimodal berbasis terminal |
| Cocok untuk | Developer, otomasi, dan AI agents |
Prasyarat
- Node.js 18 atau lebih baru
- PiAPI API key
- Aplikasi terminal
Instal PiAPI CLI
Instal package piapi-cli dengan package manager JavaScript pilihan Anda.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpAutentikasi dengan PiAPI API key
Setelah instalasi, hubungkan CLI ke akun PiAPI Anda.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Buat gambar AI pertama dari terminal
Setelah autentikasi, buat gambar AI dari terminal dengan piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Buat video AI pertama dari terminal
Pembuatan video biasanya lebih lama daripada gambar, jadi model video sebaiknya dijalankan sebagai task async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Upload file lokal dan download hasil
PiAPI CLI dapat mengupload file lokal saat nilai input diawali @, lalu mengunduh hasil ke folder yang Anda pilih.
piapi run remove-bg image=@./photo.png --download --out-dir ./outJelajahi model dan cek quota
Gunakan command model untuk melihat model, schema, dan quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaFlags PiAPI CLI yang berguna
Flags yang berguna untuk otomasi:
--async | Opsi workflow CLI |
--download | Opsi workflow CLI |
--out-dir <path> | Opsi workflow CLI |
--stream | Opsi workflow CLI |
--dry-run | Opsi workflow CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | Opsi workflow CLI |
--quiet | Opsi workflow CLI |
--non-interactive | Opsi workflow CLI |
Gunakan PiAPI CLI dengan AI agents dan otomasi
PiAPI CLI juga bisa dipakai di AI agent, shell script, CI job, dan workflow otomasi.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Troubleshooting masalah umum PiAPI CLI
Jika command pertama tidak berhasil, cek masalah umum berikut sebelum mengganti prompt atau model.
Command piapi tidak ditemukan
npx piapi-cli@latest --help
API key tidak valid atau belum ada
piapi auth status
Command video mengembalikan task ID, bukan file
piapi task get <id>
Kapan memakai PiAPI CLI daripada Web UI?
Gunakan PiAPI CLI saat Anda butuh workflow yang bisa diulang, dibuat script, atau diberikan ke AI agent. Web UI cocok untuk eksplorasi visual; CLI lebih cocok untuk otomasi.
FAQ
Apa itu PiAPI CLI?
PiAPI CLI adalah tool command line Node.js untuk menjalankan model PiAPI tanpa membuka dashboard web.
Bagaimana cara menginstal PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Bisakah membuat gambar dan video AI dari terminal?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Mulai membangun dengan PiAPI CLI
PiAPI CLI memberi developer dan AI agents cara praktis untuk membuat gambar, video, audio, 3D assets, dan respons LLM dari command line.
