IT ▾

Base URL API GPT: come impostarla per qualsiasi client OpenAI

Il base URL è l'impostazione che decide a quale server parla il tuo client in stile OpenAI. Cambialo, cambia la chiave e il nome del modello, e il resto del tuo codice rimane invariato.

Aggiornato

Indicatore che reindirizza i pacchetti di dati da un server a un altro, illustra un cambiamento del base URL

Punti chiave

  • Il nostro base URL è https://api.uncensoredgptapi.com/v1 e l'ID del modello è uncensored.
  • Gli SDK Python e Node accettano base_url o baseURL; entrambi leggono anche le variabili d'ambiente.
  • La maggior parte dei problemi deriva dalla mancanza di /v1, da un percorso duplicato o da un vecchio nome del modello.
  • GET /v1/models è il modo più veloce per confermare che l'URL e la chiave siano corretti.

Cosa fa il base URL

Il base URL dell'API GPT è l'indirizzo che un SDK OpenAI antepone a ogni percorso dell'endpoint. Di default gli SDK ufficiali inviano le richieste ai server di OpenAI. Se imposti un base URL diverso, lo stesso codice client invia lo stesso formato di richiesta a un altro server che parla lo stesso protocollo.

Questo è tutto ciò che significa compatibile con OpenAI in pratica. La nostra API accetta POST /v1/chat/completions e GET /v1/models con le stesse forme JSON, lo stesso header Authorization: Bearer e lo stesso formato di streaming. Quindi devi cambiare tre valori:

  • Base URL: https://api.uncensoredgptapi.com/v1
  • Chiave API: la chiave dalla tua dashboard
  • Modello: uncensored

Il nostro servizio è indipendente ed esegue un singolo modello a pesi aperti. Non è l'API di OpenAI e non è un router verso altri fornitori, quindi nomi di modello come gpt-4o non esistono qui. Usa uncensored ovunque.

Python con l'SDK OpenAI

Nell'attuale SDK Python, passa base_url quando crei il client.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredgptapi.com/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a base URL is in two sentences."},
    ],
)
print(resp.choices[0].message.content)

Se il tuo codice è più vecchio e usa openai.api_base, si tratta dell'SDK pre-1.0, dove l'impostazione globale ha un nome diverso. Aggiornare il pacchetto è di solito più semplice che adattarlo. Controlla la versione con pip show openai.

È utile sapere come l'SDK costruisce una richiesta. Prende il tuo base URL, aggiunge il percorso dell'endpoint come /chat/completions e aggiunge l'header Authorization: Bearer dalla tua chiave. Questo è tutto il meccanismo. Quando qualcosa fallisce, stampa o registra l'URL finale e confrontalo con il comando curl nella sezione successiva.

Lo stesso client accetta le impostazioni timeout e max_retries. I valori predefiniti riprovano alcune volte in caso di problemi di connessione, il che va bene per la maggior parte degli script. Per i limiti di richiesta, intercetta l'eccezione del limite di richieste dell'SDK e riduci la frequenza. Una richiesta streaming mantiene il suo slot di concorrenza fino alla fine, quindi un picco di stream lunghi può raggiungere il limite di concorrenza anche se il numero di richieste al minuto è basso.

import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)

def ask(text, tries=4):
    for attempt in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": text}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited")

L'attesa di cinque secondi al primo tentativo corrisponde al valore Retry-After: 5 che l'API invia in caso di sovraccarico temporaneo. Aspettare di più a ogni tentativo successivo evita di sovraccaricare l'endpoint.

Node e curl

L'SDK Node usa baseURL con la U maiuscola.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredgptapi.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);

Senza alcun SDK, curl mostra esattamente cosa fa l'SDK. L'URL completo è il base URL più /chat/completions.

curl https://api.uncensoredgptapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Leggere quel comando è il modo più chiaro per comprendere il base URL: tutto fino a e incluso /v1 è la base, e l'SDK aggiunge il resto.

