Vai al contenuto principale

Riga di comando

Genera immagini e video dal terminale

Il comando spicyapi ti permette di sfogliare i modelli, controllare un prezzo esatto, avviare una generazione e scaricare il risultato, senza scrivere codice. I comandi a pagamento si fermano sempre a chiedere conferma.

Crea una chiave APIGuida completa nella documentazione

A cosa serve la CLI

È il modo più rapido per provare un modello: digiti un comando, vedi il prezzo esatto, confermi e ricevi il file. Nessun progetto, nessun codice.

  1. Digiti un comandoTerminale o PowerShell
  2. spicyapiMostra il prezzo esatto e chiede prima
  3. Il tuo risultatoUn link di download, o JSON per gli script
Sfogliare, chiedere preventivi e scaricare è gratis. Solo creare o riprovare un’attività costa.

Ideale per

  • Provare i modelli al voloConfronta modelli e prezzi prima che qualcuno scriva codice.
  • Script di shellPassa l’output di --json a jq, a job pianificati o a passaggi di CI.
  • Agenti di codingGli agenti possono eseguire i comandi e leggere il risultato JSON.

Pronta in due minuti

  1. Passaggio 1

    Installa Node.js 22.13 o successivo

    Esegui node -v. Se mostra una versione più vecchia, installa la versione LTS da nodejs.org e riapri il terminale.

    terminal
    node -v
  2. Passaggio 2

    Metti la chiave in SPICY_API_KEY

    La CLI legge la chiave solo dall’ambiente. Non viene mai accettata come argomento né stampata, quindi non può finire nella cronologia della shell.

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

    Eseguila con npx o installala una volta

    npx lancia l’ultima versione senza installare nulla. Installala globalmente se la usi ogni giorno.

    npx @spicyapi/cli status

La tua prima immagine dal terminale

Trova un modello che puoi chiamare, controlla il prezzo esatto, poi crea l’attività e attendi il risultato. Metti l’input in un file per evitare problemi con le virgolette della shell.

  1. Passaggio 1

    Trova un modello

    Elenca i modelli di immagini che puoi chiamare, con i loro prezzi.

    models list
    spicyapi models list --modality image --json
  2. Passaggio 2

    Controlla il prezzo

    Metti il prompt in un file e ottieni il costo esatto. Non viene addebitato nulla.

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

    Crea e attendi

    La CLI mostra il prezzo, aspetta il tuo sì, poi attende il risultato.

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

    Scaricalo

    Salva il file dal link del risultato prima che scada.

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

Cosa puoi fare

Solo due comandi spendono denaro, ed entrambi mostrano il prezzo e aspettano il tuo via libera.

  1. Esplora

    01
    • spicyapi status

      Verificare che SpicyAPI sia raggiungibile

      Gratis
    • spicyapi models list

      Elencare i modelli utilizzabili, con i prezzi

      Gratis
    • spicyapi models get <model>

      Mostrare le impostazioni esatte accettate da un modello

      Gratis
    • spicyapi balance

      Controllare il saldo

      Gratis

  2. Prezzo

    02
    • spicyapi tasks quote

      Ottenere il prezzo esatto prima di avviare

      Gratis

  3. Genera

    03
    • spicyapi tasks create

      Avviare una generazione di immagini o video

      Chiede conferma prima di addebitare
    • spicyapi tasks wait <task-id>

      Attendere la fine di una generazione

      Gratis
    • spicyapi tasks get <task-id>

      Mostrare una generazione e i link ai risultati

      Gratis

  4. File

    04
    • spicyapi files upload <path>

      Caricare un’immagine, un video o un file audio come input

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

      Ottenere un nuovo link di download per un risultato

      Gratis

Pensata anche per script e agenti IA

Aggiungi --json a qualsiasi comando per ottenere il risultato completo in JSON, con gli errori su una sola riga JSON su stderr e uno stato di uscita diverso da zero in caso di fallimento. Gli agenti di coding possono eseguire la CLI direttamente, oppure usare il server MCP per un’integrazione più ricca.

MCP e agentiApri il pacchettoVedi il codice sorgente
--json
spicyapi --json tasks get <task-id> > task.json

Risolvi gli errori più comuni

Di solito i problemi iniziali sono uno di questi tre. Ogni scheda mostra cosa vedi e l’unica cosa da cambiare.

  • $

    command not found: spicyapi

    L’installazione globale non è nel tuo PATH. Esegui invece npx @spicyapi/cli, oppure reinstalla con npm install -g @spicyapi/cli.

  • chiave

    Chiave non impostata

    SPICY_API_KEY dura solo nella finestra in cui l’hai impostata. Impostala di nuovo, oppure aggiungila al profilo della tua shell.

  • node

    Node.js è troppo vecchio

    La CLI richiede Node.js 22.13 o successivo. Controlla con node -v e installa l’ultima versione LTS.

Domande frequenti