FR ▾
Obtenir une clé API

Point de terminaison compatible OpenAI pour les clients OpenRouter

Un point de terminaison OpenAI compatible OpenRouter n'est qu'une URL de base qui utilise le format de chat OpenAI, donc le remplacer par un autre prend quelques lignes. Voici les valeurs exactes, les formes de requête et les erreurs que vous pourriez rencontrer.

Mis à jour le

Un seul câble reliant un terminal à un cube de modèle lumineux, représentant un point de terminaison API remplacé

Points clés

  • L'URL de base est https://api.openrouteralternativeapi.com/v1 et l'ID du modèle est uncensored.
  • L'authentification est un en-tête Bearer standard ; seuls POST /v1/chat/completions et GET /v1/models existent.
  • Le streaming, les outils et le mode JSON fonctionnent, mais les champs spécifiques au routeur ne sont pas pris en charge.
  • En cas d'erreur HTTP 429, lisez le code d'erreur pour distinguer une limite de débit d'une limite de concurrence.

Les valeurs dont vous avez besoin

Tout outil qui vous permet de modifier un point de terminaison de style OpenAI nécessite trois valeurs. Copiez-les depuis le tableau et rien ne change dans une configuration typique.

ParamètreValeur
URL de basehttps://api.openrouteralternativeapi.com/v1
Clé APICréé sur la page Clé API
ID du modèleuncensored
En-tête d'authentificationAuthorization: Bearer YOUR_API_KEY
Point de terminaison de chatPOST /v1/chat/completions
Route de liste des modèlesGET /v1/models

L'URL de base se termine déjà par /v1. La plupart des SDK ajoutent eux-mêmes /chat/completions, donc ne l'ajoutez pas deux fois. Certains outils demandent la route de chat complète ; dans ce cas, utilisez l'URL de base suivie de /chat/completions.

Ce que l'endpoint est et n'est pas

Derrière l'URL se trouve un seul modèle à poids ouverts, exécuté par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour un usage adulte légal. Ce n'est pas un routeur, donc une requête n'est jamais transférée à un autre fournisseur. Ce n'est pas non plus l'API officielle d'un fabricant de modèle. Cela a de l'importance pour la configuration : il n'y a pas de liste de slugs de modèles à choisir, pas de champ de préférence de fournisseur et pas de chaîne de secours. Vous envoyez uncensored et vous obtenez ce modèle unique.

Le service est uniquement textuel. La génération d'images, l'audio, la vidéo, les embeddings et le fine-tuning ne sont pas proposés, donc un client qui appelle /v1/embeddings ou une route d'images échouera sur cette URL de base. Conservez ces appels pointés vers le service que vous utilisez déjà pour eux, et définissez l'URL de base par fonctionnalité plutôt que globalement si votre application mélange plusieurs.

Un autre point de compatibilité concerne la liste des modèles. Un client qui appelle GET /v1/models au démarrage, pour remplir une liste déroulante ou valider un paramètre, recevra le modèle unique. C'est attendu. Si votre code vérifie qu'un nom de modèle configuré apparaît dans la liste, définissez le nom sur uncensored et la vérification réussira. Si votre application code en dur un nom de modèle de fournisseur quelque part au fond d'un fichier de configuration, recherchez-le dans le dépôt avant la première exécution, car une chaîne résiduelle est la raison la plus courante pour laquelle une application migrée échoue encore après que l'URL a été modifiée.

Première requête, trois façons

Commencez par une requête depuis le terminal. Cela prouve la clé, l'URL et l'ID du modèle avant qu'un framework ne soit impliqué.

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

curl https://api.openrouteralternativeapi.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ready."}],
    "max_tokens": 10
  }'

Le même appel avec le SDK Python. Notez que rien à part base_url et api_key ne diffère du code OpenAI standard.

from openai import OpenAI

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

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ready."}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

Et avec Node, en lisant la clé depuis une variable d'environnement :

import OpenAI from "openai";

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

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
  max_tokens: 10,
});
console.log(r.choices[0].message.content);

De nombreux outils lisent les variables d'environnement plutôt que les arguments du constructeur. Les SDK officiels honorent couramment OPENAI_BASE_URL et OPENAI_API_KEY, ce qui vous permet de rediriger un script non modifié. Consultez la documentation de votre version SDK pour confirmer les noms.

Streaming, outils et mode JSON

Les fonctionnalités dont dépendent la plupart des clients sont présentes. Définissez stream: true pour recevoir des événements envoyés par le serveur ; l'utilisation est rapportée à la fin du flux. L'appel d'outils accepte tools et tool_choice, diffuse des deltas tool_calls, et attend des résultats en tant que messages avec role: "tool". Le mode JSON est activé avec response_format: {"type":"json_object"}. Les champs d'échantillonnage temperature, top_p, stop, seed et les pénalités de fréquence et de présence sont transmis.

Un exemple de streaming en Python :

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write three short taglines for a coffee cart."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Et le mode JSON, qui vaut la peine d'être associé à une instruction dans le prompt qui nomme les clés que vous attendez :

r = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "Return JSON with keys title and tags (array of strings)."},
        {"role": "user", "content": "Summarise: a guide to brewing cold coffee at home."},
    ],
    response_format={"type": "json_object"},
)
print(r.choices[0].message.content)

Analysez toujours le résultat dans un bloc try de toute façon. Le mode JSON augmente les chances de sortie valide, mais votre code doit toujours gérer une réponse malformée, par exemple en réessayant une fois.

Conversations multi-tours et appels d'outils