Variabili d'ambiente

Se non puoi modificare il codice, o vuoi un'impostazione per più script, gli SDK OpenAI leggono OPENAI_BASE_URL e OPENAI_API_KEY dall'ambiente quando non viene dato un valore esplicito.

export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.py

È utile per gli strumenti che non hai scritto tu. Qualsiasi cosa basata sull'SDK di OpenAI può rilevare le variabili senza modifiche, ma devi comunque impostare il nome del modello a uncensored all'interno dello strumento. Se lo strumento ha un modello hardcoded, hai bisogno di una tua impostazione o di una modifica al codice.

Mantenere separati due endpoint

Molti progetti testano contro un endpoint e distribuiscono contro un altro, o passano tra di essi tramite ambiente. Tieni i tre valori fuori dal codice e leggili dalla configurazione, così un cambio è una modifica a un file e non una modifica al codice.

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")

Utilizzare i tuoi nomi di variabili invece dei valori predefiniti dell'SDK evita una trappola silenziosa: uno strumento che legge OPENAI_API_KEY dalla shell invierà qualsiasi chiave impostata lì a qualsiasi URL di base impostato accanto. Se hai una vecchia chiave OpenAI nel tuo profilo e un nuovo URL di base nel tuo progetto, potresti finire per inviare la chiave di un servizio all'altro. Nomi separati rendono impossibile questo errore e puoi vedere a colpo d'occhio quale endpoint utilizzerà uno script.

Tratta il nome del modello come configurazione anche lui. È il valore più spesso lasciato indietro quando cambi, e produce i fallimenti più confusi, poiché tutto il resto sembra corretto.

Streaming e strumenti usano lo stesso base URL

Cambiare il base URL non limita le funzionalità. Streaming, chiamata di funzioni e modalità JSON passano attraverso lo stesso percorso /chat/completions, quindi il codice che funzionava contro l'API originale continua a funzionare. Lo streaming restituisce Server-Sent Events, con l'utilizzo riportato alla fine dello stream.

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Count from one to five."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

Il controllo su chunk.choices è importante. L'ultimo chunk che trasporta l'utilizzo potrebbe non avere scelte, e il codice che indicizza una lista vuota crasherebbe sull'ultimo messaggio. Le chiamate di funzioni fluiscono allo stesso modo, come delta parziali tool_calls che assembli prima di eseguire la funzione, e i risultati tornano come messaggi con role: "tool". La modalità JSON richiede response_format={"type": "json_object"}.

App e framework con un campo base URL

Molte app espongono la stessa impostazione con nomi diversi: API base, endpoint, URL OpenAI personalizzato o host. La regola non cambia. Incolla il base URL includendo /v1, incolla la chiave e digita uncensored come nome del modello.

SillyTavern, ad esempio, ti permette di aggiungere un endpoint compatibile con OpenAI. La classe ChatOpenAI di LangChain accetta un argomento base_url. Altri front-end chiamano il campo proxy URL o reverse proxy. I nomi dei campi variano per versione, quindi cerca quello che accetta un URL che termina con /v1.

Alcune app richiedono un modello da un menu a tendina che riempiono chiamando GET /v1/models. Quell'endpoint funziona qui e restituisce l'elenco dei modelli, quindi il menu a tendina dovrebbe mostrare uncensored una volta che l'URL e la chiave sono corretti. Se rimane vuoto, l'URL o la chiave sono sbagliati.

Quando un'app offre sia un campo base URL che un campo "organizzazione" o "progetto", lascia vuoti i campi extra. Esistono per il servizio originale e non significano nulla qui. Se un'app insiste su una chiave che inizia con un certo prefisso, prova un tipo di connessione diverso, come un'opzione generica o personalizzata compatibile con OpenAI, invece del preset per il servizio originale.

