Console e team

La console su spicyapi.ai/console è il posto in cui gestisci il tuo account da un browser web: denaro, chiavi API, log, colleghi e impostazioni. I tuoi programmi non usano mai la console: chiamano l’API con una chiave API.

Sei nuovo? Segui prima Configura il tuo account, che ti guida in ordine nella registrazione, nella ricarica del saldo e nella creazione di una chiave. Questa pagina è il riferimento per tutto il resto della console.

Orientarsi nella console

In alto, su ogni pagina: il tuo saldo con il pulsante Ricarica, Modelli, Documentazione, la campanella delle notifiche e Trova una pagina (premi ⌘K su macOS oppure Ctrl + K su Windows e Linux, poi scrivi il nome di una pagina della console).

A sinistra, la barra laterale. In cima c’è il selettore dell’ambito, che decide quale account o team stai guardando (vedi Ambito personale e team). Sotto, le pagine sono raggruppate così:

Da telefono, apri la barra laterale con il pulsante del menu.

Le pagine della console in breve

Tutti gli indirizzi iniziano con https://spicyapi.ai. Gli indirizzi della console non hanno un prefisso di lingua.

Che cosa fa ogni pagina

Panoramica

La prima pagina che vedi dopo l’accesso.

• Checklist Primi passi: Verifica la tua email, Aggiungi fondi, Esegui la tua prima attività, più i link per sviluppare con l’API o per creare senza codice. Quando hai finito, nascondila con Nascondi i primi passi.
• Saldo disponibile, con l’importo accantonato per le attività ancora in corso e quanto hai speso negli ultimi 7 giorni.
• Richieste degli ultimi 7 giorni ed Errori degli ultimi 7 giorni, con i link Vedi i consumi e Vedi i log.
• Modelli usati di recente e Attività recenti.
• Un avviso quando il saldo è basso o a zero. Con il saldo a zero, le nuove attività vengono respinte finché non ricarichi; le attività già accettate vengono comunque portate a termine.

Fatturazione

Fatturazione ha tre schede: Panoramica, Consumi e Fatture.

Fatturazione → Panoramica (/console/billing)

• Aggiungi fondi con carta, cripto oppure, quando è offerto, pagamento manuale. Istruzioni passo passo, tempi e che cosa fare se un pagamento non compare sono in Configura il tuo account → Aggiungi fondi.
• Ordini di ricarica: ogni ricarica con il suo stato (In attesa, Pagato, Annullato, Rimborsato). Apri un ordine manuale in attesa con Completa il pagamento per vederne le istruzioni di pagamento, inviare il riferimento della transazione oppure scegliere Annulla l’ordine in attesa se non hai ancora pagato.
• Ricarica automatica: salva una carta e lascia che siamo noi a ricaricare quando il saldo si sta esaurendo. Le regole precise, compreso che cosa succede quando un addebito non riesce, sono in Configura il tuo account → Ricarica automatica.
• Dettaglio del saldo: compare solo se il tuo account ha bonus promozionale o credito approvato. Elenca ogni lotto di bonus promozionale con la sua data di scadenza.
• Movimenti del saldo: ogni movimento di denaro, dal più recente. Filtra per tipo e intervallo di date, oppure usa Esporta CSV. Le voci tipiche sono Ricarica, Bonus, Accantonato (messo da parte quando un’attività viene accettata), Addebitato (il prezzo finale di un’attività riuscita), Accantonamento liberato (la parte non usata che torna disponibile) e Restituito (l’intero accantonamento reso dopo un errore o un timeout). Vedi Fatturazione per capire come funzionano gli addebiti.

Fatturazione → Consumi (/console/billing/usage)

Attività e spesa giorno per giorno, in un grafico, per gli ultimi 7, 30 o 90 giorni oppure per un intervallo personalizzato fino a 92 giorni (giorni UTC). Sotto trovi Per modello: attività, errori, spesa e quota di ciascun modello, con Vedi le attività per saltare a quelle attività nei Log. Esporta CSV scarica i totali giornalieri mostrati. L’endpoint dei consumi dell’API riporta solo i dati della chiave che lo chiama; questa pagina mostra invece l’intero ambito selezionato nella barra laterale.

