FR ▾

URL de base de l'API GPT : comment la configurer pour tout client OpenAI

L'URL de base est le seul paramètre qui détermine à quel serveur votre client de style OpenAI se connecte. Modifiez-la, changez la clé et le nom du modèle, et le reste de votre code reste identique.

Mis à jour

Signalisation redirigeant les paquets de données d'un serveur à un autre, illustrant un changement d'URL de base

Points clés

  • Notre URL de base est https://api.uncensoredgptapi.com/v1 et l'ID du modèle est uncensored.
  • Les SDK Python et Node prennent en charge base_url ou baseURL ; ils lisent également les variables d'environnement.
  • La plupart des échecs proviennent d'un /v1 manquant, d'un chemin doublé ou d'un ancien nom de modèle.
  • GET /v1/models est le moyen le plus rapide de confirmer que l'URL et la clé sont correctes.

Ce que fait l'URL de base

L'URL de base de l'API GPT est l'adresse que le SDK OpenAI ajoute au début de chaque chemin d'endpoint. Par défaut, les SDK officiels envoient des requêtes aux serveurs d'OpenAI. Si vous définissez une URL de base différente, le même code client envoie le même format de requête à un autre serveur qui utilise le même protocole.

C'est tout ce que signifie compatible OpenAI en pratique. Notre API accepte POST /v1/chat/completions et GET /v1/models avec les mêmes structures JSON, le même en-tête Authorization: Bearer et le même format de streaming. Ainsi, vous modifiez trois valeurs :

  • URL de base : https://api.uncensoredgptapi.com/v1
  • Clé API : la clé de votre tableau de bord
  • Modèle : uncensored

Notre service est indépendant et exécute un seul modèle à poids ouverts. Ce n'est pas l'API d'OpenAI ni un routeur vers d'autres fournisseurs, donc des noms de modèles comme gpt-4o n'existent pas ici. Utilisez uncensored partout.

Python avec le SDK OpenAI

Dans le SDK Python actuel, passez base_url lors de la création du 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)

Si votre code est plus ancien et utilise openai.api_base, il s'agit du SDK pré-1.0, où le paramètre global a un nom différent. Mettre à jour le package est généralement plus simple que de l'adapter. Vérifiez la version avec pip show openai.

Il est utile de comprendre comment le SDK construit une requête. Il prend votre URL de base, ajoute le chemin de l'endpoint tel que /chat/completions, et ajoute l'en-tête Authorization: Bearer issu de votre clé. C'est tout le mécanisme. Lorsque quelque chose échoue, affichez ou journalisez l'URL finale et comparez-la avec la commande curl dans la section suivante.

Le même client accepte les paramètres timeout et max_retries. Les valeurs par défaut réessayent quelques fois en cas de problèmes de connexion, ce qui convient à la plupart des scripts. Pour les limites de débit, capturez l'exception de limite de débit du SDK et réduisez le débit. Une requête streaming occupe sa place de concurrence jusqu'à sa fin, donc une rafale de longs streams peut atteindre la limite de concurrence même si votre nombre de requêtes par minute est faible.

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'attente de cinq secondes lors de la première nouvelle tentative correspond à la valeur Retry-After: 5 envoyée par l'API en cas de surcharge temporaire. Attendre plus longtemps à chaque tentative ultérieure évite de surcharger l'endpoint.

Node et curl

Le SDK Node utilise baseURL avec un U majuscule.

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

Sans aucun SDK, curl montre exactement ce que fait le SDK. L'URL complète est l'URL de base 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"}]}'

Lire cette commande est le moyen le plus clair de comprendre l'URL de base : tout jusqu'à et y compris /v1 est la base, et le SDK ajoute le reste.

Variables d'environnement

Si vous ne pouvez pas modifier le code, ou si vous souhaitez un seul paramètre pour plusieurs scripts, les SDK OpenAI lisent OPENAI_BASE_URL et OPENAI_API_KEY dans l'environnement lorsqu'aucune valeur explicite n'est fournie.

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

