FR ▾
Obtenir une clé API

Alternatives à l'API OpenAI : ce qui change dans votre code

La plupart des alternatives à l'API OpenAI copient le format de requête d'OpenAI, ce qui signifie que le changement est souvent une modification de configuration plutôt qu'une réécriture. Cet article montre exactement ce qui change dans le code, ce qui peut casser, et où un endpoint compatible OpenAI à modèle unique est un bon choix et où il ne l'est pas.

Mis à jour le

Plusieurs câbles colorés branchés dans un port de connecteur standard, montrant des endpoints d'API interchangeables
Quatre plateformes avec un cloud, un hub réseau, un boîtier GPU et un cube liés à un solde central, pour comparer les options de modèles

Ce qu'une alternative peut offrir

Les gens recherchent des alternatives à l'API OpenAI pour différentes raisons : prix, règles de contenu, gestion des données, disponibilité régionale, ou le souhait d'utiliser des modèles à poids ouverts. Quelle que soit la raison, le même test s'applique. L'alternative accepte-t-elle la forme de requête que vous envoyez déjà, et renvoie-t-elle la forme de réponse que votre code lit déjà ?

Si oui, vos appels SDK ne changent pas. Si non, vous écrivez un adaptateur une fois, ce qui est aussi bien, mais c'est le principal coût du changement. Le reste de cet article suppose le premier cas, un endpoint compatible OpenAI.

Le changement en trois lignes

Avec le package Python officiel, la configuration initiale définit l'hôte par défaut et une clé OpenAI. Pour une alternative, vous définissez trois éléments : l'base_url, la clé du nouveau fournisseur et le nom du modèle. Voici la version finale pour cet endpoint :

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",  # was the default host
    api_key=os.environ["NEW_PROVIDER_KEY"],            # was your OpenAI key
)

r = client.chat.completions.create(
    model="uncensored",                                 # was an OpenAI model name
    messages=[{"role": "user", "content": "Pitch me a plot twist for a mystery."}],
)
print(r.choices[0].message.content)

La même chose fonctionne dans Node en passant baseURL au constructeur, dans les wrappers de style LangChain via leur option d'URL de base, et dans les outils qui disposent d'un champ endpoint personnalisé. Dans curl, vous modifiez l'hôte et l'en-tête :

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

Ce qui peut casser après le changement

Noms de modèles

Les IDs de modèles appartiennent au fournisseur. Tout ce qui code en dur un nom de modèle OpenAI doit être mis à jour. Placez le nom dans la configuration.

Paramètres

Les options de base comme temperature, top_p, stop et max_tokens sont conservées. D'autres, comme logprobs ou certaines options de format de réponse, dépendent du fournisseur. Sur cet endpoint, temperature, top_p, stop, seed et les pénalités sont transmis, et le mode JSON fonctionne avec response_format: {"type":"json_object"}.

Qualité de l'appel de fonctions

Le format filaire est partagé, mais la façon dont un modèle choisit les fonctions et remplit les arguments varie. Exécutez vos vrais schémas de fonctions via le nouveau modèle et validez les arguments dans votre code.

Longueur du contexte et troncature

Un changement de fenêtre de contexte modifie la quantité d'historique que vous pouvez envoyer. Ici, la fenêtre est de 100 000 tokens pour le prompt plus la complétion.

Erreurs et limites

Les fournisseurs utilisent des limites et des codes différents. Celui-ci renvoie HTTP 429 avec rate_limited pour les requêtes par minute et concurrency pour trop de requêtes simultanées, ainsi qu'un 429 avec Retry-After: 5 en cas de surcharge temporaire. Votre logique de nouvelle tentative devrait gérer le 429 pour tout fournisseur.

Comportement

Le plus grand changement n'est pas technique. Les modèles diffèrent par le ton, les habitudes de formatage et ce qu'ils refusent. Testez avec vos vrais prompts, pas des démos.

Où un endpoint à modèle unique s'adapte

Ce service est une API textuelle compatible OpenAI avec un seul modèle à poids ouverts, géré par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Il ne s'agit pas de l'API officielle d'OpenAI, Meta, Mistral, Qwen, DeepSeek, xAI, Google, Anthropic ou de tout autre fournisseur, et ce n'est pas un routeur entre fournisseurs. L'ID du modèle est uncensored.

Il convient bien à ces tâches : outils de fiction et de jeu de rôle pour adultes, applications compagnons, assistants d'écriture qui ne doivent pas s'arrêter en plein milieu, et backends où un comportement stable sur des thèmes matures est plus important que le choix entre plusieurs modèles. Il convient aussi aux développeurs qui veulent un prix simple par token et des prompts qui ne sont pas utilisés pour l'entraînement.

Ce qui ne convient pas

