PiAPI CLI Quick Start: terminalden AI görselleri ve videoları üretin
PiAPI CLI, PiAPI'nin resmi komut satırı arayüzüdür. Görsel, video, ses, 3D ve LLM için multimodal AI modellerini doğrudan terminalden çağırmanızı sağlar.
Bu quick start; kurulum, API key ile kimlik doğrulama, ilk görsel komutu, async video task ve kullanılabilir modelleri keşfetme adımlarını kapsar.
PiAPI CLI nedir?
Kısa tanım
PiAPI CLI, web dashboard açmadan PiAPI modellerini çalıştırmak için kullanılan Node.js tabanlı bir komut satırı aracıdır.
AI CLI, workflow terminalde başladığında kullanışlıdır: komutu kaydedebilir, tekrar çalıştırabilir, parametreleri değiştirebilir ve script ya da AI agent içine koyabilirsiniz.
- Tekrarlanabilir promptlardan asset üretmek
- App veya prototype geliştirirken hızlı test yapmak
- Proje klasöründen local file upload etmek
- Outputları tahmin edilebilir bir klasöre kaydetmek
- Script, CI veya agent için JSON döndürmek
PiAPI CLI özet
| Paket | piapi-cli |
|---|---|
| Komut | piapi |
| Runtime | Node.js 18+ |
| Ana kullanım | Terminal tabanlı multimodal AI üretimi |
| Kimler için | Geliştiriciler, otomasyon ve AI agents |
Gereksinimler
- Node.js 18 veya daha yeni
- PiAPI API key
- Terminal uygulaması
PiAPI CLI kurulum
piapi-cli paketini tercih ettiğiniz JavaScript package manager ile kurun.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpPiAPI API key ile kimlik doğrulama
Kurulumdan sonra CLI'ı PiAPI hesabınıza bağlayın.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Terminalden ilk AI görselini üret
Kimlik doğrulamadan sonra piapi run ile terminalden AI görseli üretebilirsiniz.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Terminalden ilk AI videosunu üret
Video üretimi genellikle görselden uzun sürer; bu yüzden video modellerini async task olarak başlatın.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Local files upload et ve sonuçları indir
Input değeri @ ile başladığında PiAPI CLI local files upload edebilir ve sonuçları seçtiğiniz klasöre indirebilir.
piapi run remove-bg image=@./photo.png --download --out-dir ./outModelleri keşfet ve quota kontrol et
Model, schema ve quota görmek için model komutlarını kullanın.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaYararlı PiAPI CLI flags
Otomasyon için yararlı flags:
--async | CLI workflow seçeneği |
--download | CLI workflow seçeneği |
--out-dir <path> | CLI workflow seçeneği |
--stream | CLI workflow seçeneği |
--dry-run | CLI workflow seçeneği |
--output json | JSON output for scripts and automation |
--webhook <url> | CLI workflow seçeneği |
--quiet | CLI workflow seçeneği |
--non-interactive | CLI workflow seçeneği |
PiAPI CLI'ı AI agents ve otomasyonla kullan
PiAPI CLI, AI agents, shell scripts, CI jobs ve otomasyon workflows içinde de kullanılabilir.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Yaygın PiAPI CLI sorunlarını gider
İlk komut çalışmazsa prompt veya model değiştirmeden önce bu yaygın sorunları kontrol edin.
piapi komutu bulunamadı
npx piapi-cli@latest --help
API key geçersiz veya eksik
piapi auth status
Video komutu dosya yerine task ID döndürür
piapi task get <id>
Web UI yerine PiAPI CLI ne zaman kullanılır?
Tekrarlanabilir, scriptable veya AI agent için hazır bir workflow gerektiğinde PiAPI CLI kullanın. Web UI görsel keşif için, CLI otomasyon için daha uygundur.
FAQ
PiAPI CLI nedir?
PiAPI CLI, web dashboard açmadan PiAPI modellerini çalıştırmak için kullanılan Node.js tabanlı bir komut satırı aracıdır.
PiAPI CLI nasıl kurulur?
npm install -g piapi-cli / npx piapi-cli@latest --help
Terminalden AI görselleri ve videoları üretebilir miyim?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
PiAPI CLI ile üretmeye başla
PiAPI CLI, geliştiricilere ve AI agents'a komut satırından görsel, video, ses, 3D assets ve LLM responses üretmek için pratik bir yol sunar.
