Configura il tuo account

Crea il tuo account e verifica l’email

Apri spicyapi.ai/register. Puoi registrarti in tre modi:

Spunta l’accettazione dei Termini di servizio e dell’Informativa sulla privacy, poi scegli Crea l’account.

Che cosa dovresti vedere: per un account con email, una pagina intitolata Controlla la posta. Apri l’email e fai clic sul link. La pagina Email verificata conferma l’operazione, e Vai alla console ti porta dentro.

Che cosa è appena successo: il tuo account esiste, ma potrà chiamare l’API solo dopo la verifica dell’email. Fino ad allora la console mostra il banner Email non verificata: le chiamate API sono bloccate.

• Il link funziona una sola volta e scade dopo 24 ore. Se è scaduto, aprilo comunque e usa Invia un nuovo link di verifica, oppure scegli Verifica nel banner della console.
• Dopo qualche minuto non è arrivato niente? Controlla la cartella spam, poi usa Invialo di nuovo.

Aggiungi fondi

Apri Fatturazione nella console: spicyapi.ai/console/billing. In Aggiungi fondi:

1. Scegli un importo. Seleziona uno degli importi predefiniti (ad esempio $10, $25, $50 o $100) oppure Personalizzato e scrivi il tuo. La console mostra l’importo minimo e massimo che puoi aggiungere con un singolo pagamento. I pagamenti online accettano al massimo due cifre decimali.
2. Controlla se c’è un bonus. Alcuni importi includono un bonus promozionale, indicato come +$… di bonus prima del pagamento. Il bonus viene aggiunto come voce separata, accanto all’importo che hai pagato.
3. Scegli una modalità di pagamento e segui la scheda qui sotto.

Altri messaggi che potresti vedere:

• Ricarica non disponibile oppure In questo momento non si può creare un ordine di ricarica: le ricariche sono chiuse temporaneamente, oppure hai troppi ordini in attesa. Completa o annulla quelli vecchi in Ordini di ricarica, oppure riprova più tardi.
• La connessione è caduta, quindi l’esito è ignoto: controlla Ordini di ricarica prima di riprovare, così non paghi due volte.

Facoltativo: attiva la ricarica automatica

La ricarica automatica addebita per te una carta salvata quando il saldo si sta esaurendo, così i lavori lunghi non si interrompono a metà con 40201. Funziona solo con una carta.

1. In Fatturazione, trova Ricarica automatica e scegli Salva il metodo di pagamento in sicurezza.
2. Inserisci la carta nella pagina sicura che si apre. I dati della carta restano presso il processore di pagamento.
3. Tornato su Fatturazione vedi Verifica del metodo di pagamento, poi Metodo di pagamento salvato. Se invece vedi Questa carta non si può usare qui, non è stato salvato nulla: prova con un’altra carta.
4. Compila tre campi:
   • Ricarica sotto: il saldo che fa scattare un addebito.
   • Importo di ogni ricarica: quanto aggiunge ciascun addebito. Deve rientrare nello stesso intervallo di una ricarica normale.
   • Tetto mensile: il massimo che la ricarica automatica può addebitare in un mese di calendario. Non può essere inferiore all’importo di ogni ricarica.
5. Spunta l’autorizzazione e scegli Attiva la ricarica automatica.

Che cosa dovresti vedere: La ricarica automatica è ora attiva, con questi limiti. La scheda mostra la regola, ad esempio «Ricarica $50 quando il saldo scende sotto $10», e Usato questo mese.

Le regole, con precisione:

• Controlliamo il saldo a intervalli che vanno da circa 30 secondi a 2 minuti. Quando il tuo saldo disponibile è pari o inferiore alla soglia, addebitiamo l’importo impostato sulla carta salvata.
• Ogni addebito è un normale ordine di ricarica contrassegnato come Ricarica automatica. Riceve lo stesso bonus di una ricarica manuale dello stesso importo, e puoi emettere una fattura anche per questo.
• Il tetto mensile conta i mesi di calendario in UTC. Una volta esaurito, la ricarica automatica aspetta il giorno 1 del mese successivo. Gli addebiti non riusciti non contano ai fini del tetto.
• Se un addebito non riesce, riproviamo dopo 1 ora e poi di nuovo dopo 6 ore. Se fallisce anche il terzo tentativo consecutivo, la ricarica automatica si disattiva da sola. Se la banca rifiuta la carta senza appello (ad esempio perché è rubata o chiusa), si disattiva subito. Un addebito riuscito azzera il conteggio.
• Dopo che si è disattivata da sola, sistema la carta (o salvane una nuova) e riattivala.
• Disattiva la ricarica automatica interrompe gli addebiti futuri in qualsiasi momento. Non modifica mai il saldo né le ricariche già andate a buon fine.

