Punti chiave
- Il proxy parla il formato delle chat completions di OpenAI. Non inoltra le tue richieste a OpenAI.
- Punta qualsiasi client a https://api.openaiapiproxy.com/v1, usa la tua chiave e imposta il modello su uncensored.
- Supportato: chat completions, elenco modelli, streaming, chiamata di funzioni e modalità JSON. Non supportato: immagini, audio, embedding, fine-tuning.
- La maggior parte dei problemi deriva da un /v1 duplicato nel percorso, dal nome del modello errato o da un 429 per i limiti di richiesta.
Il significato della parola proxy in questo contesto
Le persone usano "proxy" in modo vago ed è utile essere precisi. Nel caso di un proxy API compatibile con OpenAI come questo, la parola descrive l'interfaccia: il server accetta la forma della richiesta OpenAI e restituisce la forma della risposta OpenAI. Il tuo codice non può distinguere la differenza solo dal formato di rete.
Non significa che il tuo traffico venga instradato a OpenAI, o a qualsiasi altra azienda. Le richieste vanno a un singolo modello open-weight gestito da un provider indipendente, ottimizzato per rispondere senza rifiuti sui contenuti per uso adulto legale. Questa non è l'API ufficiale di OpenAI, Meta, Mistral, Qwen, DeepSeek, Google, Anthropic o xAI, e non è un router che sceglie tra fornitori. Questa distinzione è importante per le aspettative: c'è un modello e il suo ID è uncensored.
Perché gli sviluppatori mettono uno strato compatibile davanti a un modello
Il formato di richiesta OpenAI è diventato il linguaggio comune per gli strumenti LLM. Librerie, editor, framework di agent e strumenti no-code sanno tutti come utilizzarlo. Un endpoint compatibile ti permette di riutilizzare tutto questo senza scrivere un client.
- Nessun nuovo SDK. Le librerie ufficiali OpenAI funzionano dopo un cambio di URL base.
- Supporto per gli strumenti gratuito. Tutto ciò che ha un campo endpoint personalizzato è un candidato: interfacce chat, plugin editor, script.
- Facile rollback. Se il nuovo modello non è adatto, reimposti il vecchio URL e nient'altro nel codice cambia.
- Un unico punto per la policy. Scegli il comportamento del modello che vuoi all'endpoint, invece di combattere i rifiuti in ogni prompt.
Il compromesso è accettare i limiti dell'interfaccia implementata. La tabella nella sezione successiva è l'elenco completo.
Cosa è e cosa non è supportato
| Funzionalità | Codice |
|---|---|
POST /v1/chat/completions | Supportato |
GET /v1/models | Supportato, restituisce il modello uncensored |
| Streaming (SSE) | Supportato con stream: true, uso riportato alla fine |
| Chiamata di funzioni | Supportato: tools, tool_choice, streaming tool_calls, risultati role: "tool" |
| Modalità JSON | Supportato tramite response_format |
| Parametri di campionamento | temperature, top_p, stop, seed e le penalità vengono passati invariati |
| Immagini, audio, video | Non disponibile, solo testo |
| Embedding | Non disponibile |
| Fine-tuning | Non disponibile |
| Altri ID modello | Non disponibile, un unico modello |
La finestra di contesto è di 100.000 token contando prompt e completamento insieme. Il corpo della richiesta può essere di 8 MB. Il codice client che dipende da endpoint oltre i due sopra, come una chiamata di embedding all'interno di una libreria di retrieval, fallirà a quella chiamata, quindi pianifica di tenere quella parte con un altro servizio.
Connettiti in meno di cinque minuti
La via più veloce è l'uso delle variabili d'ambiente. Gli SDK Python e Node di OpenAI leggono OPENAI_API_KEY e OPENAI_BASE_URL quando non li passi nel codice, il che significa che molti script esistenti funzionano senza modificare una riga.
export OPENAI_API_KEY="YOUR_KEY"
export OPENAI_BASE_URL="https://api.openaiapiproxy.com/v1"
curl "$OPENAI_BASE_URL/chat/completions" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'Se preferisci la configurazione esplicita, che è più sicura in un progetto che parla anche con altri provider, passa i valori al client:
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapiproxy.com/v1", api_key="YOUR_KEY")
for model in client.models.list():
print(model.id)
out = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarize the plot of a heist film in two sentences."}],
)
print(out.choices[0].message.content)Hai prima bisogno di una chiave. I nuovi account possono richiedere $0,50 di credito di prova con un clic sulla pagina della chiave API. È valido per 7 giorni e non richiede carta. Se lavori con Claude Code, il sito ha una pagina separata su come usarlo con Claude Code.
Le intestazioni di richiesta contano anche in uscita. Invia sempre Content-Type: application/json e mantieni il corpo sotto gli 8 MB. Una richiesta che mescola un documento incollato enorme con una cronologia chat lunga può raggiungere quel limite prima del limite di 100.000 token, quindi controlla la dimensione del corpo quando carichi testo grande.
Un test di cinque minuti prima di fidarti di un proxy
Qualunque endpoint adotti, esegui gli stessi controlli. Richiedono pochi minuti e catturano la maggior parte delle sorprese prima che raggiungano gli utenti.
- Elenca i modelli. Una chiamata
GET /v1/modelsconferma la chiave e l'indirizzo in un unico passaggio. Qui dovresti vedereuncensored. - Invia un completamento minimo. Chiedi una parola e limita
max_tokens. Guarda le intestazioni di risposta, in particolareX-Balance-USD, e conferma che sia diminuita di una quantità plausibile. - Attiva lo streaming per una risposta più lunga. Verifica che i token arrivino gradualmente e che lo streaming termini in modo pulito con l'utilizzo alla fine.
- Chiama uno strumento. Invia uno schema di funzione, verifica che
tool_callsvenga restituito, restituisci un messaggiorole: "tool"e leggi la risposta finale. - Procura un errore appositamente. Invia nove richieste contemporaneamente con una chiave completa, o tre con una chiave di prova, e conferma di ricevere un 429 con il codice
concurrency, e che il tuo codice di retry si riprenda.
Se tutti e cinque passano, l'integrazione è solida a livello di protocollo. Ciò che rimane è giudicare il modello stesso, che possono fare solo i tuoi prompt.
Risoluzione dei problemi comuni
I problemi di compatibilità raramente riguardano il modello. Sono quasi sempre dovuti alla configurazione. Questi sono quelli che si presentano più spesso.
Un errore not-found su ogni chiamata
L’URL di base termina già con /v1, e il tuo client aggiunge di nuovo /v1, o viceversa. Controlla l’URL finale nel log del client. Il percorso di richiesta corretto è https://api.openaiapiproxy.com/v1/chat/completions.
Un errore di autenticazione
La chiave manca, contiene uno spazio di troppo o un ritorno a capo, oppure è stata inviata nell’header sbagliato. Il formato è Authorization: Bearer <key>. Le chiavi incollate da un terminale spesso contengono un ritorno a capo finale.
Il nome del modello viene rifiutato
Usa uncensored, in minuscolo. Nomi come l'ID del modello di un fornitore non corrisponderanno, perché c'è un solo modello qui. Alcuni strumenti hanno un menu a discesa codificato hardcoded, nel qual caso aggiungi un nome di modello personalizzato.
HTTP 429
Il codice di errore indica quale limite hai raggiunto. rate_limited significa che hai superato il limite di richieste al minuto (300 con una chiave completa, 60 con la prova). concurrency significa troppe richieste contemporanee (8 con una chiave completa, 2 con la prova). Anche un sovraccarico temporaneo restituisce 429 con Retry-After: 5. Attendi il tempo indicato e riprova. Ricorda che una richiesta in streaming mantiene il suo slot fino alla fine dello streaming.
Costi, fatturazione e privacy
Il prezzo è di $0,15 per 1M di input token e $0,50 per 1M di output token, prelevati dal credito prepagato. Non c'è abbonamento e il credito non scade mai. Le richieste fallite o rifiutate non vengono addebitate. I prompt non vengono utilizzati per l'addestramento.
Un esempio pratico: uno strumento di tipo supporto invia 3.000 token di input e riceve 400 token di output per chiamata. L'input costa 3.000 / 1.000.000 x $0,15 = $0,00045 e l'output costa 400 / 1.000.000 x $0,50 = $0,0002, quindi una chiamata costa $0,00065 e 10.000 chiamate costano $6,50.
I ricarichi sono di qualsiasi importo intero da $20 a $500, con cripto (USDT su TRC20, USDC su Base). Un ricarico di $200 include un bonus del 15%, per un totale di $230 di credito. La pagina dei prezzi ha il resto.
Cosa cercare in un endpoint compatibile
La categoria è affollata, quindi è utile avere dei criteri. Diffida di qualsiasi fornitore che non dichiara quale modello utilizza, perché questo ti dice a cosa aspettarti e a chi dare la colpa. Qui, il modello è un modello a pesi aperti gestito da un fornitore indipendente, e le pagine lo dichiarano chiaramente.
- Limiti pubblicati. Dovresti conoscere i limiti di richieste e i limiti di concorrenza prima di progettare la logica di retry. Qui sono 300 richieste al minuto e 8 richieste concorrenti con una chiave completa.
- Regole di fatturazione chiare. Cerca credito prepagato, nessun abbonamento e una dichiarazione sulle chiamate fallite. In questo caso le richieste fallite o rifiutate non vengono addebitate e il credito non scade.
- Una dichiarazione sulla privacy. I prompt non vengono utilizzati per l'addestramento qui. Leggi la documentazione e i termini per i dettagli che ti interessano.
- Copertura onesta. Un elenco breve di ciò che manca è un buon segno. Solo testo, senza embedding, senza fine-tuning, un solo modello.
I metodi di pagamento fanno parte del quadro generale. I ricarichi sono disponibili con cripto (USDT su TRC20, USDC su Base), da $20 a $500.
Prima di affidarti ad esso
Un modello senza rifiuti è uno strumento con meno barriere di sicurezza, quindi usalo con cautela. Il servizio ha un limite fisso, nessun contenuto sessuale che coinvolga minorenni, e il tuo prodotto dovrebbe aggiungere qualsiasi filtro adatto ai tuoi utenti e alla tua legislazione locale. Leggi la documentazione per l'elenco completo dei parametri e mantieni configurato un secondo provider per le attività che questo endpoint non copre.