Fatturazione → Fatture (/console/billing/invoices)

Inserisci i dati di fatturazione, emetti una fattura di pagamento per una ricarica pagata o un riepilogo dei consumi per un mese chiuso, e crea i Rendiconti mensili (CSV). In che cosa si differenziano i vari documenti, e come correggerne uno, è spiegato in Configura il tuo account → Fatture e ricevute.

Chiavi API

Crea, modifica e revoca le chiavi usate dai tuoi programmi. L’elenco mostra per ogni chiave il valore mascherato, la spesa finora, i limiti, i modelli consentiti, gli IP consentiti, la scadenza e l’ultimo utilizzo. Puoi cercare per nome o per chiave mascherata e filtrare per Attive, Scadute o Revocate.

• Crea chiave crea una chiave nell’ambito selezionato nella barra laterale. La chiave completa viene mostrata una sola volta.
• Modifica cambia nome, limiti di spesa (giornaliero, mensile, complessivo), modelli consentiti, IP consentiti e scadenza. In modifica, un limite vuoto significa nessun limite.
• Revoca blocca subito una chiave e non si può annullare. Le attività già accettate proseguono e vengono addebitate.

Ogni campo è spiegato in Configura il tuo account → Crea una chiave API. I codici di errore prodotti da ciascuna restrizione sono in Autenticazione.

In un team: puoi creare e gestire le chiavi del team solo con il ruolo Proprietario, Amministratore o Sviluppatore. Consumi e limiti di una chiave del team vengono conteggiati sul team, e le sue attività le paga il proprietario del team.

Webhook

Un webhook è un messaggio che SpicyAPI invia al tuo server quando un’attività finisce, così non devi continuare a chiedere. L’indirizzo lo scegli per ogni attività con callBackUrl. Questa pagina fa due cose.

Chiave di firma dei webhook. Ogni callback è firmata, così il tuo server può verificare che arrivi davvero da SpicyAPI. Il tuo account ha una sola chiave di firma, condivisa da tutte le sue chiavi API, e il suo valore viene mostrato una sola volta, nel momento in cui viene creata. I nuovi account hanno già una chiave che nessuno ha mai visto, quindi la scheda può dire Configurata anche se non hai niente da copiare:

1. Scegli Genera (se la scheda dice Non impostata) oppure Ruota (se dice Configurata).
2. Copia la nuova chiave nelle impostazioni del tuo server, di solito come SPICY_WEBHOOK_SECRET.
3. Scegli L’ho salvata.

Consegne dei webhook. Ogni tentativo di callback del tuo account, dal più recente, filtrabile per Consegnate, Nuovo tentativo e Non riuscite, con il numero di tentativi e l’orario del prossimo nuovo tentativo. Riprova invia di nuovo il messaggio firmato originale: assicurati che il tuo server possa ricevere lo stesso messaggio due volte senza problemi. Una consegna il cui contenuto memorizzato è già stato cancellato dalle tue impostazioni di conservazione non può essere ritentata.

Integrazioni

Configurazioni da copiare e incollare per gli strumenti che funzionano con SpicyAPI. Scegli uno strumento per vederne la configurazione e il link Documentazione.

• Le basi della connessione: l’URL di base per i client compatibili con OpenAI e una scorciatoia Crea una chiave. Dai alla chiave il nome dello strumento che la usa.
• Strumenti ufficiali: l’SDK TypeScript, la CLI, il server MCP e l’Agent Skill.
• Client compatibili con OpenAI: strumenti che ti permettono di cambiare l’URL di base, per modelli di testo e video. La generazione di immagini non è disponibile sugli endpoint compatibili.
• Agenti di coding: editor e agenti che aggiungono il server MCP, il quale ti chiede di confermare ogni addebito.

