Endpoint compatibili con OpenAI: cosa è supportato
Un elenco degli endpoint API compatibili con OpenAI supportati da questo servizio, con richieste funzionanti per ciascuno e un elenco chiaro di ciò che manca.
Punti chiave
- Cinque percorsi: chat completions, responses, modelli e due percorsi per il saldo.
- L'ID del modello è uncensored e una chiave funziona con qualsiasi SDK OpenAI.
- Nessuna immagine, audio, video, embeddings o fine-tuning.
- I limiti restituiscono HTTP 429 con un codice di errore chiaro.

Gli endpoint in breve
Quali percorsi in stile OpenAI implementa davvero un provider? Ecco l'elenco breve per questa API. URL di base: https://api.uncensoredendpoint.com/v1. L'autenticazione richiede una chiave bearer in ogni chiamata.
| Metodo e percorso | Scopo |
|---|---|
POST /v1/chat/completions | Richieste chat, streaming, strumenti, modalità JSON |
POST /v1/responses | Il formato di richiesta Responses più recente |
GET /v1/models | Elenca il modello; l'ID è uncensored |
GET /v1/dashboard/billing/credit_grants | Saldo nella struttura in stile OpenAI |
GET /v1/balance | Saldo in forma semplice |
Questa è l'intera superficie. Tutto ciò che non è nella tabella non è offerto. Continua a leggere per esempi di richieste funzionanti e un elenco di ciò che manca, così da pianificare di conseguenza prima di scrivere il codice.
Completamenti conversazionali
Questo è l'endpoint che la maggior parte dei client utilizza. Indirizza qualsiasi SDK OpenAI all'URL di base e usa il nome del modello uncensored.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)I parametri supportati includono stream, tools, tool_choice, response_format con json_object, e il set di campionamento: temperature, top_p, stop, seed e le penalità. max_tokens è opzionale, perché un completamento può utilizzare tutto ciò che rimane della finestra di 100.000 token.
Con stream: true la risposta arriva come eventi SSE e l'utilizzo è incluso alla fine, così puoi comunque registrare i conteggi dei token.
Chat multi-turno
L'API non mantiene lo stato della conversazione. Per una chat multi-turno invii l'elenco completo dei messaggi ogni volta: messaggio di sistema per primo, poi turni alternati di utente e assistente. Questo significa che i token di input crescono ad ogni turno, e con essi il costo, quindi taglia o riassumi i turni vecchi quando una conversazione diventa lunga. La finestra è di 100.000 token per prompt più completamento, che è più che sufficiente per la maggior parte delle chat ma facile da riempire con documenti incollati.
Risposte, modelli e saldo
Risposte
I nuovi esempi OpenAI usano /v1/responses. È disponibile anche qui, quindi il codice scritto per quel formato non necessita di essere riscritto.
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'Usa quello che il tuo client si aspetta. Se parti da zero, i completamenti chat hanno il supporto per gli strumenti più ampio.
Modelli e saldo
Elenca i modelli per verificare che la tua chiave funzioni. Dovresti vedere una singola voce, uncensored, perché il servizio esegue un solo modello e non è un router verso fornitori.
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"Ottieni anche il saldo in ogni risposta nell'intestazione X-Balance-USD, utile per un avviso di credito basso nella tua app senza una richiesta extra. Altre intestazioni includono X-Request-Id per le segnalazioni di supporto, oltre a X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency.
Strumenti e modalità JSON in pratica
Due funzionalità trasformano un endpoint chat in qualcosa su cui puoi costruire un prodotto. La chiamata di funzioni permette al modello di chiedere al tuo codice di eseguire una funzione. La modalità JSON lo fa restituire output analizzabile. Entrambi usano i campi di richiesta standard.
Una chiamata a uno strumento appare così. Il modello restituisce una voce tool_calls, esegui la funzione e invii il risultato indietro come messaggio con role: "tool".
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)Per la modalità JSON, aggiungi response_format={"type": "json_object"} e indica nel prompt che vuoi JSON, idealmente con le chiavi che ti aspetti. Analizza sempre dentro un blocco try: nessun modello garantisce il tuo schema in ogni chiamata, quindi valida il risultato prima di fidarti.
Spostamento di un progetto OpenAI esistente
Se la tua app usa già un SDK OpenAI, la migrazione richiede tre modifiche e nessuna nuova libreria. La maggior parte degli SDK legge le stesse due variabili d'ambiente, quindi spesso puoi non modificare nulla nel codice.
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);Poi cerca nel tuo codice i nomi dei modelli come un ID modello GPT e sostituiscili con uncensored, perché il servizio ha un solo modello. Rimuovi le chiamate a embeddings, immagini o audio e instradale a un altro provider. Tieni una breve lista di controllo: URL di base modificato, nome del modello modificato, chiave memorizzata in una variabile d'ambiente e non nel repository, logica di retry per 429 e un avviso di saldo basso basato sull'intestazione del saldo. Per la configurazione della chiave, vedi come ottenere una chiave API AI senza censura. Poi esegui una singola richiesta di test e controlla che X-Balance-USD venga restituito, prima di passare il traffico reale.
Cosa non è offerto
Conoscere le lacunce ti fa risparmiare un giorno di debug. Questa API è solo per il testo. Questi endpoint OpenAI non sono disponibili:
- Generazione di immagini e visione. Nessuna generazione o modifica di immagini.
- Audio. Nessun riconoscimento vocale o sintesi vocale.
- Video. Non offerto.
- Embeddings. Se costruisci un sistema di retrieval, hai bisogno di un servizio di embedding separato.
- Fine-tuning. Non puoi addestrare sul servizio.
Le chiamate a questi percorsi falliranno, quindi tienili fuori da qualsiasi configurazione client condivisa. Un'impostazione tipica accoppia questa API per la chat con un altro provider per gli embedding, e la tua app sceglie l'URL di base per attività.
Limiti, errori e retry
Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto. Una chiave trial permette 2 concorrenti e 60 al minuto. Il corpo massimo è 8 MB. Quando superi un limite ottieni HTTP 429 con un codice di errore che indica quale: rate_limited per le richieste al minuto, concurrency per troppe richieste contemporaneamente. In caso di sovraccarico temporaneo ottieni anche 429, con un'intestazione Retry-After: 5.
Un dettaglio coglie di sorpresa: una richiesta in streaming mantiene la sua slot di concorrenza fino alla fine dello stream, quindi i lettori lenti contano contro il limite. Un semplice wrapper di retry gestisce tutto questo:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")Le richieste fallite o rifiutate non vengono addebitate, quindi i retry per gli errori costano nulla in più. Per i lavori batch, limita il tuo pool di worker a 8 su una chiave completa, o 2 su una chiave trial, invece di affidarti ai retry. Un pool fisso è più semplice da ragionare e mantiene uno stream lento da non affamare gli altri.
Costo e accesso
La tariffa è $0,15 per 1M token di input e $0,50 per 1M token di output, da credito prepagato senza abbonamento e senza scadenza. Ricarica con qualsiasi importo intero da $20 a $500, con cripto (USDT su TRC20, USDC su Base). Ricariche più grandi aggiungono un bonus: +5% da $50, +10% da $100, +15% da $200. Vedi la pagina dei prezzi.
Per provarlo, iscriviti con Google o email, poi richiedi il credito di prova da $0,50 con un clic sulla pagina della chiave API. La documentazione copre ogni parametro, e la panoramica degli endpoint spiega cos'è il servizio: un modello a pesi aperti per uso adulto lecito, senza rifiuti sui contenuti e con un fermo divieto sui contenuti sessuali che coinvolgono minorenni.
Altre guide
Domande e risposte
Supporta lo streaming e la chiamata di funzioni?
Sì. Usa stream: true per gli eventi server-sent con l'utilizzo alla fine, e gli strumenti con tool_choice per la chiamata di funzioni.
C'è un endpoint per gli embeddings?
No. Il servizio è solo per chat testuale, quindi usa un altro provider per gli embeddings.
Come controllo il mio saldo?
Chiama GET /v1/balance o il percorso credit_grants in stile OpenAI, oppure leggi l'intestazione X-Balance-USD su qualsiasi risposta.
Cosa succede quando supero il limite di richieste?
Ottieni HTTP 429 con il codice rate_limited o concurrency. Attendi e riprova; in caso di sovraccarico temporaneo, l'intestazione Retry-After indica 5 secondi.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.