Documentation API
Intégrez l'API Open Router AI dans votre pile existante en mettant à jour votre URL de base et votre clé API. Cette compatibilité plug-and-play vous permet de générer du texte sans restriction à l'aide des protocoles OpenAI standard sans réécrire la logique de votre application.
URL de base et authentification
L'endpoint de l'API se trouve à https://api.openrouteraiapi.com/v1. Transmettez votre clé API dans le Authorization header en tant que jeton Bearer. Ce header est le seul changement nécessaire pour rediriger le trafic de votre fournisseur actuel vers notre modèle uncensored.
L'authentification est stricte. Si la clé est manquante ou invalide, le serveur renvoie immédiatement une erreur 401. Vous pouvez générer une clé instantanément via Google ou e-mail sur le tableau de bord. Gardez la clé en sécurité, car elle donne accès à votre crédit prépayé.
Point de terminaison Chat Completions
Envoyez des requêtes POST à /v1/chat/completions avec un tableau de messages. L'identifiant du modèle est uncensored. Ce modèle unique gère tous vos besoins de génération de texte sans logique de routage complexe.
Voici une requête standard utilisant cURL pour vérifier la connectivité et le format de réponse.
curl https://api.openrouteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
}'La réponse inclut le texte généré dans le choices[0].message.content champ. Vous pouvez analyser cela directement dans le flux de travail de votre application.
Intégration du SDK Python
Utilisez le client Python officiel d'OpenAI pour vous connecter sans effort. Définissez le base_url et api_key variables pour pointer vers notre infrastructure. Cette approche minimise les modifications de code lors du changement de fournisseur.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouteraiapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Le client gère la sérialisation et les tentatives automatiquement. Vous recevez un objet de complétion contenant le texte et les statistiques d'utilisation des jetons. Cette méthode est idéale pour les services backend et les scripts.
Utilisation du SDK Node.js
Initialisez le client Node.js OpenAI avec votre URL de base personnalisée. Cela permet aux applications JavaScript d'interagir avec le modèle uncensored en utilisant des méthodes familières. Le SDK gère efficacement les requêtes HTTP.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouteraiapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Appel chat.completions.create() avec vos messages. L'objet de réponse permet d'accéder au contenu généré et aux données d'utilisation. Cette intégration fonctionne bien pour les serveurs web et les fonctions edge.
Réponses en streaming
Activez le streaming en définissant stream: true dans votre requête. Le serveur retourne des Server-Sent Events (SSE) pour la livraison de tokens en temps réel. Cette fonctionnalité réduit la latence perçue pour les utilisateurs finaux.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Chaque chunk contient du contenu partiel. Le dernier chunk inclut les statistiques complètes d'utilisation des jetons. Gérez ces événements dans votre client pour mettre à jour l'interface utilisateur de manière incrémentale.
Limites, Erreurs et Fenêtre de contexte
La fenêtre de contexte prend en charge 100 000 tokens pour l'entrée et la sortie combinées. Chaque requête peut générer jusqu'à 16 000 tokens, ou 2 048 si max_tokens n'est pas défini. Les limites de débit permettent 300 requêtes par minute par clé.
Les erreurs sont des codes HTTP standard. Un 401 indique une clé invalide. Un 402 signifie que votre crédit prépayé est épuisé. Un 429 signale que vous avez dépassé la limite de débit. Les requêtes qui échouent ne consomment pas de crédit. Les erreurs sont gratuites.
Questions et réponses
Comment l'API open router AI gère-t-elle les échecs d'authentification ?
L'API retourne un code d'état 401 Unauthorized si l'en-tête est manquant ou si la clé est invalide. Cela se produit immédiatement lors de la requête. Vérifiez votre tableau de bord pour vous assurer que la clé est active et correcte.
Que se passe-t-il si je dépasse la limite de taux ?
Vous recevez une erreur 429 Too Many Requests. La limite est de 300 requêtes par minute par clé. Vous pouvez surveiller votre utilisation via le tableau de bord. Augmentez votre crédit ou attendez la réinitialisation de la fenêtre.
Le modèle sans censure est-il limité par une fenêtre de contexte de 100 000 tokens ?
Oui, la fenêtre de contexte totale est de 100,000 tokens pour l'invite et la complétion. Vous pouvez générer jusqu'à 16,000 tokens par requête. Cela permet un traitement extensif de documents sans interruption en plein milieu de la pensée.
Votre clé est à une étape de formulaire
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.