L'endpoint est sans état, comme la route de chat OpenAI. Il ne se souvient pas des appels précédents, donc chaque requête doit contenir la conversation que vous souhaitez que le modèle voie. Gardez une liste de messages, ajoutez la réponse de l'assistant après chaque tour, et renvoyez toute la liste. Surveillez le total : la fenêtre de 100 000 tokens couvre le prompt et la complétion, et les longues conversations sont aussi ce qui fait augmenter le coût des entrées.

history = [{"role": "system", "content": "You answer in two sentences."}]

def chat(text):
    history.append({"role": "user", "content": text})
    r = client.chat.completions.create(model="uncensored", messages=history)
    reply = r.choices[0].message.content
    history.append({"role": "assistant", "content": reply})
    return reply

Pour l'appel d'outils, décrivez vos fonctions dans tools, exécutez ce que le modèle demande, et renvoyez la sortie en tant que message role: "tool" qui porte le tool_call_id correspondant. Une définition minimale ressemble à ceci :

tools = [{
    "type": "function",
    "function": {
        "name": "get_order_status",
        "description": "Look up an order by its number",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    },
}]

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Where is order 1042?"}],
    tools=tools,
    tool_choice="auto",
)
call = r.choices[0].message.tool_calls[0]
print(call.function.name, call.function.arguments)

Validez les arguments avant d'exécuter quoi que ce soit. Le modèle propose un appel ; votre code décide s'il est sûr de l'exécuter, surtout lorsque la fonction touche de l'argent, des fichiers ou les données d'autres personnes.

Champs à supprimer des requêtes de style OpenRouter

Les clients écrits pour un routeur ajoutent souvent des extras au corps de la requête ou aux en-têtes. Les exemples typiques sont l'ordre des fournisseurs, les tableaux de secours du modèle, les préférences de routage et les en-têtes d'attribution. Cette API ne les utilise pas. Les champs inconnus peuvent être ignorés ou peuvent causer une erreur, selon le champ, donc supprimez-les plutôt que de vous fier à l'un ou l'autre résultat.

  • Remplacez n'importe quel slug de modèle qui inclut un préfixe de fournisseur par uncensored.
  • Supprimez les listes de secours. Si le modèle unique n'est pas disponible, gérez-le dans votre propre logique de retry.
  • N'envoyez pas de parties de contenu image ou audio. Le modèle lit du texte.
  • Gardez le corps total de la requête en dessous de 8 MB.

La page docs montre les paramètres qui sont pris en charge, et c'est l'endroit où vérifier quand un champ se comporte différemment de ce que votre client attend.

Limites et réponses 429

Une clé complète permet 8 requêtes concurrentes et 300 requêtes par minute ; une clé d'essai permet 2 et 60. Chaque réponse porte X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency. Journalisez l'ID de requête avec chaque échec, car c'est la première chose que le support demandera.

Il y a trois types d'erreur HTTP 429. Le code d'erreur rate_limited signifie que vous avez dépassé les requêtes par minute : ralentissez. Le code concurrency signifie que trop de requêtes sont en cours en même temps : mettez-les en file d'attente. Un 429 avec un en-tête Retry-After: 5 signifie une surcharge temporaire : attendez cinq secondes et réessayez. Rappelez-vous qu'une requête en streaming garde sa place de concurrence jusqu'à la fin du flux, donc un client bloqué qui ne lit jamais jusqu'à la fin consommera de la capacité.

import time
from openai import OpenAI, RateLimitError

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

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

Définissez également un sémaphore de 8 ou moins autour des appels si vous exécutez des travailleurs en parallèle. C'est moins cher que d'apprendre la limite à partir d'erreurs. Ajoutez un peu de jitter aléatoire à l'attente pour que plusieurs travailleurs qui ont échoué ensemble ne réessayent pas tous dans la même seconde. Si vous voyez des réponses 429 répétées à faible trafic, recherchez des flux qui sont ouverts mais jamais fermés, ou une boucle de retry qui se déclenche sans attendre, car l'un ou l'autre peut remplir les places disponibles de lui-même.

Vérification des coûts avant de pointer la production dessus

La tarification est de $0,15 par 1M de tokens d'entrée et de $0,50 par 1M de tokens de sortie depuis le crédit prépayé. Prenons une requête avec 2 000 tokens d'entrée et 500 tokens de sortie. L'entrée coûte 2 000 / 1 000 000 x $0,15 = $0,0003. La sortie coûte 500 / 1 000 000 x $0,50 = $0,00025. La requête coûte $0,00055, donc 1 000 de ces requêtes coûtent $0,55. Les requêtes échouées ou refusées ne sont pas facturées. Voir la page de tarification pour les montants de rechargement et les bonus ; le crédit d'essai de $0,50 couvre environ 900 requêtes de cette taille (0,50 / 0,00055).

Questions et réponses

Quelle est l'URL de base de l'endpoint compatible OpenAI ?

Utilisez https://api.openrouteralternativeapi.com/v1 comme URL de base et envoyez votre clé en tant que jeton Bearer. L'ID du modèle est uncensored.

Quels endpoints sont disponibles ?

POST /v1/chat/completions pour la génération et GET /v1/models pour la liste des modèles. Il n'y a pas d'endpoints pour les embeddings, les images, l'audio ou le fine-tuning.

Dois-je modifier mon code au-delà de l'URL et de la clé ?

Généralement, uniquement le modèle. Supprimez les champs spécifiques au routeur, tels que les préférences de fournisseur ou les listes de secours, des corps de requête.

Pourquoi obtiens-je une erreur HTTP 429 ?

Vérifiez le code d'erreur. rate_limited signifie trop de requêtes par minute, concurrency signifie trop de requêtes simultanées, et un en-tête Retry-After: 5 indique une surcharge temporaire.

Il ne manque qu'un formulaire pour obtenir votre clé

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