Search docs

Search the TryOnCloud API docs

Riferimento API

Controlla i crediti

GET /api/v1/credits: numero di prove rimanenti sul tuo account.

Gli esempi di codice, gli endpoint e i codici di errore sono gli stessi in ogni linguaggio.

GET https://www.tryoncloud.com/api/v1/credits

Restituisce il numero di prove che il tuo account può ancora effettuare, attingendo dallo stesso pool da cui attinge il metodo POST /generate.

Richiesta

bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Risposta

json
{
  "credits_remaining": 4870,
  "purchased_remaining": 4870,
  "purchased_total": 5000,
  "free_remaining": 0,
  "spends_from": "purchased"
}
CampoSignificato
credits_remainingProva subito queste opzioni. Usa questa
purchased_remainingCrediti acquistati rimanenti (non scadono mai)
purchased_totalTutti i crediti acquistati in passato
free_remainingCredito gratuito residuo (utilizzabile solo prima del primo acquisto)
spends_frompurchased una volta acquistati i crediti, altrimenti free_allowance

Consigli

  • Controlla prima di eseguire un’elaborazione su larga scala e imposta un avviso quando credits_remaining scende al di sotto di pochi giorni di utilizzo.
  • Limite di richieste: 60 richieste al minuto per chiave. Non effettuare la chiamata prima di ogni prova; un codice di errore 402 da /generate ti avvisa già quando hai esaurito il limite.
  • Acquista crediti dalla pagina "Fatturazione" della dashboard.

Errori

HTTPcodiceSignificato
401NO_KEY, INVALID_KEYChiave mancante o errata
429RATE_LIMITEDOltre 60 richieste al minuto
500CREDITS_UNAVAILABLEProblema temporaneo, riprova