Gli snippet usano il segnaposto MODEL_ID_FROM_CATALOG: sostituiscilo con un ID di modello esatto preso dal catalogo in tempo reale (GET /api/v1/models, spicyapi models list oppure listModels()). Vedi Catalogo dei modelli e schemi.

Log

Tutte le attività, dalla più recente, comprese quelle non riuscite. Ogni riga mostra attività, modello, stato, latenza e costo.

• Filtri: stato, modello e intervallo di date. La casella di ricerca accetta un ID attività o ID richiesta esatto, ed è il modo più rapido per trovare l’attività dietro una segnalazione di errore. La pagina carica fino a 500 righe; per vederne altre, restringi i filtri.
• Esporta CSV esporta tutte le attività che rispettano i filtri: per impostazione predefinita gli ultimi 30 giorni, al massimo 92 giorni o 10.000 righe.
• Apri i dettagli su un’attività mostra stato, costo, ora di inizio e di fine, la chiave usata, l’ID attività e l’ID richiesta, il codice di errore e Perché non è riuscita, i parametri della richiesta, la risposta e i link di download (Ottieni un link: ogni link scade, e puoi generarne uno nuovo).

Il riquadro del costo mostra l’importo accantonato durante l’esecuzione e l’addebito effettivo dopo la liquidazione. Anche un’attività fallita può essere addebitata per un rifiuto di contenuto indicato esplicitamente nella pagina del modello. Controlla la liquidazione senza dedurre un rimborso dallo stato.

Nei dettagli dell’attività compaiono tre azioni:

Nessuna di queste azioni annulla un’attività in corso: le attività accettate non si possono annullare. Vedi Conservazione e distruzione per sapere che cosa l’eliminazione conserva e che cosa rimuove.

In un team: ogni membro vede le attività del team con stato e costo. Solo Proprietario, Amministratore e Sviluppatore vedono prompt, risultati e link di download. Le tre azioni qui sopra sono disponibili solo per l’account che ha pagato l’attività.

Team

Crea team, invita persone, cambia i ruoli, imposta i limiti di spesa del team, ed esci da un team o cedilo. Lavori da solo? Non ti serve un team: chiavi, saldo e consumi funzionano già da soli. Tutto sui team è spiegato più sotto, in Team.

Impostazioni

Una sola pagina, divisa in gruppi.

Account

• Email, contrassegnata come Verificata o Non verificata. Per cambiare l’email di accesso usa Cambia l’email di accesso: inviamo un link di conferma al nuovo indirizzo (valido 20 minuti) e un avviso a quello vecchio. Ti serve la password attuale.
• Nome visualizzato, ID account (indicalo quando contatti l’assistenza) e Iscritto dal.

Sicurezza

• Password. Cambiarla disconnette tutti i dispositivi. Un account creato con Google o GitHub non ha una password finché non scegli Invia il link via email e ne imposti una; la password serve per chiudere l’account o trasferire un team.
• Dispositivi collegati. Disconnetti qualsiasi dispositivo che non riconosci, oppure scegli Disconnetti ovunque (compreso questo dispositivo) se pensi che qualcun altro abbia accesso. Subito dopo cambia la password.
• Autenticazione a due fattori. Scegli Configura la 2FA, inserisci la password attuale, aggiungi l’account a un’app di autenticazione e inserisci il codice a sei cifre che mostra. Da quel momento ogni accesso chiede un codice. Ricevi anche dieci codici di recupero monouso: conservali in un posto diverso dal telefono, perché senza il telefono sono l’unico modo per rientrare e non possono essere mostrati di nuovo. Nuovi codici di recupero li sostituisce tutti; Disattiva la 2FA la rimuove. Entrambe le azioni ti chiedono prima di confermare la tua identità.
• Attività di sicurezza: accessi recenti, nuovi dispositivi e modifiche alle credenziali.

Preferenze

