Documentation

Roo Code

Le fournisseur OpenAI Compatible de Roo Code nécessite trois champs ainsi qu’un bloc de capacités du modèle. Ce bloc n’est pas une simple décoration facultative : c’est lui qui permet à Roo Code de calculer le budget de contexte.

Choisissez le fournisseur OpenAI Compatible, collez l’URL de base et la clé, puis définissez la fenêtre de contexte et la sortie maximale du modèle afin que le budget calculé par Roo Code soit correct.

Panneau des paramètres de Roo Code

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code utilise les appels d’outils natifs sans solution de repli ; le modèle choisi doit donc prendre en charge les appels d’outils compatibles avec OpenAI. Tous les id du tableau ci-dessous le font ; un modèle uniquement textuel ou multimédia configuré ici échouera dès que l’agent tentera d’utiliser un outil, et non au moment de la configuration.

Renseignez Fenêtre de contexte et Nombre maximal de jetons en sortie au lieu de conserver les valeurs par défaut. Roo Code détermine à partir de ces nombres quand condenser la conversation ; une fenêtre de contexte trop faible lui fait donc tronquer l’historique inutilement, tandis qu’une valeur trop élevée provoque des erreurs 400 en amont au lieu d’une condensation propre.

Pas encore de clé ? Créez un compte Kunavo, créez une clé (elle commence par sk-kn-) et ajoutez un crédit à partir de 10 $ — les appels sont payés sur ce solde et les appels échoués ne sont pas facturés. Le tableau de bord s’ouvre ensuite sur la configuration Roo Code.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Ouvrez le panneau des paramètres de Roo Code et définissez Fournisseur d’API sur OpenAI Compatible.
Saisissez l’URL de base https://api.kunavo.com/v1 et votre clé. Le suffixe /v1 doit figurer dans l’URL de base — Roo Code n’ajoute que le chemin.
Sélectionnez ou saisissez l’id du modèle, puis ouvrez Configuration du modèle et définissez la fenêtre de contexte, le nombre maximal de jetons en sortie, la prise en charge des images ainsi que les tarifs d’entrée et de sortie indiqués dans le tableau ci-dessous.
Envoyez un message en mode Code. Les tarifs saisis ici sont ceux utilisés par le calculateur de coût par tâche de Roo Code ; il est donc important de les renseigner correctement.

Vérifié avec Page du fournisseur OpenAI Compatible de Roo Code le 6 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Voici la version courte. Le guide complet — choix du modèle, coût d’une session réelle et modes d’échec — se trouve dans le guide pas à pas de Roo Code + Claude.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans Roo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Identifiant du modèle	Entrée / sortie sur Kunavo	Où cela s’intègre dans Roo Code
`claude-sonnet-5`	$1.40 / $7.00	Mode Code — le mode par défaut, sur lequel le calcul des coûts est étalonné
`claude-opus-5`	$3.50 / $17.50	Mode Architect, où un plan erroné coûte plus cher que les jetons
`claude-haiku-4-5`	$0.70 / $3.50	Mode Ask et lectures répétées de fichiers
`gpt-5-6-terra`	$0.70 / $4.20	parcours à long contexte dans un grand dépôt de code

La facturation se fait au token à partir d’un solde prépayé, sans frais mensuels — consultez la facturation. Avec un contexte répété — ce qu’envoient la plupart des éditeurs et clients de chat — la mise en cache des prompts influe davantage sur la facture que le choix du modèle.

Questions fréquentes

Comment configurer un point de terminaison OpenAI-compatible personnalisé pour Roo Code ?

Dans le panneau des paramètres de Roo Code, définissez Fournisseur d’API sur « OpenAI Compatible », puis renseignez l’URL de base et la clé API de ce point de terminaison, et choisissez un modèle. L’URL de base doit correspondre à la racine /v1 du service, car Roo Code n’y ajoute que le chemin. La documentation de Roo Code qualifie le champ URL de base de crucial : c’est lui qui détermine où chaque requête est envoyée.

Quels modèles fonctionnent avec Roo Code via un point de terminaison personnalisé ?

Tout modèle proposé par le point de terminaison qui prend en charge les appels d’outils natifs compatibles avec OpenAI. Roo Code utilise exclusivement les appels d’outils natifs, sans mode de repli ; un modèle dépourvu de cette prise en charge se connectera, puis échouera dès que l’agent tentera de lire ou d’écrire un fichier. Tous les modèles textuels Claude et GPT conviennent ; les modèles d’image, de vidéo et d’audio ne conviennent pas.

Que dois-je saisir dans Fenêtre de contexte et Nombre maximal de jetons en sortie de Roo Code ?

Les limites réelles du modèle sélectionné, et non les valeurs par défaut. Roo Code utilise ces deux nombres pour décider quand condenser la conversation ; une valeur inférieure au véritable contexte du modèle lui fait donc supprimer inutilement de l’historique, et une valeur supérieure provoque des erreurs 400 en amont au lieu d’une condensation propre. Les chiffres propres à chaque modèle figurent dans le catalogue des modèles du point de terminaison.

Pourquoi Roo Code indique-t-il un coût incorrect pour une tâche ?

Parce que les tarifs d’entrée et de sortie dans Configuration du modèle sont saisis manuellement et sont définis par défaut à zéro ou aux tarifs d’un autre fournisseur. Roo Code calcule entièrement son coût par tâche à partir de ces deux champs — il ne récupère pas les tarifs du point de terminaison — ; le résultat n’est donc aussi précis que les valeurs saisies. Copiez les tarifs du catalogue du fournisseur.