Crea una chiave API

Apri Chiavi API: spicyapi.ai/console/keys e scegli Crea chiave (oppure Crea la tua prima chiave).

Nella finestra Crea una chiave API è obbligatorio solo il nome. Tutto quello che trovi in Avanzate si può cambiare anche dopo.

Nome. Chiama la chiave come ciò che la userà, ad esempio production backend o my laptop. Ti servirà riconoscerla quando dovrai revocarla. Fino a 120 caratteri.

Limiti di spesa (in Avanzate, in dollari USA). Quando un limite viene raggiunto, questa chiave rifiuta le nuove attività con 40202 finché il periodo non ricomincia. Le altre tue chiavi continuano a funzionare. Il denaro accantonato per le attività ancora in corso conta per ogni limite.

Scrivi 0 in un qualsiasi limite per nessun limite; un campo vuoto equivale allo stesso.

Accesso.

• Modelli consentiti. Se lasci Tutti i modelli (nessuna restrizione), la chiave può chiamare ogni modello, compresi quelli aggiunti in futuro. Se scegli modelli specifici, la chiave rifiuta qualsiasi altro modello con 40301.
• IP consentiti. Qualsiasi indirizzo accetta chiamate da ovunque. Solo questi accetta chiamate soltanto dagli indirizzi che elenchi: IPv4, IPv6 o intervalli CIDR come 203.0.113.10, 198.51.100.0/24, separati da virgole, fino a 64 voci. Usa l’indirizzo pubblico da cui chiama il tuo server, non un indirizzo interno alla rete dell’ufficio o di casa. Le chiamate da qualsiasi altro indirizzo vengono rifiutate con 40302. Per un portatile, il cui indirizzo cambia, lascia Qualsiasi indirizzo.
• Scadenza. Scegli 7, 30 o 90 giorni, 1 anno, Mai oppure una data esatta. La chiave smette di funzionare alla fine di quel giorno, ora UTC, e da quel momento riceve lo stesso 401 di una chiave revocata.

Scegli Crea.

Che cosa dovresti vedere: una finestra Chiave creata con la chiave completa, che inizia con sk-spicy-. Copiala con Copia la chiave, oppure scegli Salva come file. Spunta Ho messo al sicuro questa chiave, poi Fatto.

Che cosa è appena successo: questa è l’unica volta in cui la chiave completa viene mostrata. Ne conserviamo solo un hash non reversibile, quindi nessuno, nemmeno la nostra assistenza, può mostrartela di nuovo. Se la perdi, revocala e creane una nuova.

In seguito, nella stessa pagina:

• Modifica cambia nome, limiti, modelli consentiti, IP consentiti e scadenza. Le modifiche hanno effetto immediato.
• Revoca blocca la chiave all’istante e non si può annullare. Le attività già accettate proseguono e vengono comunque addebitate.
• In uno stesso ambito puoi avere fino a 50 chiavi attive. Usa una chiave per ogni app o ambiente, così puoi revocarne una senza fermare le altre.

Metti la chiave in SPICY_API_KEY

Una variabile d’ambiente è un valore con un nome che il terminale passa ai programmi che avvia. L’SDK, la CLI e il server MCP ufficiali, così come ogni esempio di questa documentazione, leggono la chiave da una variabile chiamata SPICY_API_KEY. In questo modo la chiave non deve mai essere scritta dentro un comando né salvata in un progetto.

Per prima cosa apri un terminale: su macOS premi Cmd + Spazio, digita Terminale (Terminal se il Mac è in inglese) e premi Invio. Su Windows apri il menu Start, digita PowerShell e apri Windows PowerShell.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

Su un server, imposta SPICY_API_KEY nelle impostazioni dei segreti o delle variabili d’ambiente del tuo servizio di hosting, invece che in un file del progetto.

Fai una chiamata di prova gratuita

Questa chiamata chiede il tuo saldo. Non costa nulla, non crea nulla e dimostra tre cose in un colpo solo: la chiave è impostata, la chiave è valida e il tuo account è autorizzato a chiamare l’API.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

Risultato atteso: una risposta come questa (abbreviata):

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

Che cosa significa: "code": 200 indica che è andato tutto bene. Gli importi sono dollari USA scritti come testo. available è quanto puoi spendere in nuove generazioni, held è quanto resta accantonato per le generazioni ancora in corso e total è la somma dei due. La risposta reale contiene anche un oggetto funding che separa i fondi pagati da eventuali bonus promozionali; per ora puoi ignorarlo.

Se ottieni qualcos’altro:

Preferisci non usare curl? La CLI fa la stessa cosa con spicyapi balance.