• Lingua degli errori API: la lingua di msg nelle risposte di errore e di errorMessage delle attività (nei controlli di stato e nei webhook) per le richieste fatte con le tue chiavi API. L’inglese è la lingua predefinita. L’intestazione Accept-Language di una richiesta ha la precedenza, e i codici su cui basare la logica del tuo programma (code, errorCode) non cambiano mai. Vedi Errori.

Fatturazione e dati

• Scorciatoie per Dati di fatturazione e rendiconti (in Fatturazione → Fatture) e Dati e privacy (la pagina Protezione dati).

Zona a rischio: Chiudi l’account

La chiusura disconnette tutti i dispositivi, revoca definitivamente tutte le chiavi API ed elimina i media generati e i contenuti delle attività conservati. I record di fatturazione, di audit e di riconciliazione vengono mantenuti, come descritto nell’Informativa sulla privacy. Gli ordini di ricarica abbandonati e mai pagati vengono annullati per te. La chiusura resta in attesa solo finché:

• ci sono attività in coda o in corso, oppure attività terminate ancora in fase di liquidazione (di solito entro un minuto);
• un pagamento di ricarica è ancora in elaborazione (si risolve da solo quando il provider di pagamento lo conferma o lo rilascia, di solito in pochi minuti; contatta il supporto se è ancora lì dopo un’ora);
• l’account deve del denaro (credito approvato in uso o saldo negativo), che sistemi ricaricando;
• un team di cui sei proprietario deve ancora essere trasferito a un altro membro oppure svuotato degli altri membri.

La console elenca tutto ciò che è ancora d’ostacolo. Confermi con la password attuale oppure, se ti sei registrato con Google o un altro provider di accesso e non hai una password, con un codice di 6 cifre che ti inviamo via email (valido per 15 minuti).

Notifiche

• Avviso di saldo basso. Attivalo e scegli una soglia ($5, $10, $25, $50 o $100). Quando il saldo disponibile scende sotto quella soglia, ricevi un avviso nella campanella delle notifiche, più un’email se il tuo account ha un indirizzo email. Vieni avvisato di nuovo solo dopo che il saldo è risalito alla soglia o sopra ed è poi sceso di nuovo sotto. Il saldo viene controllato circa ogni 10 minuti.
• Aggiornamenti sui modelli che segui. Segui un modello dalla sua pagina su spicyapi.ai; Gestisci apre l’elenco dei modelli seguiti e delle novità di prodotto.
• Recapito. Gli avvisi nell’app sono sempre attivi. Le email Novità di prodotto e Offerte e annunci si possono attivare o disattivare. Gli avvisi su sicurezza, fatturazione e continuità del servizio vengono sempre inviati.

Protezione dati

• Conservazione: tre orologi separati per Risultati generati, Testo dei prompt e File caricati. Puoi solo renderli più brevi rispetto ai massimi della piattaforma (14 giorni per i risultati, 30 giorni per il testo dei prompt, 24 ore per i caricamenti). Accorciare un orologio può eliminare contenuti di attività che hai già eseguito alla pulizia successiva, che avviene entro un minuto; prima che tu confermi, la console conta che cosa verrà coinvolto, e i contenuti eliminati non si possono recuperare. Scarica prima tutto ciò che vuoi tenere.
• Conservazione dei contenuti delle attività: una scheda meno recente con due impostazioni. Conserva i contenuti delle attività mostra in giorni per quanto tempo vengono conservati i contenuti delle attività; la durata si imposta con i tre orologi qui sopra. Cancella i contenuti poco dopo il completamento cancella i contenuti di un’attività terminata circa un’ora dopo che i risultati sono stati memorizzati e il webhook è stato consegnato.
• Dove finiscono i tuoi dati: un riepilogo degli impegni già presi nell’Informativa sulla privacy, compreso il fatto che i tuoi input e output non vengono usati per addestrare modelli.
• Scarica i tuoi dati: un file JSON con il tuo profilo, i ruoli nei team, i dettagli delle chiavi API (mai le chiavi stesse), i dati delle attività conservati e i record di fatturazione. I file multimediali non sono inclusi, quindi scarica i risultati a parte.

