Utiliser OpenRouter dans une app pour ordinateur sur Mac, Windows et Linux

OpenRouter est une API : on accède à ses modèles via une app qui accepte une clé OpenRouter. Foxl, un agent IA gratuit pour ordinateur sur Mac, Windows et Linux, en fait partie. Créez une clé sur openrouter.ai, collez-la dans Foxl, et discutez avec n’importe quel modèle OpenRouter, gratuits compris, avec vos fichiers, votre navigateur et votre terminal à portée de main.

Voici ce que cela donne avec un modèle gratuit : Foxl lit un fichier de notes de réunion sur l’ordinateur et en tire un tableau des actions à mener, et la même conversation se poursuit depuis un iPhone, plus loin dans ce guide.

La méthode rapide : Se connecter avec OpenRouter au premier lancement

Depuis Foxl 0.8.2, sur un ordinateur où rien ne peut encore répondre à un chat (ni clé de modèle, ni connexion Claude ou ChatGPT, ni identifiants AWS, ni Ollama), la configuration du premier lancement se termine par un écran Connecter un modèle. Appuyez sur Se connecter avec OpenRouter, connectez-vous à OpenRouter dans votre navigateur et autorisez Foxl. OpenRouter crée une clé, Foxl l’enregistre sur cet ordinateur, et les chats démarrent sur les modèles gratuits d’OpenRouter (openrouter/free), soumis à une limite quotidienne.

Vous avez déjà une clé, ou un autre modèle à configurer d’abord ? J’ai une clé, sur le même écran, accepte une clé collée, et les étapes ci-dessous font la même chose depuis Configuration, à tout moment.

Étape 1 : créer une clé API OpenRouter

1. Connectez-vous sur openrouter.ai et ouvrez la page Keys.
2. Créez une clé. OpenRouter demande un nom et une limite de crédits, ou aucune limite. Une limite est un filet de sécurité peu coûteux si la clé venait à fuiter.
3. Copiez la clé. Elle commence par sk-or-, et c’est aussi ce que Foxl vérifie.

Vous n’avez pas besoin de crédits pour utiliser les modèles gratuits. Il vous en faut pour les modèles payants, et en acheter relève aussi la limite quotidienne des modèles gratuits (voir plus bas).

Étape 2 : ajouter la clé à Foxl

1. Téléchargez Foxl sur foxl.ai et connectez-vous. Il fonctionne sur macOS 13 ou version ultérieure, Windows 10 ou version ultérieure (64 bits) et Linux x86-64 (AppImage).
2. Ouvrez Configuration, puis Modèle et fournisseur.
3. Sous Fournisseur IA, réglez Fournisseur sur OpenRouter.
4. Collez la clé dans Clé API ou token et enregistrez-la. Foxl charge alors le catalogue de modèles d’OpenRouter en direct : les nouveaux modèles apparaissent sans mise à jour de Foxl.
5. Choisissez un Modèle par défaut et appuyez sur Enregistrer les paramètres du fournisseur.

Vos chats et votre mémoire restent sur votre ordinateur. Ce que vous envoyez dans un chat part chez OpenRouter et chez le fournisseur du modèle qui se trouve derrière, selon leurs propres règles.

N’utiliser que des modèles gratuits

Sur OpenRouter, un modèle gratuit est une variante dont l’identifiant se termine par :free. Pour les parcourir sur le site, filtrez la page des modèles par prix. Il existe aussi openrouter/free, un routeur qui choisit au hasard, pour chaque requête, l’un des modèles gratuits disponibles.

Dans Foxl, activez Modèles gratuits uniquement dans les paramètres OpenRouter pour ne lister que les variantes :free. Cet interrupteur masque aussi openrouter/free, car son identifiant ne se termine pas par :free ; désactivez-le pour choisir le routeur.

Les limites des modèles gratuits

OpenRouter limite les requêtes aux modèles gratuits selon le total des crédits que vous avez achetés, depuis toujours :

OpenRouter accorde la limite quotidienne la plus élevée dès 9 crédits, pour absorber les frais d’achat. Les variantes payantes d’un modèle n’ont pas de plafond de requêtes au niveau de la plateforme. Un solde négatif peut renvoyer des erreurs 402, même sur les modèles gratuits.