C'est pratique pour les outils que vous n'avez pas écrits. Tout ce qui est construit sur le SDK OpenAI peut récupérer les variables sans modifications, bien que vous deviez toujours définir le nom du modèle à uncensored dans l'outil. Si l'outil code en dur un modèle, vous devez avoir son propre paramètre ou une modification de code.

Séparer deux endpoints

De nombreux projets testent contre un endpoint et livrent contre un autre, ou basculent entre eux par environnement. Gardez les trois valeurs hors de votre code et lisez-les depuis la configuration, afin qu'un changement soit une modification de fichier et non une modification de code.

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

Utiliser vos propres noms de variables au lieu des valeurs par défaut du SDK évite un piège silencieux : un outil qui lit OPENAI_API_KEY depuis le shell enverra n'importe quelle clé définie là vers n'importe quelle URL de base définie à côté. Si vous avez une ancienne clé OpenAI dans votre profil et une nouvelle URL de base dans votre projet, vous pouvez finir par envoyer la clé d'un service à l'autre. Des noms séparés rendent cela impossible et vous permettent de voir en un coup d'œil à quel endpoint un script se connectera.

Traitez le nom du modèle comme une configuration également. C'est la valeur la plus souvent laissée derrière lorsque vous changez, et elle provoque les échecs les plus confus, car tout le reste semble correct.

Le streaming et les outils utilisent la même URL de base

Changer l'URL de base ne limite pas les fonctionnalités. Le streaming, l'appel de fonctions et le mode JSON passent par le même chemin /chat/completions, donc le code qui fonctionnait contre l'API originale continue de fonctionner. Le streaming retourne des Server-Sent Events, avec l'utilisation rapportée à la fin du 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()

La garde sur chunk.choices est importante. Le dernier chunk qui contient l'utilisation peut n'avoir aucun choix, et le code qui indexe une liste vide plantera sur le dernier message. Les appels d'outils sont diffusés de la même manière, sous forme de deltas partiels tool_calls que vous assemblez avant d'exécuter la fonction, et les résultats sont retournés sous forme de messages avec role: "tool". Le mode JSON prend response_format={"type": "json_object"}.

Applications et frameworks avec un champ URL de base

De nombreuses applications exposent le même paramètre sous des noms différents : base de l'API, endpoint, URL OpenAI personnalisée ou hôte. La règle ne change pas. Collez l'URL de base incluant /v1, collez la clé et saisissez uncensored comme nom du modèle.

SillyTavern, par exemple, vous permet d'ajouter un endpoint compatible OpenAI. La classe ChatOpenAI de LangChain accepte un argument base_url. D'autres interfaces appellent ce champ URL du proxy ou proxy inverse. Les noms de champs varient selon la version, alors recherchez celui qui accepte une URL se terminant par /v1.

Certaines applications demandent un modèle à partir d'une liste déroulante qu'elles remplissent en appelant GET /v1/models. Cet endpoint fonctionne ici et retourne la liste des modèles, donc la liste déroulante devrait afficher uncensored une fois l'URL et la clé correctes. Si elle reste vide, l'URL ou la clé est incorrecte.

Lorsqu'une application propose à la fois un champ URL de base et un champ "organisation" ou "projet", laissez les champs supplémentaires vides. Ceux-ci existent pour le service original et n'ont aucun sens ici. Si une application insiste pour une clé commençant par un certain préfixe, essayez un type de connexion différent, tel qu'une option générique ou personnalisée compatible OpenAI, plutôt que le préréglage pour le service original.

Certains outils de bureau testent la connexion en demandant un nom de modèle spécifique au fournisseur original, et signalent un échec même lorsque l'endpoint est correct. Dans ce cas, ignorez le bouton de test et envoyez un vrai message à la place. Si la réponse arrive, l'URL, la clé et le modèle sont corrects, et l'outil est simplement strict dans sa vérification.

