Modèles OpenRouter gratuits pour Kilo Code : choix et vérification des outils

Choisissez un candidat, puis vérifiez les appels d'outils

Pour un premier essai gratuit dans Kilo Code, cohere/north-mini-code:free est un candidat concret. Son endpoint public annonce des prix d'entrée et de sortie nuls, tools et tool_choice. Ces métadonnées permettent de le retenir pour un petit test d'outils. Elles ne prouvent pas qu'il est le meilleur modèle pour votre dépôt.

Nous avons consulté la documentation officielle et téléchargé le catalogue public OpenRouter le 23 octobre 2026. Nous avons vérifié les commandes de métadonnées ci-dessous. Nous n'avons envoyé aucune requête d'inférence, testé aucun appel d'outil Kilo, mesuré aucune latence ni comparé la qualité du code. Partez de cet instantané daté, puis retenez un modèle qui réussit la même tâche dans votre version de Kilo.

Choisissez le fournisseur avant le modèle

Le fournisseur intégré de Kilo et une connexion directe à OpenRouter utilisent des comptes, des routes et des quotas distincts. Vérifiez le fournisseur de la configuration active avant de rechercher la cause d'un échec.

Connexion	Compte et contrôles	Sens de l'offre gratuite
Fournisseur Kilo via Kilo Gateway	Compte Kilo et routage géré par Kilo	Une offre Kilo telle que kilo-auto/free, soumise à ses conditions actuelles.
Fournisseur OpenRouter avec votre clé OpenRouter	Compte, activité, routage et limites OpenRouter	Une entrée gratuite exacte du catalogue ou openrouter/free.

Utiliser votre clé OpenRouter dans Kilo est parfois appelé BYOK. Cette connexion diffère du BYOK de fournisseurs OpenRouter, qui utilise la clé d'un fournisseur sous-jacent et possède ses propres règles de facturation. Ni le quota gratuit Kilo ni celui du fournisseur sous-jacent ne se transfèrent à une connexion directe OpenRouter. Consultez la comparaison officielle des connexions et la documentation du fournisseur Kilo.

Reproduisez le filtre de candidats gratuits

Exécutez cette commande dans Bash ou Zsh avec curl et jq installés. Elle lit le catalogue public, n'envoie ni identifiants ni contenu du dépôt et ne réalise aucune inférence. Le délai de 30 secondes limite ce téléchargement de métadonnées. Il ne configure pas la durée des tâches Kilo.