Pour savoir où vous en êtes, ouvrez le panneau Compte dans les paramètres OpenRouter de Foxl et appuyez sur Vérifier : il affiche les requêtes aux modèles gratuits du jour par rapport à votre limite, vos crédits et ce que cette clé a dépensé.

Acheter des crédits

Les crédits sont en dollars américains et s’achètent sur la page Credits d’OpenRouter. OpenRouter prélève des frais de 5,5 % (0,80 $ minimum) sur les achats par carte, et de 5 % en cryptomonnaie. Dix dollars de crédits suffisent pour porter la limite quotidienne des modèles gratuits à 1000.

Les modèles gratuits et vos données

OpenRouter indique ne pas acheminer de requêtes vers les fournisseurs qui journalisent les prompts, ou dont il ne peut pas confirmer la politique, sauf si vous activez l’entraînement des modèles dans ses paramètres de confidentialité. Ces paramètres sont distincts pour les modèles payants et les modèles gratuits : vérifiez celui des modèles gratuits avant d’envoyer quoi que ce soit de privé à un modèle gratuit.

L’utiliser depuis votre iPhone

Le téléphone n’a pas besoin de sa propre clé OpenRouter. Un message envoyé depuis le téléphone s’exécute sur votre ordinateur : la clé reste donc sur l’ordinateur et n’est jamais envoyée au téléphone.

1. Sur l’ordinateur, ouvrez Configuration, puis Connexion > Mobile/Web. L’état doit indiquer En ligne ; sinon, appuyez sur Activer l’accès distant.
2. Sur l’iPhone, installez l’app Foxl et connectez-vous avec le même compte. Il n’y a pas de code d’appairage : un point vert à côté de Foxl Agent dans la barre latérale signifie que l’ordinateur est connecté.
3. Ouvrez un chat. Les chats de votre ordinateur sont listés dans la barre latérale (un nouveau peut mettre un moment à apparaître) : vous pouvez reprendre celui que vous avez commencé à votre bureau.
4. Touchez le nom du modèle sous la zone de message et choisissez un modèle OpenRouter, par exemple Free Models Router. La liste est celle de votre ordinateur. Le téléphone retient votre choix, et un message envoyé depuis le téléphone fait aussi passer l’ordinateur sur ce modèle.

L’ordinateur doit être éveillé et en ligne. Android fonctionne de la même façon avec l’APK de foxl.ai, tout comme app.foxl.ai dans un navigateur.

Les questions qu’on se pose

Foxl est-il gratuit avec OpenRouter ?

Oui. Foxl est gratuit à télécharger et ne vend rien dans l’app. OpenRouter vous facture directement les modèles payants, et les modèles gratuits ne coûtent rien dans la limite de ses quotas quotidiens.

Combien de requêtes gratuites par jour OpenRouter autorise-t-il ?

Tant que vous n’avez pas acheté au moins 10 crédits au total, les modèles gratuits permettent 50 requêtes par jour et 20 par minute. Ensuite, la limite quotidienne passe à 1000. Ce sont les limites d’OpenRouter, pas celles de Foxl.

Quels modèles OpenRouter Foxl affiche-t-il ?

Foxl lit le catalogue de modèles d’OpenRouter en direct une fois votre clé enregistrée. Activez Modèles gratuits uniquement pour ne voir que les variantes gratuites.

Est-ce que ça fonctionne sous Windows et Linux ?

Oui. Foxl Agent fonctionne sur macOS 13 ou version ultérieure, Windows 10 ou version ultérieure (64 bits) et Linux x86-64, sous forme d’AppImage.

Puis-je utiliser les modèles OpenRouter depuis mon téléphone ?

Oui. Activez l’accès distant dans Foxl sur votre ordinateur, connectez-vous à l’app Foxl pour iPhone avec le même compte, et choisissez un modèle OpenRouter dans le menu des modèles du téléphone (l’ordinateur passe aussi sur ce modèle). Les chats s’exécutent sur l’ordinateur avec votre clé OpenRouter, qui y reste.