Aller au contenu principal

Ligne de commande

Générez images et vidéos depuis votre terminal

La commande spicyapi permet de parcourir les modèles, de vérifier un prix exact, de lancer une génération et de télécharger le résultat, sans écrire une ligne de code. Les commandes payantes s’arrêtent toujours pour demander confirmation.

Créer une clé APIGuide complet dans la documentation

À quoi sert la CLI

C’est le moyen le plus rapide d’essayer un modèle : tapez une commande, voyez le prix exact, dites oui, récupérez le fichier. Ni projet, ni code.

  1. Vous tapez une commandeTerminal ou PowerShell
  2. spicyapiAffiche le prix exact et demande d’abord
  3. Votre résultatUn lien de téléchargement, ou du JSON pour les scripts
Parcourir, chiffrer et télécharger est gratuit. Seule la création ou la relance d’une tâche dépense de l’argent.

Idéal pour

  • Tester vite des modèlesComparez modèles et prix avant que quiconque n’écrive du code.
  • Scripts shellRedirigez la sortie --json vers jq, des jobs planifiés ou des étapes de CI.
  • Agents de codeLes agents peuvent lancer les commandes et lire le résultat JSON.

Prête en deux minutes

  1. Étape 1

    Installez Node.js 22.13 ou une version plus récente

    Lancez node -v. Si une version plus ancienne s’affiche, installez la version LTS depuis nodejs.org et rouvrez le terminal.

    terminal
    node -v
  2. Étape 2

    Placez votre clé dans SPICY_API_KEY

    La CLI lit la clé uniquement dans l’environnement. Elle n’est jamais acceptée en argument ni affichée : elle ne peut donc pas fuiter par l’historique de votre shell.

    export SPICY_API_KEY="sk-spicy-..."   # paste your own key
  3. Étape 3

    Lancez-la avec npx, ou installez-la une fois pour toutes

    npx exécute la dernière version sans rien installer. Installez-la globalement si vous l’utilisez tous les jours.

    npx @spicyapi/cli status

Votre première image depuis le terminal

Trouvez un modèle que vous pouvez appeler, vérifiez le prix exact, puis créez la tâche et attendez le résultat. Placez l’entrée dans un fichier pour éviter les problèmes de guillemets dans le shell.

  1. Étape 1

    Trouver un modèle

    Listez les modèles d’image que vous pouvez appeler, avec leurs prix.

    models list
    spicyapi models list --modality image --json
  2. Étape 2

    Vérifier le prix

    Placez votre prompt dans un fichier et obtenez le coût exact. Rien n’est débité.

    tasks quote
    echo '{ "prompt": "A cinematic night portrait" }' > input.json
spicyapi tasks quote --model MODEL_ID_FROM_CATALOG --input-file input.json
  3. Étape 3

    Créer et attendre

    La CLI affiche le prix, demande votre accord, puis attend le résultat.

    tasks create
    spicyapi tasks create \
  --model MODEL_ID_FROM_CATALOG \
  --input-file input.json \
  --wait
  4. Étape 4

    Le télécharger

    Enregistrez le fichier depuis le lien de résultat avant qu’il n’expire.

    download
    curl -L -o result.png "PASTE_THE_URL_HERE"

Ce que vous pouvez faire

Seules deux commandes dépensent de l’argent, et toutes deux affichent le prix puis attendent votre accord.

  1. Explorer

    01
    • spicyapi status

      Vérifier que SpicyAPI est joignable

      Gratuit
    • spicyapi models list

      Lister les modèles utilisables, avec leurs prix

      Gratuit
    • spicyapi models get <model>

      Afficher les paramètres exacts d’un modèle

      Gratuit
    • spicyapi balance

      Consulter votre solde

      Gratuit

  2. Chiffrer

    02
    • spicyapi tasks quote

      Obtenir le prix exact avant de lancer

      Gratuit

  3. Générer

    03
    • spicyapi tasks create

      Lancer une génération d’image ou de vidéo

      Demande confirmation avant de débiter
    • spicyapi tasks wait <task-id>

      Attendre la fin d’une génération

      Gratuit
    • spicyapi tasks get <task-id>

      Afficher une génération et les liens de ses résultats

      Gratuit

  4. Fichiers

    04
    • spicyapi files upload <path>

      Envoyer une image, une vidéo ou un fichier audio en entrée

      Gratuit
    • spicyapi files download-url <task-id>

      Obtenir un nouveau lien de téléchargement pour un résultat

      Gratuit

Pensée aussi pour les scripts et les agents IA

Ajoutez --json à n’importe quelle commande pour obtenir le résultat complet en JSON ; les erreurs tiennent sur une ligne JSON sur stderr, avec un code de sortie non nul en cas d’échec. Les agents de code peuvent exécuter la CLI directement, ou passer par le serveur MCP pour une intégration plus riche.

MCP et agentsOuvrir le paquetVoir le code source
--json
spicyapi --json tasks get <task-id> > task.json

Corriger les erreurs courantes

La plupart des problèmes du début sont l’un de ces trois-là. Chaque carte montre ce que vous voyez et l’unique chose à changer.

  • $

    command not found: spicyapi

    L’installation globale n’est pas dans votre PATH. Lancez plutôt npx @spicyapi/cli, ou réinstallez avec npm install -g @spicyapi/cli.

  • clé

    Clé non définie

    SPICY_API_KEY ne dure que le temps de la fenêtre où vous l’avez définie. Redéfinissez-la, ou ajoutez-la au profil de votre shell.

  • node

    Node.js trop ancien

    La CLI exige Node.js 22.13 ou plus récent. Vérifiez avec node -v et installez la version LTS actuelle.

Questions fréquentes