Bien démarrer avec Max Router
Choisissez un modèle, créez une clé API et envoyez votre première requête avec Max Router.

Choisir un modèle et un point de terminaison
Dans le catalogue, comparez les modèles disponibles, leurs points de terminaison et leurs tarifs. Choisissez les entrées et sorties adaptées à votre application et notez l’identifiant exact du modèle.
Lorsqu’une intégration échoue, le plus difficile est souvent de savoir à quel niveau. Choisissez un modèle compatible avec une interface de conversation et posez une question courte. Gardez les images, outils, streaming et prompts complexes pour plus tard. Une requête simple permet de vérifier séparément l’adresse, la clé, l’identifiant du modèle et le format.
Le catalogue indique l’identifiant exact, les interfaces disponibles et le tarif actuel. Le nom affiché peut différer de celui attendu par le code : ne devinez ni ponctuation ni numéro de version. Une interface texte ne convient pas automatiquement à une tâche d’image ou de vidéo. Revérifiez les capacités et paramètres importants après tout changement de modèle.
Créer une clé API
Connectez-vous et créez une clé sur la page des clés API. Conservez-la dans une variable d’environnement ou un gestionnaire de secrets, jamais dans du code navigateur ou un dépôt public.
Utilisez des identifiants distincts pour limiter et examiner chaque environnement. Le serveur lit la clé depuis une variable d’environnement ou un gestionnaire de secrets. Un bundle frontend, une extension de navigateur ou un dépôt public ne garde pas un secret, même si la variable de compilation contient SECRET. Faites tourner une clé exposée et examinez son utilisation.
Une application rejoint des modèles de texte, d’image et de vidéo par une passerelle.Envoyer une requête
L’exemple utilise le point de terminaison de conversation. Remplacez YOUR_MODEL_ID par un modèle compatible et définissez MAX_ROUTER_API_KEY. Pour les images et vidéos, consultez la documentation du modèle.
curl https://maxrouterai.com/v1/chat/completions \
-H "Authorization: Bearer $MAX_ROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello!"}]}'
Vérifier le résultat
Vérifiez la réponse et les erreurs, puis consultez votre consommation dans le tableau de bord. Testez les paramètres nécessaires avant d’ajouter le streaming ou les outils.
Si la première requête échoue
Vérifiez l’identifiant du modèle et le point de terminaison indiqués dans le catalogue. Une erreur d’authentification demande de vérifier la clé et les droits ; un paramètre non pris en charge exige de modifier la requête. Ne publiez pas de clé : un identifiant de requête et une erreur anonymisée sont plus utiles.
Un statut HTTP réussi ne suffit pas : vérifiez le corps, les champs nécessaires et l’état de fin. En cas d’échec, conservez un identifiant de requête et une erreur anonymisée. Une erreur d’authentification demande de vérifier clé et droits ; un paramètre invalide exige une correction. Les limites ou pannes temporaires peuvent justifier un nombre limité de tentatives selon la documentation.
Décomposer une requête en trois étapes
Le navigateur envoie d’abord la demande à votre serveur. Celui-ci authentifie l’utilisateur, vérifie les données et appelle le modèle avec une clé conservée côté serveur. Il ne renvoie au navigateur que le résultat nécessaire : la clé de la plateforme ne doit pas être exposée dans le code client.
Pour trouver une panne, vérifiez successivement la liaison navigateur–serveur, l’envoi vers l’API et la réponse reçue. Un identifiant de requête, un statut et une durée sont souvent plus utiles que le journal complet d’une conversation. Comparez aussi une requête minimale en ligne de commande avec celle de votre application.
Trouver la cause dans la réponse
Un statut HTTP réussi ne suffit pas : vérifiez où se trouve le contenu et comment l’application traite une réponse vide, une raison de fin ou un refus du modèle. La structure dépend du protocole ; un chemin de champ valable pour un exemple n’est pas universel.
En cas d’erreur d’authentification, contrôlez la clé, son environnement, ses permissions et l’en-tête. Pour un paramètre invalide, repartez des champs obligatoires. Pour demander de l’aide, partagez l’identifiant et une erreur expurgée, jamais la clé ou les données privées. Si une clé a pu fuiter, révoquez-la ou remplacez-la.
Tester à petite échelle avant le lancement
Avant le lancement, testez une question courte, une entrée longue, un champ manquant, une clé invalide et une annulation. Vérifiez les états d’attente et d’erreur, les délais côté serveur et les doubles clics, avec des données non sensibles.
Faites ensuite essayer quelques tâches représentatives à une petite équipe et notez qualité, durée, consommation et échecs. Conservez le modèle, l’interface, les versions et la date du test pour pouvoir comparer après une modification.
Avancez progressivement
Après un petit essai réussi, utilisez une entrée représentative de votre application. Ajoutez les fonctions une à une, gardez les identifiants sur le serveur et consultez l’utilisation avant d’augmenter le trafic. La documentation du modèle précise ses limites et options actuelles.
Essayez des cas représentatifs sans données sensibles réelles et notez qualité, délai, utilisation et erreurs. Testez aussi une clé invalide, une coupure réseau et une annulation pour vérifier les messages affichés. Augmentez progressivement le trafic une fois le parcours stable. Capacités, prix et limites évoluent : revérifiez la documentation avant un lancement plus large.
Notez l’identifiant du modèle, l’interface, les réglages non sensibles et la date du premier essai réussi. Un petit cas de référence facilite la comparaison après modification d’une dépendance ou d’un modèle. N’y conservez ni clé ni contenu client complet. Pour demander de l’aide, partagez plutôt une requête minimale et une erreur anonymisée.