Connecter TokRouter à votre application

TokRouter expose une API compatible OpenAI. Une seule clé vous permet d'appeler les modèles activés dans votre catalogue.

Créer une clé API

1. Connectez-vous à TokRouter.
2. Ouvrez Paramètres.
3. Dans Clés API, donnez un nom à votre clé puis créez-la.
4. Copiez immédiatement la valeur affichée.

La clé en clair n'est affichée qu'une seule fois. Stockez-la dans un gestionnaire de secrets ou une variable d'environnement, jamais dans le code source.

Configuration compatible OpenAI

Remplacez https://tokrouter.mattok.ch par l'URL de votre instance TokRouter.

export OPENAI_API_KEY=sk-tok-...
export OPENAI_BASE_URL=https://tokrouter.mattok.ch/api/v1

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL,
});

const completion = await client.chat.completions.create({
  model: "identifiant-du-modele",
  messages: [{ role: "user", content: "Bonjour !" }],
});

console.log(completion.choices[0]?.message.content);

Utilisez l'identifiant affiché dans la page Modèles (colonne « Identifiant API »), et non nécessairement le nom public du modèle. Si un alias public a été configuré pour ce modèle, c'est cet alias qu'il faut utiliser ici — TokRouter le traduit vers le modèle réel en coulisses.

Configuration compatible Anthropic

Les outils Anthropic compatibles peuvent utiliser les variables suivantes :

export ANTHROPIC_AUTH_TOKEN=sk-ant-tok-...
export ANTHROPIC_BASE_URL=https://tokrouter.mattok.ch/api

Vérifier la connexion

Envoyez d'abord une demande courte à un modèle activé. Une erreur 401 indique généralement une clé absente, invalide ou révoquée. Une erreur 404 indique un identifiant de modèle incorrect. Une erreur 402 indique un solde insuffisant.