Le regole complete, compresa l’impostazione per singola richiesta e che cosa l’eliminazione conserva, sono in Conservazione e distruzione.

Assistenza

Apri una conversazione privata che possono leggere solo tu e l’assistenza di SpicyAPI. Scegli Nuova conversazione, un oggetto e un argomento (Account, Fatturazione, Integrazione API, Attività o risultato, Privacy, Enterprise o Altro) e descrivi che cosa è successo. Le risposte compaiono nella conversazione (con stato In attesa dell’assistenza, In attesa di te, Risolta o Chiusa) e nella campanella delle notifiche.

Aiutaci ad aiutarti in fretta: indica l’ID attività, il request_id di una risposta di errore oppure l’ID dell’ordine di ricarica, e più o meno quando è successo (in UTC). Non incollare mai una chiave API, una password o i dati della carta. Puoi anche scrivere a support@spicyapi.ai.

Team

Ambito personale e team

Ogni account ha un ambito Personale. Non c’è nessun altro dentro, e se lavori da solo è tutto ciò che ti serve: chiavi personali, saldo e consumi funzionano senza un team.

Un team permette ai colleghi di condividere chiavi API, vedere la stessa cronologia delle attività e lavorare con limiti di spesa comuni. Ogni team ha i propri membri, le proprie chiavi e i propri limiti.

Il selettore dell’ambito in cima alla barra laterale decide che cosa mostra la console:

• Personale: solo il tuo ambito.
• Il nome di un team: solo chiavi, attività, consumi e movimenti di quel team.
• Tutti gli ambiti: tutto ciò a cui hai accesso, insieme.
• Nuovo team: una scorciatoia per crearne uno.

Decide anche dove finisce una nuova chiave API: una chiave creata mentre è selezionato un team appartiene a quel team.

Chi paga per un team

Ogni attività inviata con una chiave API di un team viene pagata con il saldo del proprietario del team. È la regola più importante dei team.

• I membri non ricaricano mai un team e non vedono mai il saldo del proprietario, le sue ricariche, i suoi dati di pagamento o le sue fatture.
• Se sei un membro e una chiave del team inizia a restituire 40201, è il proprietario che deve aggiungere fondi.
• Le tue chiavi personali, il tuo saldo e i tuoi consumi non vengono mai condivisi con un team in cui entri, e uscire da un team non li tocca.
• Proprietari, amministratori e sviluppatori possono creare chiavi del team che spendono il saldo del proprietario. Se sei proprietario, imposta i limiti di spesa del team e dai alle chiavi i loro limiti.

Crea un team

1. Apri Team e scegli Crea un team (oppure Nuovo team nel selettore dell’ambito).
2. Inserisci un nome per il team (fino a 120 caratteri) e scegli Crea il team.

Diventi il Proprietario del team. Un account può possedere fino a 10 spazi di lavoro, e il tuo ambito Personale conta come uno di questi, quindi puoi creare fino a nove team. Non c’è limite al numero di team di altre persone in cui puoi entrare.

Invita persone

Solo un Proprietario o un Amministratore può invitare.

Regole degli inviti:

• Un invito può essere accettato solo da un account la cui email corrisponde all’indirizzo invitato. Con un’email diversa si riceve Please sign in with the invited email address to accept this invite.
• Gli account privati in autocustodia non possono entrare nei team, perché non hanno un indirizzo email.
• Un solo invito in attesa per email in ogni team. Chi è già membro non può essere invitato di nuovo.
• Un team può avere fino a 100 membri, proprietario compreso.
• Revoca annulla un invito in attesa in qualsiasi momento; puoi invitare di nuovo la stessa persona in seguito.
• Un invito scaduto non può essere accettato. Inviane uno nuovo.

Ruoli e permessi

Nella console i ruoli compaiono con questi nomi. L’API e le esportazioni usano i nomi in minuscolo tra parentesi.

Inoltre:

• Nessuno può cambiare il proprio ruolo. Il ruolo del proprietario cambia solo con un trasferimento.
• Ripetere, distruggere o rimuovere un’attività è possibile solo per l’account che l’ha pagata, qualunque sia il ruolo.
• Un membro con un ruolo che non può leggere i contenuti vede Il tuo ruolo permette di vedere stato delle attività e consumi, ma non di leggere i prompt e i risultati.
• Nessuno tranne il proprietario vede mai il saldo personale, le ricariche, i dati di pagamento o le fatture del proprietario. Movimenti del team elenca solo i movimenti di denaro causati dalle attività del team.

Limiti di spesa del team

Ogni team (e anche il tuo ambito Personale) ha un limite giornaliero e uno mensile in dollari USA, in Team → il tuo team → Limiti di spesa. Proprietari, amministratori e responsabili del budget possono cambiarli con Modifica, poi Salva i limiti.

• Valgono per tutte le attività inviate con le chiavi di quell’ambito, sommate insieme.
• Contano sia il denaro già addebitato sia il denaro accantonato per le attività ancora in corso.
• Il limite giornaliero riparte alle 00:00 UTC; quello mensile il giorno 1 di ogni mese alle 00:00 UTC.
• Il valore predefinito è Nessun limite. Scrivi 0 per nessun limite. Se lasci un campo vuoto, mantiene il valore attuale.
• Un’attività che supererebbe un limite viene rifiutata con 40202 e il messaggio Workspace daily budget has been reached o Workspace monthly budget has been reached. Non viene creato nulla e non viene accantonato nulla.

I limiti del team si applicano in aggiunta ai limiti giornaliero, mensile e complessivo di ogni chiave e al saldo del proprietario. Il primo che si esaurisce ferma l’attività. Vedi Fatturazione per tutti i limiti di spesa.

Cambia i ruoli e rimuovi membri

Apri il team. In Membri, scegli un nuovo ruolo per un membro e conferma con Cambia ruolo: la modifica è immediata. Rimuovi toglie subito un membro dal team: perde l’accesso al team, alle sue chiavi e ai suoi movimenti. Il proprietario non può essere rimosso.

Rimuovere un membro non revoca le chiavi che ha creato o usato. Le chiavi del team appartengono al team, quindi revoca in Chiavi API qualsiasi chiave che quella persona ha ancora.

Esci da un team

Qualsiasi membro tranne il proprietario può uscire: apri il team, scegli Esci dal team e conferma. L’accesso termina subito, e solo un nuovo invito può farti rientrare.

Non viene eliminato nulla. Chiavi, attività e consumi del team restano al team e continuano a essere addebitati al suo proprietario. Se hai ancora una delle sue chiavi, chiedi a un amministratore di revocarla. Il tuo ambito personale non viene toccato.

Il proprietario non può semplicemente uscire, perché le chiavi del team continuerebbero a spendere il suo denaro senza nessuno in grado di gestirle. Prima trasferisci la proprietà. Se sei l’unico membro, invita qualcuno e cedigli il team.

Trasferisci la proprietà

Solo il proprietario può trasferire la proprietà, e solo a qualcuno che è già membro.

1. Apri il team e vai in Zona a rischio → Trasferisci la proprietà.
2. Scegli il Nuovo proprietario e inserisci la tua Password attuale. (Un account creato con Google o GitHub deve prima impostare una password in Impostazioni.)
3. Controlla e scegli Trasferisci il team.

Da quel momento:

• il saldo del nuovo proprietario paga ogni attività inviata con le chiavi del team, e tutte le chiavi del team passano all’account del nuovo proprietario;
• tu diventi Amministratore;
• le attività accettate prima del trasferimento mantengono la fatturazione originale e non vengono annullate.

Eliminare un team

Un team non si può eliminare. Un team inutilizzato non costa nulla e non compare mai in fattura. Rimuovi i membri e lascialo inattivo, oppure rinominalo e riutilizzalo invece di crearne un altro.

I limiti dei team in breve