NL ▾

GPT API base_url: instellen voor elke OpenAI-client

De base URL is de enige instelling die bepaalt met welke server je OpenAI-achtige client communiceert. Pas deze aan, pas de sleutel en de modelnaam aan, en de rest van je code blijft hetzelfde.

Bijgewerkt

Wegwijzer die datapakketten van de ene naar de andere server leidt, illustratie van een base URL-wijziging

Belangrijkste punten

  • Onze base URL is https://api.uncensoredgptapi.com/v1 en de model-ID is uncensored.
  • Python- en Node SDKs gebruiken base_url of baseURL; beide lezen ook omgevingsvariabelen.
  • De meeste fouten komen door een ontbrekende /v1, een dubbel pad of een oude modelnaam.
  • GET /v1/models is de snelste manier om te bevestigen dat de URL en sleutel kloppen.

Wat de base URL doet

De gpt api base_url is het adres dat een OpenAI SDK voor elk endpoint-pad plaatst. Standaard sturen de officiële SDK's verzoeken naar de servers van OpenAI. Als je een andere base URL instelt, stuurt dezelfde clientcode hetzelfde verzoekformaat naar een andere server die hetzelfde protocol spreekt.

Dat is wat OpenAI-compatibel in de praktijk betekent. Onze API accepteert POST /v1/chat/completions en GET /v1/models met dezelfde JSON-structuren, dezelfde Authorization: Bearer header en hetzelfde streamingformaat. Dus pas drie waarden aan:

  • Base URL: https://api.uncensoredgptapi.com/v1
  • API-sleutel: de sleutel uit je dashboard
  • Model: uncensored

Onze service is een onafhankelijke service die een enkel open-weight model draait. Het is niet de API van OpenAI en geen router naar andere leveranciers, dus modelnamen zoals gpt-4o bestaan hier niet. Gebruik uncensored overal.

Python met de OpenAI SDK

In de huidige Python SDK geef je base_url door bij het aanmaken van de 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)

Als je code ouder is en gebruikmaakt van openai.api_base, dan gebruik je de pre-1.0 SDK, waar de globale instelling een andere naam heeft. Het pakket upgraden is meestal makkelijker dan aanpassen. Controleer de versie met pip show openai.

Het helpt om te weten hoe de SDK een verzoek bouwt. Het neemt je base URL, plakt het endpoint-pad zoals /chat/completions erachteraan, en voegt de Authorization: Bearer header toe vanuit je sleutel. Dat is het hele mechanisme. Als er iets misgaat, print of log de uiteindelijke URL en vergelijk deze met het curl-commando in de volgende sectie.

Dezelfde client accepteert timeout en max_retries instellingen. De standaardwaarden proberen het een paar keer opnieuw bij verbindingsproblemen, wat prima is voor de meeste scripts. Bij rate limits, vang de rate limit uitzondering van de SDK af en wacht even. Een gestreamd verzoek houdt zijn concurrentieslot vast tot het einde, dus een piek van lange streams kan de concurrency limit raken, zelfs als je aantal verzoeken per minuut laag is.

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")

De wachttijd van vijf seconden bij de eerste retry komt overeen met de waarde Retry-After: 5 die de API stuurt bij tijdelijke overbelasting. Langer wachten bij elke volgende poging voorkomt dat je het endpoint overbelast.

Node en curl

De Node SDK gebruikt baseURL met een hoofdletter U in URL.

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);

Zonder SDK toont curl precies wat de SDK doet. De volledige URL is de base URL plus /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"}]}'

Die opdracht lezen is de duidelijkste manier om de base URL te begrijpen: alles tot en met /v1 is de base, en de SDK voegt de rest toe.

Omgevingsvariabelen

Als je de code niet kunt bewerken, of als je één instelling voor meerdere scripts wilt gebruiken, lezen de OpenAI SDKs OPENAI_BASE_URL en OPENAI_API_KEY uit de omgeving als er geen expliciete waarde wordt doorgegeven.

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

Dit is handig voor tools die je niet hebt geschreven. Alles wat is gebouwd op de OpenAI SDK kan de variabelen oppikken zonder aanpassingen, hoewel je nog steeds de modelnaam moet instellen op uncensored binnen de tool. Als de tool een model hardcodeert, heb je een eigen instelling of een code-aanpassing nodig.

Twee endpoints gescheiden houden

Veel projecten testen tegen het ene endpoint en leveren tegen een ander, of schakelen ertussen op basis van de omgeving. Houd de drie waarden buiten je code en lees ze uit configuratie, zodat een wissel een wijziging in een bestand is en geen codewijziging.

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")

Het gebruik van je eigen variabelnamen in plaats van de standaardwaarden van de SDK voorkomt een stille val: een tool die OPENAI_API_KEY uit de shell leest, stuurt elke sleutel die daar is ingesteld naar elke base URL die ernaast is ingesteld. Als je een oude OpenAI-sleutel in je profiel hebt en een nieuwe base URL in je project, kun je per ongeluk de sleutel van de ene service naar de andere sturen. Aparte namen maken dat onmogelijk en je ziet in één oogopslag welk endpoint een script zal gebruiken.

Behandel de modelnaam ook als configuratie. Het is de waarde die het vaakst achterblijft als je wisselt, en het veroorzaakt de meest verwarrende fouten, omdat alles er anders correct uitziet.

Streaming en tools gebruiken dezelfde base URL

Het aanpassen van de base URL beperkt geen functies. Streaming, function calling en JSON-modus gaan via hetzelfde /chat/completions pad, dus code die tegen de originele API werkte, blijft werken. Streaming retourneert Server-Sent Events, met gebruiksinformatie aan het einde van de 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()