set -o pipefail
curl -fsS --max-time 30 https://openrouter.ai/api/v1/models |
    jq -er '
    .data
    | if type == "array" then . else error("missing data array") end
    | map(select(.id | endswith(":free")))
    | map(select((.pricing.prompt | tonumber?) == 0
        and (.pricing.completion | tonumber?) == 0))
    | map(select((.supported_parameters // []) | index("tools")))
    | if length > 0 then . else error("no matching candidates") end
    | sort_by(.id)[]
    | [.id, .pricing.prompt, .pricing.completion,
        .context_length, .top_provider.max_completion_tokens] | @tsv'

Chaque ligne donne l'ID exact, le prix d'entrée, le prix de sortie, le contexte et la limite de sortie du fournisseur principal annoncé au catalogue. Un prix absent ou non numérique ne passe pas. Une erreur HTTP, un JSON invalide ou une sélection vide termine la commande en échec. Examinez cet échec au lieu de prendre une ancienne capture pour la liste actuelle.

Notre instantané contenait 468 entrées. Dix-sept ID finissaient par :free, tous avaient des prix d'entrée et de sortie nuls et 16 indiquaient aussi tools. Nous avons exclu nvidia/nemotron-3.5-content-safety:free, sans tools. Le filtre exclut également les ID payants et les routeurs. L'option distincte openrouter/free est expliquée plus bas.

Ces deux exemples parmi les 16 candidats montrent pourquoi il faut aussi examiner la limite de sortie. Il s'agit de métadonnées, pas d'un classement des performances.

ID exact	Contexte, tokens	Sortie maximale du fournisseur principal, tokens	Test d'outil Kilo
cohere/north-mini-code:free	256000	64000	Non effectué
nvidia/nemotron-3-super-120b-a12b:free	262144	235929	Non effectué

Ces plafonds ne sont ni des tailles de prompt conseillées ni des garanties de réussite d'une longue requête. Instructions système, définitions d'outils, fichiers et anciens résultats consomment le contexte. La variante gratuite peut avoir des limites différentes du modèle payant. Relancez la commande quand vous reprenez un projet.

Examinez l'endpoint derrière l'entrée du catalogue

Le champ tools du modèle ne garantit pas que chaque route de fournisseur accepte votre requête. Avant d'imposer un fournisseur, consultez les métadonnées de ses endpoints. Ce second GET public affiche les endpoints actuels du premier exemple.

set -o pipefail
curl -fsS --max-time 30 \
    'https://openrouter.ai/api/v1/models/cohere/north-mini-code:free/endpoints' |
    jq '.data.endpoints[] | {provider_name, pricing, context_length,
        max_completion_tokens, supported_parameters, supports_tool_choice}'

Notre vérification a renvoyé un endpoint Cohere avec des prix de tokens nuls et les deux paramètres d'outils. Cela reste une capacité annoncée. Rien ne prouve encore que Kilo envoie des arguments valides ou exploite le résultat d'un outil.

La documentation du routage décrit tools comme une préférence par défaut. OpenRouter préfère les fournisseurs compatibles lorsqu'il en existe. Si aucun ne reconnaît le paramètre, celui-ci peut être ignoré. require_parameters: true exige la prise en charge de tous les paramètres transmis et peut donc ne laisser aucun fournisseur admissible.

Pour les versions décrites dans la page OpenRouter de Kilo, fusionnez la configuration de modèle suivante dans kilo.json. Conservez votre configuration de connexion. Kilo transmet les options du modèle sans les valider.

{
    "provider": {
        "openrouter": {
            "models": {
                "cohere/north-mini-code:free": {
                    "options": {
                        "provider": { "require_parameters": true }
                    }
                }
            }
        }
    }
}

Vérifiez séparément les politiques de données. L'avis de l'endpoint gratuit Nemotron annonce une journalisation de l'utilisation et interdit les données confidentielles ou personnelles. Si une exigence de confidentialité élimine le seul endpoint compatible, cessez d'utiliser cette route.

Effectuez un test manuel de lecture de fichier

Dans les réglages Kilo, ouvrez Providers, connectez OpenRouter avec une clé obtenue sur la page des clés, puis sélectionnez l'ID exact vérifié. Commencez une nouvelle tâche dans un dossier contenant uniquement un probe.txt sans données sensibles, avec une ligne distinctive. Ne mettez pas cette ligne dans le prompt et ne joignez pas le contenu comme contexte.

Utilisez ce prompt.

Lis probe.txt avec un outil de lecture de fichier et renvoie sa ligne exacte.
Ne modifie aucun fichier, ne lance aucune commande, ne consulte pas le web et n'utilise aucun outil externe.
Arrête-toi après avoir renvoyé la ligne.

1. Autorisez seulement la lecture prévue. Recherchez un véritable événement d'outil avec le bon chemin.
2. Vérifiez que la ligne correspond au fichier et que la tâche se termine. Une réponse devinée ou des instructions de lecture ne valident pas le test.
3. Annulez après cinq requêtes au modèle ou deux minutes, selon la première limite atteinte. Ce sont nos bornes de test conseillées, pas des limites du fournisseur.
4. Consultez l'activité OpenRouter pour relever modèle réel, fournisseur, nombre de requêtes et montant facturé. Arrêtez si le modèle ou le coût diffère de la route gratuite prévue.
5. Notez le résultat. Après une lecture réussie, testez une petite modification dans une autre tâche jetable et examinez son diff avant d'utiliser un vrai dépôt.

Date et version de Kilo :
Fournisseur choisi / ID demandé / modèle et fournisseur réels :
Prix du catalogue et options de routage :
Événement de lecture observé / ligne exacte / tâche terminée :
Requêtes / montant facturé / corps de l'erreur :
Verdict : non effectué, réussi ou échoué

Notre résultat d'acceptation est non effectué. Seules les métadonnées du catalogue et de l'endpoint ont passé la vérification. Compatibilité réelle de Kilo, coût, qualité des modifications et latence restent non mesurés. Une lecture réussie valide l'aller-retour d'outil de cette connexion, pas les performances de programmation. Les autres clients maintenus, comme Cline, nécessitent leurs propres tests, même avec le même ID OpenRouter. Les configurations Roo Code sont des références historiques : son extension, Cloud et Router ont fermé le 15 mai 2026.

Séparez sélection gratuite et contrôle des dépenses

L'ID exact :free doit exister. Ajouter ce suffixe à un ID payant ne le crée pas. openrouter/free choisit au hasard un modèle gratuit après filtrage des capacités. Utilisé seul, il reste parmi les modèles gratuits. Notez le modèle renvoyé. Pour une comparaison reproductible, choisissez un ID exact.

Les règles des variantes gratuites précisent qu'une liste de repli models peut poursuivre sur un modèle payant. Chaque modèle applique son tarif. Gardez toute la liste gratuite et contrôlez séparément les plugins ou services payants. Les crédits promotionnels règlent une facture sans modifier le prix. Un plafond de dépenses limite les frais autorisés sans rendre gratuite une route payante.

La politique publiée prévoit 20 requêtes par minute et 50 par jour pour les modèles gratuits. Le plafond quotidien passe à 1000 après des achats de crédits admissibles annoncés à 10 dollars. Cet achat est un paiement facultatif. Vérifiez le compteur et le niveau quotidiens réels avec free_model_daily_requests via GET /api/v1/key authentifié. Consultez limit_remaining et effective_budget pour les contrôles de dépenses applicables. La référence des limites décrit les exceptions et ajustements du seuil. Ne déduisez pas votre quota de is_free_tier seul. Les tentatives échouées peuvent consommer le quota quotidien et une tâche d'agent peut générer plusieurs requêtes.

Diagnostiquez l'erreur et fixez l'arrêt

Conservez le corps de l'erreur, l'ID de requête, le modèle choisi et le fournisseur. Consultez le guide des erreurs, y compris pour une erreur dans un flux commencé avec HTTP 200.

Symptôme	Distinguer la cause	Condition d'arrêt
429	Vérifiez X-RateLimit-*, Retry-After, les métadonnées du fournisseur et le compteur quotidien. Un quota OpenRouter et un fournisseur saturé exigent des réponses différentes.	Arrêtez au plafond quotidien. Pour une limite temporaire, respectez l'attente et autorisez au plus une nouvelle tentative manuelle. Arrêtez si elle échoue encore. Changer de modèle ne réinitialise pas le quota du compte.
404 mentionnant le modèle ou l'absence d'endpoints	Comparez l'ID exact au catalogue actuel, puis inspectez endpoints et restrictions de routage. Un ID existant peut n'avoir aucune route admissible.	Arrêtez jusqu'à correction de l'ID ou disponibilité d'une route autorisée. Réessayer ne crée pas d'endpoint. Ne supprimez pas une règle de confidentialité pour obtenir une réponse.
402 ou 403 de budget	Lisez error.metadata.limit_source et l'utilisation du compte avant de modifier les limites. Vérifiez replis payants, solde, plafonds de clé et budgets d'espace de travail.	Arrêtez le test gratuit si une route facturable inattendue apparaît. Identifiez la couche qui bloque avant de recharger le compte.
Erreur de contexte ou texte au lieu d'un outil	Vérifiez l'endpoint exact, les arguments, les approbations et le budget de contexte. Revenez au test d'un fichier.	Autorisez un test corrigé. Arrêtez si l'outil échoue encore ou si la borne de requêtes est atteinte.

Une restriction régionale peut aussi provoquer un 404, comme l'explique la documentation officielle du routage régional. Le code HTTP seul n'est pas un diagnostic.

Consultez notre page Kilo Code et le comparatif avec Cline pour les différences entre clients.