Documentation MegaRouter

Commencer

Créer une clé API

1. Accédez à megarouter.com, choisissez la méthode de connexion, et autorisez
2. Accédez à Console → Paramètres → Clés API → Créer une clé

2. Auto routage (optionnel)

Le routage automatique est activé par défaut. Pour le contrôler :

Console → Paramètres → Routage → Routage automatique

Une fois activé, MegaRouter sélectionne automatiquement le meilleur modèle pour chaque requête. Si vous préférez choisir les modèles vous-même, ignorez cette étape et spécifiez les modèles directement (par ex. anthropic/claude-sonnet-4.6).

Configuration standard

Entièrement compatible avec l'API OpenAI. Prend en charge Python, Node.js, curl et les outils de l'écosystème.

Remplacez l'URL de base ( https://api.megarouter.com/openai/v1 ) et la clé API pour commencer à l'utiliser.

from openai import OpenAI

client = OpenAI(
    api_key="MEGAROUTER_API_KEY",  # get MEGAROUTER_API_KEY from megarouter.com (API Key)
    base_url="https://api.megarouter.com/openai/v1",
)

completion = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "system prompt"},
        {"role": "user", "content": "how are you?"}
    ],
)

# get the response from LLM (role=assistant)
print(completion.choices[0].message.content)

{
    "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Hello! Nice to meet you. How can I help you?"
            },
            "finish_reason": "stop"
        }
    ],
    "created": 1773408946,
    "model": "deepseek.v3-v1:0",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 5,
        "completion_tokens": 15,
        "total_tokens": 20
    }
}

OpenClaw Setup

Si vous avez déjà installé OpenClaw, suivez les étapes ci-dessous pour connecter MegaRouter.

Connecter MegaRouter

Méthode 1 : console Web

1. Démarrer la console web

Dans un terminal, exécutez :

openclaw dashboard

