Felo API PlatformFelo API Platform

Domande frequenti

Fatturazione e crediti

Come vengono addebitati i crediti di servizio, quando ricaricare e cosa significa una risposta 402.

L'utilizzo delle API su Felo API Platform è prepagato. Acquisti crediti di servizio in USD e ogni richiesta viene detratta da quel saldo alla tariffa applicabile.

Come funziona la fatturazione

  • Una ricarica acquista crediti di servizio, non un saldo di denaro detenuto dalla piattaforma.
  • I crediti sono espressi in USD, così gli addebiti possono essere indicati in dollari.
  • Le ricariche partono da 1 $. Non è richiesto alcun abbonamento.
  • I crediti servono solo a coprire gli addebiti delle API della piattaforma. Non possono essere prelevati né convertiti in denaro.
  • Le ricariche completate non sono rimborsabili, compresi i crediti non utilizzati, salvo quanto richiesto dalla legge applicabile.

Lo stesso saldo di crediti paga le chiamate ai modelli, le chiamate alla Data API e le chiamate alle Felo API. Non serve un account o un saldo separato per ogni fornitore.

Quanto costa una richiesta

L'addebito dipende dall'endpoint:

SuperficieBase di fatturazione
Model APITariffe per token di input, output e caching, più eventuali strumenti fatturabili; si applica il moltiplicatore di sconto del canale
Data APILa base di fatturazione pubblicata per quell'endpoint, che può essere per richiesta riuscita, per elemento restituito o basata sull'utilizzo effettivo
Felo API (/v2)La tariffa per l'output di quel workflow

I prezzi dei modelli sono mostrati per 1M di token nella pagina dei prezzi e in ogni pagina di modello. Vedi Modelli e prezzi per la formula e un esempio di calcolo.

Controllare il saldo e ricaricare

Apri Console Billing. La console mostra il saldo attuale dei crediti, gli importi delle ricariche e i record di utilizzo. I metodi di pagamento disponibili dipendono dalla tua regione e sono mostrati al checkout.

La risposta 402

Un 402 indica che il saldo non copre la chiamata:

{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}

Cosa fare:

  1. Controlla il saldo in Console Billing.
  2. Ricarica.
  3. Invia di nuovo la richiesta. Un 402 non è un rate limit, quindi attendere non lo risolve.

Per un'attività asincrona, un 402 all'invio significa che l'attività non è mai stata creata. Controlla l'endpoint di stato dell'attività prima di inviare di nuovo.

Fatturazione e rate limit

Sono limiti diversi:

  • I crediti limitano quanto puoi spendere. Quando finiscono, ricevi un 402.
  • I rate limit limitano la velocità con cui puoi chiamare. Se li superi, ricevi un 429.

Vedi Errori, limiti e retry per gli header del 429 e le regole di retry.

Abbonamenti e crediti

L'utilizzo delle API è sempre pagato con i crediti di servizio. L'unico comportamento legato agli abbonamenti descritto in questa documentazione è l'esenzione dai rate limit di /v2/chat per gli account con un abbonamento Felo a pagamento attivo; non sostituisce i crediti di servizio.

Domande sulla fatturazione

Per un addebito contestato o una ricarica non arrivata, contatta il supporto indicando:

  • L'email dell'account
  • L'ora approssimativa dell'addebito
  • Il request_id di qualsiasi errore correlato
  • L'importo della ricarica e il riferimento di pagamento

Non inviare mai la chiave API completa.

Correlati