Tester chiave API AI: verifica una chiave in 30 secondi

Perché testare localmente invece che su una pagina web

Cercare un tester per chiavi API AI restituisce molte pagine in cui incollare una chiave e premere un pulsante. Evitale. Una chiave è una password che consuma il tuo credito e non sai cosa facciano quelle pagine con essa. I test seguenti richiedono mezzo minuto, girano sulla tua macchina e inviano la chiave solo all'API che vuoi usare.

Ti servono tre cose: la chiave, l'URL di base https://api.getaiapikey.com/v1 e l'ID del modello uncensored. Inserisci la chiave in una variabile d'ambiente così non finisce nella cronologia del tuo shell o in un file che potresti committare.

Copyexport API_KEY="paste-your-key-here"

Le chiavi provengono dalla pagina chiave API. Se non ne hai ancora una, i nuovi utenti possono richiedere $0,50 di credito di prova lì con un solo clic dopo la registrazione, che è più che sufficiente per ogni test in questo articolo molte volte.

Controllo 1: elenca i modelli con curl

Il test più economico è l'elenco dei modelli. Serve una chiave valida e un base URL corretto, e non genera alcun testo.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Il flag -i stampa le intestazioni della risposta. Una risposta valida inizia con HTTP/2 200 e un corpo JSON che include l'ID del modello uncensored. Se invece vedi un errore di autenticazione, solitamente status 401, la chiave è errata, è stata copiata con uno spazio finale o manca la parola Bearer nell'intestazione. Un 404 significa che l'URL è sbagliato, spesso per un /v1 mancante o duplicato.

Controllo 2: esegui un vero completamento

Una chiave può essere valida e comunque fallire su una richiesta reale, ad esempio perché il saldo è vuoto. Invia quindi una piccola chiamata chat e limita l'output per mantenere il costo vicino allo zero:

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

Leggi le intestazioni prima del corpo. X-Request-Id identifica la chiamata, che è ciò che chiede il supporto. X-Balance-USD mostra quanto credito rimane. X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency rivelano i limiti della tua chiave: 300 e 8 per una chiave completa, 60 e 2 per una chiave di prova. Questa singola chiamata verifica quindi l'autenticazione, il modello, il saldo e il tipo di chiave.

Il prezzo del test è trascurabile. Un prompt di circa 10 token e una risposta di 5 token costano 10 x $0,15 / 1M + 5 x $0,50 / 1M, che è circa $0,000004. Le richieste fallite o rifiutate non vengono addebitate affatto.

Controllo 3: lo stesso test in Python

Se il tuo codice effettivo usa Python, testalo nel modo in cui verrà eseguito. Questo script usa il pacchetto ufficiale openai, quindi un passaggio positivo significa che funziona anche la configurazione della tua applicazione:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

Il wrapper with_raw_response dà accesso alle intestazioni mentre parse() restituisce l'oggetto di risposta abituale. La configurazione del client Python è trattata in come installare un client LLM in Python se l'import fallisce.

Controlla il tuo saldo senza generare testo

Per leggere il saldo senza generare testo, chiama uno degli endpoint di saldo. Ce n'è uno in stile OpenAI e uno breve:

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

Gli strumenti che si aspettano già il formato con crediti OpenAI possono usare il secondo percorso senza modifiche. Aggiungi una chiamata del genere a uno script di monitoraggio e ricevi un avviso prima che un bot di produzione rimanga senza fondi. Le ricariche partono da 20 $ e il credito non scade mai, quindi non ci sono penalità nel mantenere una riserva comoda. Importi e bonus sono nella pagina dei prezzi.

Trasforma il test in un controllo di integrità

Una volta che la chiave funziona, conserva il test. Un piccolo script che viene eseguito su un programma orario ti avvisa di un deploy difettoso, di un segreto scaduto o di un saldo basso prima che lo facciano i tuoi utenti. Ecco una versione Node che usa fetch integrato (Node 18 o successivo):

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

Lo script esce con un codice non nullo quando la chiamata fallisce o il saldo scende sotto $5, così un lavoro cron o un passaggio CI possono avvisarti. Scegli la soglia dal tuo tasso di consumo: a $2 al giorno, $5 ti danno poco più di due giorni di preavviso.

Cosa non dimostra un test superato

Una spunta verde mostra che autenticazione, instradamento e modello funzionano in quel momento, a basso carico. Non mostra come si comporta la tua applicazione con 20 utenti contemporaneamente. Per quello, ricorda i limiti: una chiave completa gestisce 8 richieste parallele e le richieste in streaming mantengono il loro slot fino alla fine dello streaming. Fai un test di carico del tuo codice con un limite alle chiamate parallele prima del lancio.

Lettura dei fallimenti

Quello che vedi	Motivo più probabile	Cosa fare
Errore di autenticazione, spesso 401	Chiave sbagliata, spazi bianchi extra, prefisso Bearer mancante	Ricopia la chiave, controlla la stringa dell'intestazione
404 o HTML invece di JSON	URL di base errato	Usa esattamente https://api.getaiapikey.com/v1
Modello non trovato	ID del modello diverso nella richiesta	Imposta model su uncensored
429 con rate_limited o concurrency	Troppe richieste al minuto o contemporaneamente	Attendi, poi riprova con un ritardo
429 con Retry-After: 5	Sovraccarico temporaneo	Attendi 5 secondi e ritenta
Errore di connessione o timeout	Rete, proxy o firewall	Testa da un'altra rete, controlla le variabili proxy

Le richieste superiori a 8 MB vengono rifiutate, quindi se falliscono solo chiamate grandi, controlla la dimensione del corpo. La documentazione elenca tutti i codici di errore e le intestazioni.

Buone abitudini per gestire una chiave

• Tieni la chiave in una variabile d'ambiente o in un archivio segreti, mai nel codice client-side, in un repository pubblico o in uno screenshot.
• Usa una chiave per applicazione dove puoi, così una fuga è facile da tracciare e sostituire.
• Se una chiave potrebbe essere stata compromessa, sostituiscila, poi controlla il saldo per spese inaspettate.
• Non condividere una chiave trial tra più programmi: con 2 richieste concorrenti raggiungerà i limiti rapidamente.

Se vuoi solo vedere se esiste un'opzione gratuita prima di registrarti, l'articolo su una chiave API LLM gratuita spiega cosa è disponibile. Altrimenti, i tre controlli sopra sono tutto ciò di cui una chiave ha bisogno per essere testata.

Altre guide

• Prezzi delle chiavi API AI: quanto costa davvero una chiave
• Checklist API AI