Le navigateur ouvrira la console (généralementhttp://127.0.0.1:18789). Si le navigateur ne s'ouvre pas automatiquement, veuillez vous rendre manuellement sur cette adresse.

2. Accédez à la page de configuration

Sélectionner Config → Mode brut.

3. Ajouter la configuration MegaRouter

Ajoutez une variable d'environnement et définissez MEGAROUTER_API_KEY comme votre clé API MegaRouter :

env: {
    vars: {
      MEGAROUTER_API_KEY: 'sk-or-v1-xxxxxxxxxxxxxxxx',
    },
  },

Ajouter des modèles avec baseUrl défini sur https://api.megarouter.com/openai/v1:

models: {
  mode: 'merge',
  providers: {
    megarouter: {
      baseUrl: 'https://api.megarouter.com/openai/v1',
      apiKey: '${MEGAROUTER_API_KEY}',
      api: 'openai-completions',
      models: [
        {
          id: 'megarouter/auto',
          name: 'MegaRouter Auto',
          api: 'openai-completions',
          reasoning: false,
          input: ['text'],
          cost: {
            input: 0,
            output: 0,
            cacheRead: 0,
            cacheWrite: 0,
          },
          contextWindow: 200000,
          maxTokens: 8192,
        },
      ],
    },
  },
},

Remplacer la section originale "agents": {...} par :

agents: {
  defaults: {
    model: {
      primary: 'megarouter/auto',
    },
    models: {
      'megarouter/auto': {
        alias: 'MegaRouter Auto',
      },
    },
  },
},

4. Enregistrer et appliquer la configuration

Console Web : Cliquez sur Enregistrer en haut à droite, puis sur Mettre à jour.

5. Vérifier la connexion

Dans OpenClaw Chat, envoyez un message test tel que « Hello ». Si la configuration est correcte, l'API MegaRouter est appelée → automatiquement routée vers le meilleur modèle → une réponse est renvoyée.

Méthode 2 : Modifier le fichier de configuration

1. Localisez le fichier openclaw.json.

macOS :

Ouvrez Finder et appuyez sur Commande + Maj + G

Entrer :~/.openclaw

Appuyez sur Entrée pour voiropenclaw.json.

Windows :

CheminC:\Users\<YourUsername>\.openclaw\openclaw.json

2. Ajouter la configuration MegaRouter

Ajoutez une variable d'environnement et définissez MEGAROUTER_API_KEY comme votre clé API MegaRouter :

"env": {
  "vars": {
    "MEGAROUTER_API_KEY": "sk-or-v1-xxxxxxxxxxxxxxxx"
  }
},

Ajouter des modèles avec baseUrl défini sur https://api.megarouter.com/openai/v1:

"models": {
  "mode": "merge",
  "providers": {
    "megarouter": {
      "baseUrl": "https://api.megarouter.com/openai/v1",
      "apiKey": "${MEGAROUTER_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "megarouter/auto",
          "name": "MegaRouter Auto",
          "api": "openai-completions",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
},

Remplacer la section originale 'agents' : {...}, par :

"agents": {
  "defaults": {
    "model": {
      "primary": "megarouter/minimax/minimax-m2.5"
    },
    "models": {
      "megarouter/auto": {
        "alias": "MegaRouter Auto"
      }
    }
  }
},

3. Enregistrer et vérifier la configuration

Après avoir enregistré le fichier de configuration, exécutez la commande suivante dans un terminal pour afficher le fichier et vérifier qu'il est correct :

cat ~/.openclaw/openclaw.json

4. Vérifier la connexion

Exécutez la commande suivante dans un terminal local pour lancer une conversation CLI :

openclaw tui

Ou exécutez la commande suivante pour utiliser OpenClaw Chat dans le navigateur :

openclaw dashboard

Configuration optionnelle

Routage auto de modèle

MegaRouter recommande de définir le mode principal sur megarouter/auto.

Sélectionne automatiquement le meilleur modèle par prix, latence et disponibilité.

Utiliser un modèle spécifique

Pour utiliser un modèle fixe, p. ex. définir le modèle principal sur megarouter/deepseek/deepseek-v3.2

FAQ

1. Seuls les modèles OpenAI réussissent ; les autres échouent.

   Les modèles disponibles via MegaRouter utilisent le protocole compatible OpenAI. Dans les paramètres d'intégration OpenClaw, définissez le champ api suropenai-completions(comme dans les exemples ci-dessus). Si les modèles de la famille OpenAI fonctionnent mais que tous les autres échouent, vérifiez leprovidersentrée : leapiTaper.

2. Modèle introuvable ou réponse vide

   Confirmez que l'orthographe de l'ID du modèle est correcte ; le configuréproviderle nom correspond à ce que vous référencez ; etreasoningdoit être défini surfalse.

Configuration QClaw

Si vous avez déjà OpenClaw installé, suivez les étapes ci-dessous pour connecter MegaRouter.

Configurer dans la discussion

1. Dans la discussion, envoyez le message ci-dessous. Remplacez la valeur apiKey par votre clé API MegaRouter.

Aidez-moi à ajouter un fournisseur
Nom : MegaRouter
apiKey : sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl : https://api.megarouter.com/openai/v1
Modèles (vous pouvez en passer plusieurs) : 1. auto 2. deepseek/deepseek-v3.2

QClaw ajoutera le fournisseur et redémarrera automatiquement.

2. Vérifier

Demandez : « Aidez-moi à vérifier que ma configuration MegaRouter fonctionne. » L'assistant doit répondre par quelque chose comme « Le fournisseur MegaRouter a été ajouté avec succès ! » (le libellé exact peut varier.)

3. Passer à MegaRouter

Demandez : « Passez en mode Auto dans MegaRouter. » L'assistant doit répondre par quelque chose comme « Passé avec succès ! » (le libellé exact peut varier.)

Configuration AutoClaw

Ouvrir l'entrée de configuration

Cliquer sur Préférences en bas à gauche, aller dans Modèles et API, puis cliquer sur Ajouter un modèle personnalisé.

2. Ajouter un modèle

• Définissez le fournisseur sur Personnalisé.
• Saisissez un ID de modèle compatible MegaRouter, p. ex. deepseek/deepseek-v3.2.
• Saisissez un nom d'affichage, par exemple MegaRouter(deepseek-v3.2).
• Saisissez votre clé API, p. ex. sk-or-v1-xxxxxxxxxxxxxxxx.
• URL de base : https://api.megarouter.com/openai/v1

3. Tester la configuration

Cliquez sur le test de connexion. Si vous voyez « Test réussi », la configuration est correcte.

4. Utiliser le modèle

• Cliquez sur Ajouter. Après l'enregistrement, revenez à l'app.
• Sous le champ de discussion, passez à votre modèle configuréMegaRouter(deepseek-v3.2)l'utiliser

Configuration de Cursor

Si vous avez déjà installé Cursor, suivez ces étapes pour connecter MegaRouter.

1. Ouvrir les paramètres de Cursor

Utilisez le menu en haut à droite → Paramètres.

2. Modèles

Dans la barre latérale gauche :

• Modèles ouverts.
• Sélectionnez Afficher tous les modèles, faites défiler vers le bas, puis ajoutez un modèle personnalisé.
• Saisissez l'ID de modèle spécifique, p. ex. deepseek/deepseek-v3.2. N'utilisez pas « auto ».

3. Ajouter MegaRouter

Configurer l'accès API :

• Développer les clés API.
• Collez votre clé API MegaRouter.
• Définir l'URL de base sur https://api.megarouter.com/openai/v1

4. Enregistrez et fermez la page Paramètres.

5. Utiliser MegaRouter dans Cursor

Dans Discussion, Composer ou Agent, choisissez votre modèle MegaRouter dans le menu déroulant des modèles.

Configuration Hermes

Prérequis

• Créer unClé APIdans la console MegaRouter.
• Si vous utilisez le routage automatique, activez-le dans Paramètres → Routing dans la console.

Option 1 : Configuration du terminal

1. Choisir le modèle et le point de terminaison personnalisé

Exécutez dans votre terminal :

hermes model

Dans le menu, choisissez endpoint personnalisé et remplissez les champs :

Si une longueur de contexte vous est demandée, appuyez sur Entrée pour laisser le champ vide (Hermes le détectera).

2. (Optionnel) Tableau de bord web local

Pour modifier la configuration dans le navigateur, exécutez :

hermes dashboard

3. Vérifier

hermes chat "Hello"

Le succès signifie que la requête a atteint MegaRouter et que le smart routing ou le modèle que vous avez choisi a renvoyé un résultat.

Vous pouvez aussi exécuterhermes doctorpour vérifier la connexion.

Option 2 : Modifier les fichiers de configuration

1. Emplacements des fichiers

macOS / Linux

• ~/.hermes/config.yaml, config principale (modèle, fournisseur, base_url, api_key, etc.)
• ~/.hermes/.env, secrets et variables d'environnement (recommandé)

Windows:

• C:\Users\<username>\.hermes\config.yaml
• C:\Users\<username>\.hermes\.env

2. Sauvegarder la clé API dans.env(pick one)

Option A (même nom que MegaRouter)

# MegaRouter API 密钥
MEGAROUTER_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

Option B (convention courante d'endpoint personnalisé Hermes)

SiClé API du modèlen'est pas défini pour un endpoint personnalisé, Hermes retombe surOPENAI_API_KEY. Saisissez votre clé MegaRouter ici :

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

docs.hermes.m2s3ZhBeforeconfig.yamldocs.hermes.m2s3ZhMidModèle

Routage auto (auto)

model:
  default: auto
  provider: custom
  base_url: https://api.megarouter.com/openai/v1
  api_key: ${MEGAROUTER_API_KEY}

Si option B, laissez videClé APIEffacez ou supprimez pour que Hermes l'utilise.OPENAI_API_KEY.

Hermes s'étend${VAR}lors du chargement de la configuration (les variables doivent exister dans l'environnement, généralement depuis~/.hermes/.env).

Exemple de modèle fixe

L'ID du modèle doit correspondre àListe des modèles MegaRouter.

model:
  default: deepseek/deepseek-v3.2
  provider: custom
  base_url: https://api.megarouter.com/openai/v1
  api_key: ${MEGAROUTER_API_KEY}

4. Vérifier après enregistrement

Après enregistrement, exécuterhermes chat "Hello"vérifier la connexion MegaRouter.

Plusieurs routes / modèles

docs.hermes.multiSeg1Autodocs.hermes.multiSeg2deepseek/deepseek-v3.2docs.hermes.multiSeg3config.yamldocs.hermes.multiSeg4fournisseurs personnalisésdocs.hermes.multiSeg5megarouter-autodocs.hermes.multiSeg6

model:
  default: auto
  provider: custom
  base_url: https://api.megarouter.com/openai/v1
  api_key: ${MEGAROUTER_API_KEY}

custom_providers:
  - name: megarouter-auto
    base_url: https://api.megarouter.com/openai/v1
    api_key: ${MEGAROUTER_API_KEY}
    model: auto

  - name: megarouter-deepseek
    base_url: https://api.megarouter.com/openai/v1
    api_key: ${MEGAROUTER_API_KEY}
    model: deepseek/deepseek-v3.2

Comment basculer

1. Terminal : exécuterhermes modelréessayez, puis sélectionnez une route nommée ou un point de terminaison personnalisé.
2. Dans la discussion (TUI) : utiliser le/modelSyntaxe des docs Hermes, par exemple :

/model custom:megarouter-auto:auto
/model custom:megarouter-deepseek:deepseek/deepseek-v3.2

(Noms suiventcustom_providers[].name; format estcustom:<profile name>:<model id>.)

FAQ

Référence API

Endpoints

Modèles

Format de l'ID de modèle : provider/model-name. Les numéros de version utilisent le point (ex. 4.6), pas le tiret (-).

Pour plus de modèles, visitez leModèlespage.

Dépannage