PiAPI CLI Quick Start: KI-Bilder und Videos aus dem Terminal generieren
PiAPI CLI ist die offizielle Kommandozeile für PiAPI. Damit rufen Sie multimodale KI-Modelle für Bilder, Videos, Audio, 3D und LLMs direkt aus dem Terminal auf.
Dieser Quick Start zeigt Installation, Authentifizierung per API-Key, das erste Bild, eine Async-Videoaufgabe und das Erkunden verfügbarer Modelle.
Was ist PiAPI CLI?
Kurzdefinition
PiAPI CLI ist ein Node.js-Kommandozeilentool zum Ausführen von PiAPI-Modellen ohne Web-Dashboard.
Eine AI CLI ist nützlich, wenn der Workflow im Terminal beginnt: Befehle lassen sich speichern, wiederholen, anpassen und in Scripts oder AI Agents verwenden.
- Assets aus wiederholbaren Prompts generieren
- Schnell beim App- oder Prototypbau testen
- Lokale Dateien aus Projektordnern hochladen
- Outputs in feste Ordner speichern
- JSON für Scripts, CI oder Agents ausgeben
PiAPI CLI auf einen Blick
| Paket | piapi-cli |
|---|---|
| Befehl | piapi |
| Runtime | Node.js 18+ |
| Hauptanwendung | Multimodale KI-Generierung im Terminal |
| Nützlich für | Entwickler, Automatisierung und AI Agents |
Voraussetzungen
- Node.js 18 oder neuer
- Ein PiAPI API-Key
- Eine Terminal-App
PiAPI CLI installieren
Installieren Sie das piapi-cli-Paket mit Ihrem bevorzugten JavaScript-Paketmanager.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpMit Ihrem PiAPI API-Key authentifizieren
Verbinden Sie nach der Installation das CLI mit Ihrem PiAPI-Konto.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Ihr erstes KI-Bild aus dem Terminal generieren
Nach der Authentifizierung erstellen Sie mit piapi run ein KI-Bild aus dem Terminal.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Ihr erstes KI-Video aus dem Terminal generieren
Videoerstellung dauert meist länger als Bilderstellung, daher sollten Videomodelle als Async-Aufgaben gestartet werden.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Lokale Dateien hochladen und Ergebnisse herunterladen
PiAPI CLI kann lokale Dateien hochladen, wenn ein Eingabewert mit @ beginnt, und Ergebnisse in den gewählten Ordner laden.
piapi run remove-bg image=@./photo.png --download --out-dir ./outModelle erkunden und Quota prüfen
Nutzen Sie model-Befehle, um Modelle, Schemas und Quota zu prüfen.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaNützliche PiAPI CLI Flags
Nützliche Flags für Automatisierung:
--async | CLI-Workflow-Option |
--download | CLI-Workflow-Option |
--out-dir <path> | CLI-Workflow-Option |
--stream | CLI-Workflow-Option |
--dry-run | CLI-Workflow-Option |
--output json | JSON output for scripts and automation |
--webhook <url> | CLI-Workflow-Option |
--quiet | CLI-Workflow-Option |
--non-interactive | CLI-Workflow-Option |
PiAPI CLI mit AI Agents und Automatisierung nutzen
PiAPI CLI funktioniert auch in AI Agents, Shell-Scripts, CI-Jobs und Automatisierungsworkflows.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Häufige PiAPI CLI Probleme beheben
Falls der erste Befehl nicht funktioniert, prüfen Sie diese typischen Probleme, bevor Sie Prompt oder Modell ändern.
Befehl piapi nicht gefunden
npx piapi-cli@latest --help
Ungültiger oder fehlender API-Key
piapi auth status
Videobefehl gibt eine task ID statt einer Datei zurück
piapi task get <id>
Wann PiAPI CLI statt Web UI verwenden?
Nutzen Sie PiAPI CLI für wiederholbare, scriptbare oder agentenfähige Workflows. Die Web UI ist gut für visuelle Erkundung; das CLI ist besser für Automatisierung.
FAQ
Was ist PiAPI CLI?
PiAPI CLI ist ein Node.js-Kommandozeilentool zum Ausführen von PiAPI-Modellen ohne Web-Dashboard.
Wie installiere ich PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
Kann ich KI-Bilder und Videos im Terminal generieren?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Mit PiAPI CLI loslegen
PiAPI CLI gibt Entwicklern und AI Agents einen praktischen Weg, Bilder, Videos, Audio, 3D-Assets und LLM-Antworten über die Kommandozeile zu erzeugen.