De guard op chunk.choices is belangrijk. De laatste chunk die gebruiksinformatie bevat, kan geen keuzes hebben, en code die indexeert in een lege lijst crasht op het laatste bericht. Tool calls streamen op dezelfde manier, als gedeeltelijke tool_calls deltas die je samenstelt voordat je de functie uitvoert, en resultaten gaan terug als berichten met role: "tool". JSON-modus vereist response_format={"type": "json_object"}.

Apps en frameworks met een base URL-veld

Veel apps bieden dezelfde instelling onder verschillende namen: API base, endpoint, aangepaste OpenAI URL, of host. De regel verandert niet. Plak de base URL inclusief /v1, plak de sleutel en typ uncensored als modelnaam.

SillyTavern kun je bijvoorbeeld een OpenAI-compatibel endpoint toevoegen. LangChain's ChatOpenAI klasse accepteert een base_url argument. Andere front-ends noemen het veld proxy URL of reverse proxy. Veldnamen variëren per versie, dus zoek naar degene die een URL accepteert die eindigt op /v1.

Een paar apps vragen om een model uit een dropdown die ze vullen door GET /v1/models aan te roepen. Dat endpoint werkt hier en retourneert de modellenlijst, dus de dropdown zou uncensored moeten tonen zodra de URL en sleutel correct zijn. Als deze leeg blijft, is de URL of sleutel fout.

Wanneer een app zowel een veld voor de base URL als een "organisatie" of "project" veld biedt, laat de extra velden leeg. Die bestaan voor de oorspronkelijke service en betekenen hier niets. Als een app aandringt op een sleutel die met een bepaald prefix begint, probeer dan een ander verbindingstype, zoals een generieke of aangepaste OpenAI-compatibele optie, in plaats van de voorinstelling voor de oorspronkelijke service.

Sommige desktoptools testen de verbinding door een specifieke modelnaam van de originele provider aan te vragen, en melden een fout, zelfs als het endpoint in orde is. Sla in dat geval de testknop over en stuur een echt bericht. Als het antwoord aankomt, zijn de URL, sleutel en model correct, en is de tool alleen streng in zijn controle.

Browsergebaseerde tools kunnen ook te maken krijgen met cross-origin-regels, omdat het verzoek de pagina verlaat voor een andere host. Als een webtool in de browser faalt maar hetzelfde verzoek in curl werkt, voer het verzoek dan uit vanaf een kleine server van jezelf, zodat de sleutel buiten clientcode blijft, wat in elk geval veiliger is.

Veelgemaakte fouten en hoe ze op te lossen

Bijna elke mislukte configuratie komt door een korte lijst.

  • Ontbrekende /v1. De base URL is https://api.uncensoredgptapi.com/v1, het volledige adres tot en met /v1 en niet alleen de hostnaam. Zonder /v1 bouwt de SDK paden die niet bestaan.
  • Dubbel pad. Als je .../v1/chat/completions als base URL plakt, plakt de SDK het pad er nogmaals achter. Geef alleen de base.
  • Afsluitende slash. De meeste SDKs handelen dit af, maar een paar tools niet. Probeer het zonder.
  • Oude modelnaam. Een modelnaam zoals gpt-4o die is overgebleven uit de originele code, klopt niet. Stel uncensored in.
  • Verkeerde sleutel. Gebruik de sleutel van deze service. Een OpenAI-sleutel werkt hier niet, en onze sleutel werkt niet op OpenAI.
  • Rate limit-fouten. HTTP 429 met code rate_limited betekent te veel verzoeken per minuut; code concurrency betekent te veel tegelijk. Een 429 met een Retry-After: 5 header markeert tijdelijke overbelasting, dus wacht vijf seconden en probeer het opnieuw.

Onze handleiding voor probleemoplossing gaat integratiefouten in meer detail door.

Verifieer de configuratie in één verzoek

Roep het models-endpoint aan voordat je je hele applicatie uitvoert. Het is goedkoop en bevestigt de URL en de sleutel samen.

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

Als dat een lijst teruggeeft met uncensored, stuur dan een echt chatverzoek. Voor een volledige sleutel kun je tot 8 gelijktijdige verzoeken verwachten en 300 verzoeken per minuut; een proefsleutel staat 2 gelijktijdige en 60 per minuut toe. Elk antwoord bevat X-Request-Id, X-Balance-USD en de rate limit headers, handig bij het debuggen.

Om een sleutel te krijgen, meld je aan en gebruik de pagina voor API-sleutels, waar nieuwe gebruikers met één klik $0,50 proeftegoed kunnen claimen. De documentatie behandelen streaming, function calling en JSON-modus zodra de verbinding werkt.

Vragen en antwoorden

Wat is de base URL voor je API?

Het is https://api.uncensoredgptapi.com/v1. Voeg de /v1 toe en laat het endpoint pad weg.

Welke modelnaam moet ik gebruiken?

Gebruik uncensored. Modelnamen van andere providers, zoals gpt-4o, zijn hier niet beschikbaar.

Kan ik mijn bestaande OpenAI SDK-code gebruiken?

Ja. Verander de base URL, de API-sleutel en de modelnaam. Chat-completions, streaming, function calling en JSON-modus volgen dezelfde verzoekindeling.

Werkt de OPENAI_BASE_URL variabele?

De officiële OpenAI SDKs lezen deze uit wanneer er geen base URL in de code wordt doorgegeven, dus het instellen is vaak genoeg. Controleer de tool die je gebruikt, omdat sommige het negeren.

Waarom krijg ik een 429-fout?

Code rate_limited betekent te veel verzoeken per minuut, en code concurrency betekent te veel in één keer. Een 429 met een Retry-After van 5 betekent tijdelijke overbelasting, dus probeer het opnieuw na vijf seconden.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragen