Quando qualcosa va storto
FAQ e assistenza
#Domande frequenti
Quale modello dovrei usare?
Inizia con il modello consigliato in ogni pagina delle funzionalità: è il migliore per qualità/prezzo tra i modelli online oggi. Modelli e prezzi elenca ogni modello con il suo prezzo in tempo reale, e per cambiare basta un campo nella richiesta.
Il gateway supporta la chiamata di strumenti / di funzioni?
Sì, per ogni modello in formato OpenAI oltre a Claude e Gemini. Invia l'array tools standard; il gateway lo inoltra e restituisce tool_calls nella risposta. Sono supportati i delta delle chiamate di strumenti in streaming.
Posso usarlo in Cursor, Cherry Studio o altre app?
Sì. Apri “Usalo in un'app” nella sezione Inizia, scegli la tua app e copia le impostazioni — l'indirizzo, la tua chiave e il nome di un modello. Nessun codice necessario.
Come viene scalata la quota?
Pre-riservata all'inizio della richiesta (stima del caso peggiore per i modelli a token, prezzo di listino per i modelli a task), poi riconciliata con l'utilizzo effettivo riportato dal fornitore al termine della risposta. Se la richiesta fallisce, la riserva viene rimborsata automaticamente.
Cosa faccio se ricevo 401 o 402?
401 significa che il bearer token è errato o che la chiave è stata eliminata / disattivata. 402 significa che il saldo del portafoglio non copre la stima pre-riservata — ricarica e riprova. Nessuno dei due è un bug del modello.
Posso usare allo stesso modo la generazione di immagini / video / musica?
La generazione di immagini usa il flusso asincrono /v1/images/tasks. I video usano POST /v1/videos e la musica POST /v1/music/generations. Tutte le route dei task asincroni supportano invio → polling → contenuto e possono facoltativamente inviare un webhook quando il task raggiunge uno stato finale.
I miei prompt vengono registrati?
Chiamate chat: solo quando una chiamata fallisce conserviamo una copia ridotta della richiesta e della risposta (15 giorni, per analizzare l'errore), a meno che tu non attivi “Registra il contenuto delle richieste” su una chiave. Le richieste di immagini, video e musica conservano una copia ridotta per 15 giorni. I metadati (modello, token, costo, ora, ID richiesta) vengono conservati 30 giorni. Solo il nostro team operativo può vederli.
Per quanto tempo vengono conservati i miei dati?
I movimenti — ogni ricarica, addebito e rimborso — vengono conservati per sempre. La pagina Fatturazione mostra gli ultimi 90 giorni; Esporta CSV li scarica tutti. I record delle richieste nella pagina Utilizzo e i task di immagini, video e musica vengono conservati 30 giorni; i totali giornalieri restano anche dopo, ma un task più vecchio di 30 giorni non può più essere consultato.
Posso limitare la frequenza o l'ambito di una chiave per progetto?
Sì. Ogni chiave può avere i propri RPM, RPD, limite di quota, lista dei modelli consentiti, lista di IP consentiti e gruppo. Modifica qualsiasi cosa da Console → Chiavi API senza toccare il codice.
#Assistenza
Qualcosa non funziona, o vuoi che aggiungiamo un modello? Ci sono due modi per contattarci.
Apri un ticket di assistenza
Ideale per problemi di account, fatturazione o di produzione riservati. Tracciato, con risposta entro un giorno lavorativo.
Apri Assistenza
Controlla la pagina di stato
Stato del gateway in tempo reale, incidenti e degradi dei fornitori. Controlla qui prima di aprire un ticket.
Apri la pagina di stato
Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.