Les outils basés sur le navigateur peuvent également rencontrer des règles cross-origin, car la requête quitte la page pour un hôte différent. Si un outil web échoue dans le navigateur mais que le même appel fonctionne dans curl, exécutez la requête depuis un petit serveur à vous afin que la clé reste hors du code côté client, ce qui est le design plus sûr dans tous les cas.

Erreurs courantes et comment les corriger

Presque chaque échec de configuration provient d'une courte liste.

  • /v1 manquant. L'URL de base est https://api.uncensoredgptapi.com/v1, l'adresse complète jusqu'à /v1 et pas seulement le nom d'hôte. Sans /v1, le SDK construit des chemins qui n'existent pas.
  • Chemin doublé. Si vous collez .../v1/chat/completions comme URL de base, le SDK ajoutera à nouveau le chemin. Donnez-lui seulement la base.
  • Barre oblique finale. La plupart des SDK la gèrent, mais quelques outils non. Essayez sans.
  • Ancien nom de modèle. Un nom de modèle comme gpt-4o laissé dans le code d'origine ne correspondra pas. Définissez uncensored.
  • Mauvaise clé. Utilisez la clé de ce service. Une clé OpenAI ne fonctionne pas ici, et la nôtre ne fonctionne pas sur OpenAI.
  • Erreurs de limite de débit. Le code HTTP 429 avec le code rate_limited signifie trop de requêtes par minute ; le code concurrency signifie trop de requêtes simultanées. Un 429 avec un en-tête Retry-After: 5 marque une surcharge temporaire, donc attendez cinq secondes et réessayez.

Notre guide de dépannage détaille les erreurs d’intégration.

Vérifiez la configuration en un seul appel

Avant de lancer toute votre application, appelez l’endpoint des modèles. C’est peu coûteux et cela confirme l’URL et la clé ensemble.

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

Si cela renvoie une liste contenant uncensored, envoyez une vraie requête de chat. Pour une clé complète, attendez-vous à jusqu’à 8 requêtes simultanées et 300 requêtes par minute ; une clé d’essai permet 2 requêtes simultanées et 60 par minute. Chaque réponse inclut X-Request-Id, X-Balance-USD et les en-têtes de limite de débit, utiles pour le débogage.

Pour obtenir une clé, inscrivez-vous et utilisez la page clé API, où les nouveaux utilisateurs peuvent réclamer un crédit d'essai gratuit de 0,50 $ en un clic. La documentation couvre le streaming, l'appel de fonctions et le mode JSON une fois la connexion établie.

Questions et réponses

Quelle est l’URL de base de votre API ?

Il s'agit de https://api.uncensoredgptapi.com/v1. Incluez la partie /v1 et omettez le chemin de l'endpoint.

Quel nom de modèle dois-je utiliser ?

Utilisez uncensored. Les noms de modèles d’autres fournisseurs, comme gpt-4o, ne sont pas disponibles ici.

Puis-je utiliser mon code SDK OpenAI existant ?

Oui. Modifiez l’URL de base, la clé API et le nom du modèle. Les complétions de chat, le streaming, l’appel de fonctions et le mode JSON suivent le même format de requête.

La variable OPENAI_BASE_URL fonctionne-t-elle ?

Les SDK officiels OpenAI la lisent lorsqu’aucune URL de base n’est passée dans le code, donc la définir est souvent suffisant. Vérifiez l’outil que vous utilisez, car certains l’ignorent.

Pourquoi obtiens-je une erreur 429 ?

Le code rate_limited signifie trop de requêtes par minute, et le code concurrency signifie trop de requêtes à la fois. Une erreur 429 avec un Retry-After de 5 signifie une surcharge temporaire, donc réessayez après cinq secondes.

Votre clé n'est qu'à un formulaire d'ici

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API