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.


Commencez avec le crédit d'essai
E-mail et mot de passe, la clé s'affiche tout de suite à l'écran.
Obtenir une clé APICe 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 :
- Rejouez 20 vrais prompts de vos logs sur le nouvel endpoint.
- Comparez les réponses, les comptes de tokens et les échecs avec votre fournisseur actuel.
- Forcez un 429 et confirmez que votre nouvelle tentative fonctionne.
- Envoyez 5 % du trafic de production via un indicateur fonctionnel.
- Surveillez l'en-tête
X-Balance-USDet 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.
Plus de guides
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.