Clés OpenRouter ai : Guide de démarrage rapide

URL de base & Authentification

Votre clé API authentifie chaque requête adressée à notre point de terminaison. Utilisez l'URL de base https://api.openrouteraikeys.com/v1 et passez votre clé dans le Authorization header. Cette configuration fonctionne avec n'importe quel SDK compatible OpenAI car nous imitons leur schéma d'authentification standard. Vous n'avez pas besoin de modifier votre bibliothèque cliente, seulement la configuration de l'URL de base.

• En-tête : Authorization: Bearer YOUR_API_KEY
• URL de base : https://api.openrouteraikeys.com/v1

Première demande

Envoyez une requête standard de complétion de chat pour tester la connectivité et le format de réponse. L'ID du modèle est uncensored et il accepte les tableaux de messages standard. Ce point de terminaison ne renvoie que du texte, ne vous attendez donc pas à des données image ou audio dans la charge utile de réponse.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Intégration du SDK Python

Initialisez le client avec votre clé et l'URL de base personnalisée. Cela vous permet d'utiliser l'interface familière chat.completions.create méthode sans envelopper de logique supplémentaire. La bibliothèque gère la sérialisation et la logique de retry automatiquement pour vous.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouteraikeys.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)

Intégration du SDK Node

Configurer le OPENAI_API_KEY et OPENAI_BASE_URL variables d’environnement ou passez-les directement au constructeur du client. Cela assure que toutes les requêtes ultérieures sont acheminées vers notre endpoint non censuré. Vous pouvez continuer à utiliser la même version du SDK que vous avez déjà installée.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraikeys.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);

Réponses en streaming

Activez le streaming en définissant stream: true dans votre requête. L'API renvoie des chunks Server-Sent Events (SSE) à mesure que le modèle génère du texte. Les statistiques d'utilisation des tokens apparaissent dans le dernier chunk du flux, vous permettant de suivre les coûts en temps réel sans attendre la réponse complète.

Copystream = 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)

Limites, Erreurs & Contexte

La fenêtre de contexte prend en charge 100 000 tokens au total pour l'invite et la complétion. Vous êtes limité à 300 requêtes par minute par clé. Une erreur 401 signifie que votre clé API est invalide ou manquante. Une erreur 402 indique un solde prépayé insuffisant. Une erreur 429 signale que vous avez dépassé la limite de débit. Les refus dus à la politique de contenu sont gratuits, mais les erreurs de calcul peuvent consommer des tokens.