Soyez honnête sur les limites avant de déplacer le trafic :

  • Un seul modèle. Vous ne pouvez pas choisir un modèle plus petit et moins cher pour des tâches faciles ou un plus grand pour des tâches difficiles. Si vous dépendez du routage de modèles, vous avez besoin d'une plateforme différente.
  • Texte uniquement. Pas de génération d'images, d'audio ou de vidéo, pas d'embeddings ni de fine-tuning. Une application de récupération qui a besoin d'embeddings doit les obtenir ailleurs.
  • Pas le modèle phare d'un fournisseur. Si vous avez besoin d'un modèle nommé spécifique pour la conformité ou les benchmarks, utilisez ce fournisseur.
  • Limite absolue. Aucun contenu sexuel impliquant des mineurs, jamais.

De nombreuses équipes utilisent deux endpoints : un fournisseur principal et un second pour le contenu que le premier refuse. Comme les deux partagent le même format, cela représente peu de code, un changement de configuration et un repli sur certaines erreurs.

Coût : comment comparer

Vérifiez la tarification actuelle de chaque fournisseur et convertissez-la dans le format de votre requête. Pour ce point de terminaison, les coûts d'entrée sont de $0,15 par 1M de jetons et les coûts de sortie de $0,50 par 1M. Exemple : 3 000 jetons d'entrée et 500 jetons de sortie coûtent $0,00045 + $0,00025 = $0,0007 par appel, donc 10 000 appels par mois coûtent $7. Les requêtes échouées ou refusées ne sont pas facturées, il n'y a pas d'abonnement et le crédit n'expire jamais.

Les recharges vont de $20 à $500, par crypto (USDT sur TRC20, USDC sur Base), avec un bonus de +5 % à partir de $50, +10 % à partir de $100 et +15 % à partir de $200. Pour un tableau comparant les différents choix de modèles, consultez comparaison des modèles IA et tarification. La page de tarification contient la liste complète.

Un motif de repli pour deux endpoints

Si vous voulez un second point de terminaison pour le contenu que votre fournisseur principal refuse, gardez les deux clients et choisissez par requête. Cette esquisse envoie une requête au fournisseur principal en premier et essaie le second lorsque la réponse est un marqueur de refus que vous définissez, ou lorsqu'un appel échoue :

import os
from openai import OpenAI

main = OpenAI(api_key=os.environ["MAIN_KEY"])
second = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",
    api_key=os.environ["NEW_PROVIDER_KEY"],
)

def ask(messages, main_model, use_second_first=False):
    order = [(second, "uncensored"), (main, main_model)] if use_second_first else [(main, main_model), (second, "uncensored")]
    last = None
    for client, model in order:
        try:
            r = client.chat.completions.create(model=model, messages=messages)
            return r.choices[0].message.content
        except Exception as err:
            last = err
    raise last

Acheminez par type de contenu lorsque c'est possible. Une fonctionnalité d'écriture d'histoire peut aller directement vers le deuxième endpoint avec use_second_first=True, tandis qu'un assistant de facturation reste sur le principal. Cela évite de payer pour un appel échoué en premier et maintient un comportement prévisible pour les utilisateurs.

Une méthode sûre pour tester

Ne réaffectez pas tout le trafic d'un coup. Réclamez l'essai de $0,50 sur la page clé API, qui ne nécessite pas de carte et dure 7 jours, puis exécutez ces étapes :

  1. Rejouez 20 vrais prompts de vos logs sur le nouvel endpoint.
  2. Comparez les réponses, les comptes de tokens et les échecs avec votre fournisseur actuel.
  3. Forcez un 429 et confirmez que votre nouvelle tentative fonctionne.
  4. Envoyez 5 % du trafic de production via un indicateur fonctionnel.
  5. Surveillez l'en-tête X-Balance-USD et votre taux d'erreur pendant quelques jours avant d'élargir.

La documentation couvre les méthodes, et le LLM de codage sans censure montre un cas d'utilisation détaillé par un développeur.

01

Questions et réponses

Puis-je utiliser le SDK OpenAI avec un autre fournisseur ?

Oui, si le fournisseur est compatible OpenAI. Définissez l'URL de base, la clé et le nom du modèle avec les valeurs du nouveau fournisseur.

Ce service est-il l'API d'OpenAI ?

Non. Il s'agit d'un endpoint indépendant compatible OpenAI exécutant un modèle à poids ouverts, et n'est pas l'API officielle d'OpenAI ou d'un autre fournisseur.

Prend-il en charge le streaming et les outils ?

Oui. Le streaming fonctionne via SSE avec stream: true, et l'appel d'outils utilise le format standard tools et tool_calls.

Que dois-je vérifier avant de changer ?

Les noms des modèles, les paramètres pris en charge, le comportement de l'appel de fonctions, les limites de la fenêtre de contexte, la gestion des erreurs 429 et, surtout, la façon dont le modèle répond à vos prompts réels.

Votre clé est à un formulaire de remplissage

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

Obtenir une clé API