Alcuni strumenti desktop testano la connessione richiedendo un nome di modello specifico dal provider originale e segnalano un errore anche quando l'endpoint è funzionante. In quel caso, salta il pulsante di test e invia un messaggio effettivo. Se la risposta arriva, l'URL, la chiave e il modello sono corretti e lo strumento è solo rigoroso nel suo controllo.

Gli strumenti basati sul browser possono anche imbattersi nelle regole cross-origin, poiché la richiesta lascia la pagina per un host diverso. Se uno strumento web fallisce nel browser ma la stessa chiamata funziona in curl, esegui la richiesta da un piccolo server tuo così la chiave resta fuori dal codice lato client, che è il design più sicuro in ogni caso.

Errori comuni e come risolverli

Quasi ogni configurazione fallita deriva da un breve elenco.

  • Mancanza di /v1. L'URL di base è https://api.uncensoredgptapi.com/v1, l'indirizzo completo fino a /v1 e non solo il nome dell'host. Senza /v1 l'SDK costruisce percorsi che non esistono.
  • Percorso duplicato. Se incolli .../v1/chat/completions come URL di base, l'SDK aggiunge nuovamente il percorso. Fornisci solo la base.
  • Barra finale. La maggior parte degli SDK la gestisce, ma alcuni strumenti no. Prova senza.
  • Vecchio nome del modello. Un nome di modello come gpt-4o lasciato dal codice originale non corrisponderà. Imposta uncensored.
  • Chiave sbagliata. Usa la chiave di questo servizio. Una chiave OpenAI non funziona qui, e la nostra non funziona su OpenAI.
  • Errori di limite di richieste. HTTP 429 con codice rate_limited significa troppe richieste al minuto; codice concurrency significa troppe richieste contemporaneamente. Un 429 con un'intestazione Retry-After: 5 indica un sovraccarico temporaneo, quindi aspetta cinque secondi e riprova.

La nostra guida alla risoluzione dei problemi analizza più nel dettaglio gli errori di integrazione.

Verifica la configurazione in una sola chiamata

Prima di eseguire l'intera applicazione, chiama l'endpoint dei modelli. È economico e conferma che l'URL e la chiave funzionino insieme.

curl https://api.uncensoredgptapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Se la risposta è una lista contenente uncensored, invia una richiesta di chat reale. Con una chiave completa puoi effettuare fino a 8 richieste parallele e 300 richieste al minuto; una chiave di prova ne permette 2 parallele e 60 al minuto. Ogni risposta include X-Request-Id, X-Balance-USD e le intestazioni del limite di richieste, utili per il debug.

Per ottenere una chiave, registrati e usa la pagina delle chiavi API, dove i nuovi utenti possono richiedere un credito di prova da $0,50 con un solo clic. La documentazione copre lo streaming, la chiamata di funzioni e la modalità JSON una volta stabilita la connessione.

Domande e risposte

Qual è l'URL base della tua API?

È https://api.uncensoredgptapi.com/v1. Aggiungi la parte /v1 e rimuovi il percorso dell'endpoint.

Quale nome di modello devo usare?

Usa uncensored. I nomi dei modelli di altri provider, come gpt-4o, non sono disponibili qui.

Posso usare il mio codice SDK OpenAI esistente?

Sì. Modifica l'URL di base, la chiave API e il nome del modello. Completamenti chat, streaming, chiamata di funzioni e modalità JSON seguono lo stesso formato di richiesta.

La variabile OPENAI_BASE_URL funziona?

Gli SDK ufficiali di OpenAI la leggono quando non viene passato un URL base nel codice, quindi impostarla è spesso sufficiente. Controlla lo strumento che usi, poiché alcuni lo ignorano.

Perché ricevo un errore 429?

Il codice rate_limited indica troppe richieste al minuto, mentre concurrency indica troppe richieste simultanee. Un 429 con Retry-After di 5 indica un sovraccarico temporaneo, quindi riprova dopo cinque secondi.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Ottieni la chiave API