PiAPI CLI Quick Start : générer images et vidéos AI depuis le terminal
PiAPI CLI est l'interface officielle en ligne de commande pour PiAPI. Elle permet d'appeler des modèles AI multimodaux pour images, vidéos, audio, 3D et LLM directement depuis le terminal.
Ce quick start couvre l'installation, l'authentification avec votre clé API, une première image, une tâche vidéo async et la découverte des modèles disponibles.
Qu'est-ce que PiAPI CLI ?
Définition rapide
PiAPI CLI est un outil Node.js en ligne de commande pour exécuter des modèles PiAPI sans ouvrir le dashboard web.
Un AI CLI est utile quand le workflow commence dans le terminal : vous pouvez sauvegarder la commande, la relancer, modifier les paramètres et l'intégrer à des scripts ou agents AI.
- Générer des assets à partir de prompts répétables
- Tester rapidement pendant le développement
- Uploader des fichiers locaux depuis un projet
- Enregistrer les sorties dans un dossier prévisible
- Retourner du JSON pour scripts, CI ou agents
PiAPI CLI en bref
| Package | piapi-cli |
|---|---|
| Commande | piapi |
| Runtime | Node.js 18+ |
| Usage principal | Génération AI multimodale dans le terminal |
| Utile pour | Développeurs, automatisation et agents AI |
Prérequis
- Node.js 18 ou plus récent
- Une clé API PiAPI
- Une application terminal
Installer PiAPI CLI
Installez le package piapi-cli avec votre gestionnaire JavaScript préféré.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpS'authentifier avec votre clé API PiAPI
Après l'installation, connectez le CLI à votre compte PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Générer votre première image AI depuis le terminal
Une fois authentifié, générez une image AI depuis le terminal avec piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Générer votre première vidéo AI depuis le terminal
La vidéo prend généralement plus de temps que l'image, il vaut donc mieux lancer les modèles vidéo en tâche async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Uploader des fichiers locaux et télécharger les résultats
PiAPI CLI peut uploader des fichiers locaux quand une valeur commence par @, puis télécharger les résultats dans le dossier choisi.
piapi run remove-bg image=@./photo.png --download --out-dir ./outExplorer les modèles et vérifier le quota
Utilisez les commandes model pour parcourir les modèles, inspecter les schémas et vérifier le quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaFlags PiAPI CLI utiles
Flags utiles pour l'automatisation :
--async | Option de workflow CLI |
--download | Option de workflow CLI |
--out-dir <path> | Option de workflow CLI |
--stream | Option de workflow CLI |
--dry-run | Option de workflow CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | Option de workflow CLI |
--quiet | Option de workflow CLI |
--non-interactive | Option de workflow CLI |
Utiliser PiAPI CLI avec agents AI et automatisation
PiAPI CLI fonctionne aussi dans les agents AI, scripts shell, jobs CI et workflows d'automatisation.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Résoudre les problèmes courants de PiAPI CLI
Si votre première commande échoue, vérifiez ces problèmes courants avant de changer de prompt ou de modèle.
Commande piapi introuvable
npx piapi-cli@latest --help
Clé API invalide ou manquante
piapi auth status
La commande vidéo renvoie un task ID au lieu d'un fichier
piapi task get <id>
Quand utiliser PiAPI CLI plutôt que la Web UI ?
Utilisez PiAPI CLI lorsque vous voulez un workflow répétable, scriptable ou utilisable par un agent AI. Le Web UI sert à explorer visuellement; le CLI sert mieux l'automatisation.
FAQ
Qu'est-ce que PiAPI CLI ?
PiAPI CLI est un outil Node.js en ligne de commande pour exécuter des modèles PiAPI sans ouvrir le dashboard web.
Comment installer PiAPI CLI ?
npm install -g piapi-cli / npx piapi-cli@latest --help
Puis-je générer images et vidéos AI depuis le terminal ?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Commencer à créer avec PiAPI CLI
PiAPI CLI donne aux développeurs et agents AI un moyen pratique de générer images, vidéos, audio, assets 3D et réponses LLM depuis la ligne de commande.
