Riferimento API
Fatturazione e saldo
Pagamento dal portafoglio, conguaglio per chiamata. I modelli a token sono fatturati per 1M di token di input e di output; i modelli di immagini / video / task sono fatturati per richiesta. Le richieste non riuscite vengono rimborsate automaticamente.
#Prezzo per token
I token di input e di output sono misurati separatamente. Il prezzo completo di ogni modello è nella scheda su /models; ogni richiesta completata mostra il suo consumo effettivo finale nel Registro delle richieste.
{
"usage": {
"prompt_tokens": 128,
"completion_tokens": 402,
"total_tokens": 530
}
}La quota viene pre-riservata all'inizio della richiesta (stima del caso peggiore basata su max_tokens), poi riconciliata con l'utilizzo riportato dal fornitore al termine della risposta — paghi sempre e solo l'utilizzo effettivo.
#Prezzo per richiesta
I modelli di immagini, video, TTS e gli altri modelli a task addebitano un prezzo fisso per ogni chiamata riuscita. Risoluzioni o durate diverse possono avere prezzi diversi — controlla sempre prima la scheda del modello.
#Fasce di prezzo
I modelli a richiesta possono avere più fasce sullo stesso modello: le fasce delle immagini dipendono da dimensione e qualità, quelle dei video da durata e risoluzione. La fascia viene determinata dai parametri della richiesta al momento dell'invio e il prezzo di ogni fascia è riportato nella scheda del modello.
Prezzi a fasce
#Rimborsi
La quota pre-addebitata viene restituita automaticamente quando una richiesta fallisce o un task asincrono non si conclude mai. Il Registro delle richieste mostra il consumo effettivo finale, quindi le chiamate fallite non appaiono come addebito e rimborso separati.
#Saldo e ricarica
#Il portafoglio
Tutto l'utilizzo viene addebitato su un unico portafoglio prepagato — non c'è fatturazione posticipata. Ogni chiave spende dallo stesso saldo, a meno che non abbia un proprio tetto di quota.
#Ricaricare
Ricarica da Console → Portafoglio. I canali di pagamento disponibili (carta / altri provider) e l'importo minimo di ricarica sono mostrati al checkout; lì puoi anche applicare i codici di riscatto, che vengono accreditati all'istante.
Il saldo non scade. Se un pagamento va a buon fine ma il saldo non cambia entro qualche minuto, apri un ticket di assistenza con il riferimento del pagamento.
Apri Portafoglio#Saldo in esaurimento
Quando il saldo non copre la stima pre-riservata di una richiesta, la chiamata fallisce subito con 402 insufficient_quota — non viene addebitato nulla. Ricarica e riprova; gli stream lunghi già in corso non vengono mai interrotti a metà risposta.
#Utilizzo e log
#Dashboard di utilizzo
Console → Utilizzo mostra in grafico token e spesa per modello e per giorno, suddivisi per chiave — il modo più rapido per capire quale progetto o modello sta facendo salire i costi.
Apri Utilizzo#Consumo effettivo
Console → Registro delle richieste è la fonte di verità per la spesa API rivolta ai clienti. Ogni riga contiene data e ora, modello, utilizzo di token o prezzo della chiamata, ID richiesta e l'importo finale effettivamente consumato.
Apri Utilizzo#ID richiesta
Ogni riga del registro delle richieste riporta l'identificativo della richiesta e l'ora. Quando apri un ticket di assistenza su una chiamata specifica, cita quella riga (ora, modello, ID richiesta) — così l'assistenza può risalire all'esatto tentativo upstream.
I prompt non vengono salvati
Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.