Come usare un'API compatibile con OpenAI in 5 passi
Usare un'API in stile OpenAI richiede cinque mosse: ottieni una chiave, installa un SDK, puntalo al base URL corretto, specifica un modello e invia messaggi. Ecco ciascuno con il codice da incollare.

Punti chiave
- Qualsiasi SDK OpenAI funziona qui una volta modificato il base URL in https://api.uncensoredaiapis.com/v1 e usato la tua chiave.
- L'ID del modello è uncensored; gli endpoint principali sono POST /v1/chat/completions e GET /v1/models.
- Streaming, modalità JSON e chiamata di funzioni usano gli stessi parametri dell'API ufficiale.
- I prezzi sono $0,15 per 1M di token di input e $0,50 per 1M di token di output, e puoi iniziare con $0,50 di credito di prova.
La versione breve
Se vuoi sapere come usare le chiamate API OpenAI con un servizio che non è OpenAI, la risposta è che il formato di richiesta è una convenzione condivisa. Un client che lo supporta ha bisogno di tre valori: dove inviare le richieste (l'URL di base), chi sei (la chiave) e quale modello eseguire. Modificando questi tre valori, lo stesso codice funziona. Questo sito segue quella convenzione, quindi i pacchetti Python e Node.js standard di OpenAI e curl standard funzionano tutti contro di esso.
Sii chiaro su cosa significhi e cosa non significhi. Compatibile significa che l'interfaccia corrisponde. Non significa che questo è il servizio ufficiale OpenAI o che esegue modelli OpenAI. Il backend è un modello a pesi aperti, gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, e lo selezioni con l'ID del modello uncensored. Gestisce solo testo: nessuna immagine, audio, embedding o fine-tuning.
I cinque passi seguenti richiedono circa dieci minuti. Se preferisci leggere snippet finiti in diverse lingue, vedi la pagina degli esempi di codice.
Fase 1: ottieni una chiave
Registrati con Google, o con email e password, e apri la pagina della chiave API. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic. È valido per 7 giorni, limitato a uno per persona e non richiede carta. Copia la chiave e salvala come variabile d'ambiente invece di incollarla nel codice:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"La chiave di prova è limitata a 2 richieste concorrenti e 60 richieste al minuto. Una chiave finanziata permette 8 concorrenti e 300 al minuto. I dettagli di cosa include la prova sono nella FAQ sulla prova gratuita.
Passo 2: installa un SDK e invia la prima richiesta
Installa il pacchetto ufficiale per il tuo linguaggio. Entrambi sono le stesse librerie che useresti per qualsiasi servizio compatibile con OpenAI:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiEcco una prima chiamata in Python. L'unica differenza rispetto alla configurazione predefinita è l'argomento base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)E la stessa chiamata in Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Passo 3: capisci l'array messages
I modelli di chat non ricordano nulla tra le chiamate. Ogni richiesta trasporta l'intera conversazione come un elenco di messaggi, e ogni messaggio ha un ruolo.
systemimposta comportamento e stile. Inserisci qui la persona, le regole di formato e i vincoli.usercontiene ciò che ha chiesto la persona.assistantcontiene le risposte precedenti del modello. Le aggiungi tu stesso quando continui una conversazione.tooltrasporta il risultato di una chiamata di funzione, trattato di seguito.
Per continuare una chat, aggiungi la risposta dell'assistant e il prossimo messaggio utente alla stessa lista e invia tutto di nuovo. Ecco perché le conversazioni lunghe costano di più: ogni chiamata paga per l'intera cronologia come input tokens. La finestra di contesto contiene 100.000 token in totale, prompt e completion insieme, quindi ridurre i turni vecchi è una parte normale della creazione di un'app chat.
I campi di campionamento utili sono trasmessi: temperature, top_p, stop, seed e le penalità di frequenza e presenza. max_tokens è opzionale. Impostalo quando vuoi limitare la lunghezza della risposta e la spesa.
Passo 4: streaming, modalità JSON e strumenti
Streaming
Aggiungi stream: true per ricevere i token come Server-Sent Events. Rende le interfacce più veloci, poiché il testo appare mentre il modello sta ancora scrivendo, e l'utilizzo viene segnalato alla fine dello streaming.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Modalità JSON
Usa response_format: {"type": "json_object"} quando il tuo codice analizza la risposta. Descrivi anche le chiavi desiderate nel prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Chiamata di funzioni
Passa un elenco tools con gli schemi delle funzioni, e opzionalmente tool_choice. Quando il modello vuole eseguire una funzione, la risposta contiene tool_calls. Esegui la funzione nel tuo codice e invia di nuovo l'output come messaggio con ruolo tool. Anche le chiamate di funzioni fanno streaming. Questo è il blocco costruttivo per gli agenti; la pagina dei casi d'uso mostra dove questo conviene.
Passo 5: conosci limiti, costi ed errori
Superato un limite, l'API restituisce HTTP 429. Il codice di errore è rate_limited per troppe richieste al minuto e concurrency per troppe contemporaneamente. Un sovraccarico temporaneo dà anche un 429, con un'intestazione Retry-After: 5. Una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello streaming, quindi chiudi gli streaming che non leggi più. Il limite del corpo è 8 MB. Ogni risposta trasporta le intestazioni X-Request-Id e X-Balance-USD, e la prima è quella che citi per il supporto.
I costi sono semplici. Una chiamata chat con 3.000 input tokens e 700 output tokens costa 3.000 volte $0,15 per milione, ovvero $0,00045, più 700 volte $0,50 per milione, ovvero $0,00035, per un totale di $0,0008. Un migliaio di tali chiamate costano $0,80. Le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. La pagina prezzi elenca le ricariche da $20 a $500 con +5% da $50, +10% da $100 e +15% da $200. Puoi pagare con cripto (USDT su TRC20, USDC su Base).
Come questo si differenzia dall'API ufficiale
Tre differenze vale la pena pianificare. Primo, il nome del modello: usa uncensored, non un nome di modello OpenAI. Secondo, l'ambito: ottieni solo chat completions e l'elenco dei modelli, quindi funzionalità come generazione di immagini, speech, embeddings e fine-tuning non sono presenti. Terzo, il comportamento: il modello è ottimizzato per non rifiutare richieste adulte legali, quindi l'output può differire da un assistant fortemente filtrato. Una regola non cambia mai: nessun contenuto sessuale che coinvolga i minorenni.
Alcune abitudini aiutano dal primo giorno. Tieni la chiave in una variabile d'ambiente, registra lo X-Request-Id di ogni chiamata e imposta max_tokens mentre sperimenti così una risposta incontrollata non può spendere più di quanto pianificato. Quando crei un'interfaccia chat, streamma la risposta e riduci i turni vecchi una volta che la cronologia cresce. Quando crei una pipeline che analizza l'output, usa la modalità JSON e controlla comunque l'analisi, perché una risposta tagliata al limite dei token non è JSON valido. E quando due parti del tuo programma chiamano l'API contemporaneamente, contale contro le 8 richieste concorrenti che una chiave completa permette.
Non dimenticare il costo dei test. Alcune decine di esperimenti con prompt brevi costano molto meno di un centesimo in totale, quindi il credito di prova di $0,50 dura a lungo mentre impari il formato della richiesta.
Se stai spostando un'app esistente, la guida alla migrazione passa attraverso le modifiche in ordine. I prompt inviati qui non sono usati per l'addestramento. Per la maggior parte delle app la migrazione è i tre valori dall'inizio di questa pagina e un nome del modello.
Altre guide
Domande e risposte
Ho bisogno dell'SDK ufficiale OpenAI?
Puoi usarlo ed è la strada più semplice. Funziona anche qualsiasi client compatibile con OpenAI o HTTP puro, purché supporti un base URL personalizzato.
Quale nome di modello invio?
Invia uncensored. Il base URL è https://api.uncensoredaiapis.com/v1.
È l'API ufficiale di OpenAI?
No. Segue lo stesso formato di richiesta, ma il modello è un modello a pesi aperti gestito da un provider indipendente e il servizio è separato da OpenAI.
Quanto costa una richiesta?
Gli input tokens costano $0,15 per 1M e gli output tokens $0,50 per 1M. Una richiesta con 3.000 input e 700 output tokens costa circa $0,0008.
Posso provarlo prima di pagare?
Sì. Dopo la registrazione puoi richiedere $0,50 di credito di prova con un clic. È valido per 7 giorni e non richiede carta.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.