Home/Agenti
Prova gratuita API LLM: cosa testare nella prima ora

Una prova gratuita di un'API LLM è breve e limitata, quindi l'obiettivo è capire rapidamente se l'endpoint si adatta al tuo progetto. Questa checklist copre cosa testare nella prima ora e quanto arrivano a coprire $0,50 di credito.
Aggiornato
Punti chiave
- La prova costa $0,50, richiesta con un clic nella pagina della chiave API, valida 7 giorni, senza carta.
- Testa in questo ordine: elenco modelli, chat semplice, streaming, chiamate di funzioni, modalità JSON, limiti.
- Le chiavi di prova permettono 2 richieste parallele e 60 richieste al minuto.
- $0,50 copre circa 900 richieste con 2.000 token di input e 500 token di output.
Cosa ti offre la prova
I nuovi utenti possono richiedere $0,50 di credito di prova dopo la registrazione. Ti registri con Google o con email e password, apri la pagina della chiave API e premi un pulsante. Non serve inserire una carta, il credito è valido per 7 giorni e c'è una sola prova per persona.
L'API è compatibile con OpenAI, quindi tutto ciò che parla con l'SDK OpenAI funziona dopo aver cambiato l'URL di base e la chiave. L'ID del modello è sempre uncensored. È un unico modello a pesi aperti gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti di contenuti per uso adulto lecito, con una finestra di contesto da 100.000 token. Solo testo: nessuna immagine, audio, embedding o fine-tuning.
Sette giorni sono sufficienti se organizzi il lavoro, e la prova è utile solo se esegui effettivamente prompt reali. Non testare solo con "hello world"; usa il tipo di input che invierà il tuo prodotto, inclusi documenti lunghi, formattazioni strane e gli argomenti che interessano ai tuoi utenti. Trascorri la prima ora sui controlli seguenti, poi decidi se ricaricare da $20 o andare via.
Passo 1: crea la chiave ed elenca i modelli
Vai alla pagina della chiave API, crea una chiave e richiedi la prova. Memorizza la chiave in una variabile d'ambiente piuttosto che nel codice.
export API_KEY="sk-your-key"
curl -s https://api.uncensoredapis.com/v1/models \
-H "Authorization: Bearer $API_KEY"
Un elenco JSON che contiene uncensored dimostra tre cose in una volta: l'URL di base è corretto, la chiave è accettata e l'autorizzazione Bearer funziona. Se ottieni un 401, la chiave è errata o contiene spazi casuali. Il Riferimento API spiega i campi di risposta.
Passo 2: invia una richiesta di chat semplice
Prima di qualsiasi funzionalità avanzata, verifica il percorso base e leggi le intestazioni di risposta. Aggiungi -i a curl per vederle.
curl -i https://api.uncensoredapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Explain DNS in two sentences."}]
}'
Cerca X-Request-Id (citandolo se contatti mai il supporto), X-Balance-USD (il tuo credito residuo dopo la chiamata) e le due intestazioni X-RateLimit-Limit-*. Esegui la stessa richiesta due volte e guarda il saldo scendere di una piccola quantità. Questo conferma che la fatturazione funziona come ti aspetti. max_tokens è facoltativo, quindi non ti serve per questo test.
Passo 3: testa lo streaming
Se il tuo prodotto mostra il testo mentre viene digitato, lo streaming è la funzionalità da dimostrare presto. Imposta stream: true e leggi gli eventi inviati dal server.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredapis.com/v1", api_key="sk-your-key")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a four-line poem about servers."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
if getattr(chunk, "usage", None):
print("\nusage:", chunk.usage)
L'utilizzo arriva alla fine dello stream, che è dove leggi i conteggi dei token. Un dettaglio è importante per dopo: una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello stream, quindi un client che non chiude mai gli stream consumerà il tuo limite.
Passo 4: chiamate di funzioni e modalità JSON
Agenti e pipeline di dati dipendono da queste due funzionalità, quindi fai un test reale con il tuo schema, non uno di esempio.
Chiamata di funzioni
tools = [{
"type": "function",
"function": {
"name": "get_order_status",
"description": "Look up an order by its ID",
"parameters": {
"type": "object",
"properties": {"order_id": {"type": "string"}},
"required": ["order_id"],
},
},
}]
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Where is order A-1042?"}],
tools=tools,
)
print(resp.choices[0].message.tool_calls)
Verifica che gli argomenti vengano analizzati come JSON e corrispondano al tuo schema. Poi invia il risultato come messaggio con role: "tool" e conferma che il modello risponde di conseguenza. La pagina agent e chiamate di funzioni mostra il ciclo completo.
Modalità JSON
Passa response_format={"type": "json_object"} e scrivi la parola JSON nel prompt. Esegui dieci input variati e analizza ogni risposta con json.loads. Un errore su dieci ti dice di aggiungere validazione e un nuovo tentativo nel tuo codice.
Passo 5: raggiungi i limiti apposta
Una chiave di prova permette 2 richieste concorrenti e 60 richieste al minuto. Una chiave completa ottiene 8 e 300. Superi un limite e l'API restituisce HTTP 429, con il codice di errore rate_limited per le richieste al minuto o concurrency per troppi contemporaneamente. Anche un sovraccarico temporaneo restituisce un 429, con un'intestazione Retry-After: 5.
Invia cinque richieste in parallelo e assicurati che il tuo client effettui un backoff e riprovi invece di crashare. Questo è il bug più economico da trovare ora. Vedi errori e limiti di richieste per il pattern di retry. Le richieste fallite o rifiutate non vengono addebitate, quindi questi test costano quasi nulla.
Problemi comuni del trial e soluzioni
- 401 su ogni chiamata: la chiave ha uno spazio o una nuova riga di troppo, o l'intestazione non è
Authorization: Bearer .... Stampa la lunghezza dell'intestazione nel tuo codice per catturarla. - 404: l'URL di base manca di
/v1, oppure l'SDK aggiunge il percorso due volte. Usa l'URL di base esattamente come scritto in questo articolo. - 429 durante un test breve: le chiavi di prova permettono solo 2 richieste alla volta. Esegui i test in sequenza, o aggiungi un piccolo semaforo intorno alle tue chiamate.
- Saldo non aggiornato: leggi
X-Balance-USDdalla risposta grezza, non da un valore memorizzato nella cache. Ogni chiamata costa una frazione di centesimo, quindi confronta a quattro cifre decimali. - Risposte troncate: controlla
finish_reason. Se dicelength, hai impostato unmax_tokensbasso. L'impostazione è facoltativa e il completamento può usare il resto della finestra di contesto di 100.000 token.
Tieni un breve registro di cosa hai eseguito e cosa hai visto. Dopo l'ora, dovresti essere in grado di rispondere sì o no a tre domande: l'API si comporta come OpenAI dove il mio codice ne ha bisogno, il modello risponde ai miei tipi di prompt senza rifiuti, e il costo per attività si adatta al mio budget? Se tutte e tre sono sì, ricarica. Se no, non hai perso nulla tranne pochi centesimi di credito di prova.
Fino a dove arrivano $0,50
I prezzi sono $0,15 per 1M token di input e $0,50 per 1M token di output. Tre carichi di lavoro di esempio:
| Richiesta | Costo per chiamata | Chiamate da $0,50 |
|---|---|---|
| 1.000 input, 500 output | $0,00015 + $0,00025 = $0,0004 | 1.250 |
| 2.000 input, 500 output | $0,0003 + $0,00025 = $0,00055 | circa 909 |
| 50.000 input, 1.000 output | $0,0075 + $0,0005 = $0,008 | 62 |
Quindi la prova copre facilmente un test completo delle funzionalità, alcune decine di esecuzioni a lungo contesto o una piccola valutazione in batch. Non coprirà i test di carico. Se vuoi verificare il comportamento sui tuoi prompt reali in volume, l'importo minimo di ricarica è $20 e il credito non scade mai. I dettagli sono nella pagina dei prezzi.
Altre guide
Domande e risposte
Serve una carta per ottenere la prova?
No. Iscriviti con Google o email e password, poi richiedi i $0,50 con un clic nella pagina della chiave API.
Cosa succede dopo 7 giorni?
Il credito di prova non utilizzato scade. Il tuo account rimane attivo e puoi ricaricare qualsiasi importo intero da $20 a $500 per continuare.
Posso richiedere la prova più volte?
No, è uno per persona.
Una richiesta fallita consuma il credito di prova?
No. Le richieste fallite o rifiutate non vengono addebitate.
La tua chiave è a un modulo web di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.