Stato · health check e incidenti

L'API LLMwithCrypto funziona?

Qui non c'è un numero di stato di cui fidarsi; c'è un controllo che puoi eseguire tu stesso in un secondo. Questa pagina lo mostra, spiega quali errori sono nostri e quali tuoi, e come un'app dovrebbe reagire a ciascuno.

Ultimo aggiornamento: 23 ottobre 2026 · 3 min di lettura

Risposta rapida

Come faccio a verificare che LLMwithCrypto funzioni?

Chiama GET https://llmwithcrypto.com/api/v1/credits con la tua chiave. Non genera token, quindi non costa nulla, e una normale risposta JSON dimostra che l'API LLMwithCrypto, la tua chiave e il tuo account funzionano. Poi invia una breve chat completion al modello che usi, che costa una frazione di centesimo sulla maggior parte dei modelli ai nostri prezzi del 23 ottobre 2026. Gli errori del server non vengono mai addebitati, e gli incidenti sono datati nel changelog.

Qual è il controllo di stato più rapido?

Due chiamate, in questo ordine:

GET https://llmwithcrypto.com/api/v1/credits — risponde solo dalla nostra parte: autenticazione, l'API e il tuo account. Una risposta con i crediti che ti restano significa che il servizio è attivo per te.
GET https://llmwithcrypto.com/api/v1/models — elenca i modelli che la tua chiave può chiamare. Se manca il modello che usi, scegline un altro dalla pagina dei modelli mentre l'assistenza ci guarda.

Se una delle due restituisce 401, la chiave è sbagliata o revocata: creane una nuova nella dashboard.

curl: crediti rimasti e l'elenco dei modelli (nessun token consumato)

curl -s https://llmwithcrypto.com/api/v1/credits \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"

curl -s https://llmwithcrypto.com/api/v1/models \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"

Python: un controllo da un token sul modello su cui conti

import os
import sys

from openai import OpenAI

client = OpenAI(base_url="https://llmwithcrypto.com/api/v1", api_key=os.environ["LLMWITHCRYPTO_API_KEY"])
try:
    client.chat.completions.create(
        model="gpt-oss-20b",
        messages=[{"role": "user", "content": "ping"}],
        max_tokens=1,
    )
except Exception as exc:
    print("model check failed:", exc)
    sys.exit(1)
print("model answers")

Come distinguo un nostro errore da uno della mia richiesta?

Dalla famiglia del codice di stato, come con l'API di OpenAI:

4xx — qualcosa nella richiesta o nell'account: una chiave sbagliata, crediti esauriti, un id di modello sconosciuto, un parametro che il modello non accetta o troppe richieste al minuto. Correggi la richiesta; riprovare la stessa fallirà di nuovo, tranne per i rate limit.
5xx — la nostra parte o il server del modello. Paghi per token dal tuo saldo: i token di input e di output vengono contati dal tokenizer del modello stesso e addebitati al prezzo di quel modello per 1M di token. Una chiamata che termina con un errore non costa nulla.

La pagina degli errori elenca ogni codice con il suo significato.

Cosa deve fare la mia app quando una chiamata fallisce?

Rate limit: aspetta e riprova con un ritardo crescente. Ogni account ha un limite di richieste e di token al minuto, mostrato nella dashboard; chiedi al supporto e può essere alzato.
Errore del server o timeout: riprova una o due volte con backoff; se lo stesso modello continua a fallire, passa a un altro modello con un profilo simile, dato che una sola chiave li chiama tutti.
Crediti esauriti: ricarica e acquista un pack; le chiamate riprendono appena i crediti sono sull'account.
Errore di autenticazione: controlla la chiave nella tua variabile d'ambiente prima di ogni altra cosa.

Dove vengono registrati gli incidenti?

Nel changelog, con la data, i modelli coinvolti e cosa è stato fatto. Anche i prezzi e i modelli aggiunti o rimossi finiscono lì. Per un incidente che riguarda solo il tuo account, scrivi a [email protected] con l'orario in UTC e l'id della richiesta se ce l'hai.

Domande sullo stato

Controllare i miei crediti è gratis?

Sì. Non esegue nessun modello e non usa token.

Una chiamata fallita mi viene addebitata?

No, quando il guasto è nostro. Paghi per token dal tuo saldo: i token di input e di output vengono contati dal tokenizer del modello stesso e addebitati al prezzo di quel modello per 1M di token. Una chiamata che termina con un errore non costa nulla.

Pubblicate una percentuale di uptime?

No. Non pubblichiamo cifre che non possiamo mostrarti; gli incidenti sono datati nel changelog.