Si vous maintenez encore des installations de Roo Code, la voie API compatible OpenAI de Roo Code est surtout une surface de configuration : type de fournisseur, URL de base, clé API et ID du modèle. Le risque de production est la partie qu’il est facile de manquer. La documentation des fournisseurs de Roo Code exige un appel d’outils natif de style OpenAI pour ce chemin, donc une simple réponse de chat ne suffit pas à prouver un flux de travail d’agent de codage.
Ce guide montre comment acheminer des configurations Roo Code existantes via Flatkey pour les développeurs, les équipes produit IA, les concepteurs d’automatisation, les ingénieurs de plateforme, les opérationnels finance et les relecteurs achats. Il couvre l’avertissement actuel de Roo Code, la validation de l’URL de base Flatkey, les alias exacts des modèles, le test préalable natif d’appel d’outils, les paramètres Roo Code, la revue de l’utilisation et le retour arrière.
Note de source : cela a été vérifié le 29 juin 2026 par rapport à la page d’accueil officielle de la documentation Roo Code, à la documentation officielle du fournisseur OpenAI Compatible de Roo Code, aux pages publiques en direct de Flatkey, et à un test rapide authentifié de la passerelle Flatkey. La page d’accueil de la documentation de Roo Code indique que l’extension Roo Code a été arrêtée le 15 mai 2026 ; considérez donc ceci comme un guide de configuration pour des installations existantes, des configurations archivées ou une revue de migration, plutôt que comme une recommandation de standardiser un nouveau déploiement sans vérifier la disponibilité de l’extension.
Réponse rapide : configuration de l’API compatible OpenAI de Roo Code
Pour une configuration API compatible OpenAI de Roo Code avec Flatkey, choisissez OpenAI Compatible comme fournisseur d’API, collez une URL de base Flatkey actuelle, utilisez une clé API Flatkey, et saisissez un alias exact du modèle Flatkey qui prend en charge le chat compatible OpenAI et les appels d’outils natifs. Prouvez ensuite la route avec une petite requête curl avant de lui faire confiance dans un espace de travail de code.
| Champ Roo Code | Valeur Flatkey | Vérification |
|---|---|---|
| Fournisseur d’API | OpenAI Compatible | Utilisez ce fournisseur pour Flatkey, et non le fournisseur OpenAI officiel. |
| URL de base | L’URL de base actuelle du fournisseur Flatkey pour votre compte, par exemple https://router.flatkey.ai/v1 lorsque c’est la valeur vérifiée |
Collez uniquement l’URL de base. Ne collez pas le point de terminaison complet /chat/completions dans Roo Code. |
| Clé API | Une clé Flatkey appartenant au bon utilisateur, à la bonne équipe ou au bon environnement | Ne mélangez pas les clés du fournisseur amont avec l’URL de base Flatkey. |
| ID du modèle | L’alias exact du modèle Flatkey activé pour cette clé | Confirmez que l’alias prend en charge le point de terminaison de chat OpenAI et les appels d’outils natifs avant de l’utiliser pour des tâches de codage. |
| Validation | Petit test de chat et d’appel d’outil, puis une invite Roo Code sûre | Vérifiez l’utilisation Flatkey après le test afin que les responsables finance et plateforme puissent rapprocher la route. |
La voie la plus courte et la plus sûre est la suivante : prouver le transport Flatkey, prouver l’alias du modèle, prouver l’appel d’outils natif, puis enregistrer les paramètres Roo Code. Le reste de ce guide API compatible OpenAI de Roo Code transforme cela en checklist reproductible.
Ce que confirment les docs Roo Code actuelles
La page d’accueil de la documentation Roo Code affiche actuellement un avertissement de fermeture de l’extension. Cela compte pour la planification. Si votre équipe utilise une installation Roo Code existante, les détails de configuration ci-dessous restent utiles pour la maintenance et la revue de migration. Si votre équipe choisit un nouvel assistant de codage standard, vérifiez d’abord l’état de l’extension, de la marketplace et du fork avant d’attribuer Roo Code à un groupe plus large.
La page du fournisseur OpenAI Compatible de Roo Code documente trois valeurs principales pour cette classe de fournisseur : URL de base, clé API et ID du modèle. Elle indique aussi de sélectionner OpenAI Compatible comme fournisseur d’API. L’URL de base est le point de terminaison du fournisseur et n’est explicitement pas l’URL officielle de l’API OpenAI lorsque vous utilisez un fournisseur non compatible OpenAI.
La contrainte importante propre à Roo est l’appel d’outils. La même page du fournisseur indique que Roo Code utilise exclusivement l’appel d’outils natif et qu’il n’existe pas de solution de repli basée sur XML. Elle précise aussi que le modèle sélectionné doit prendre en charge l’appel d’outils compatible OpenAI. Pour une route API compatible OpenAI de Roo Code via Flatkey, cela signifie que l’alias du modèle ne peut pas être validé par la seule génération de texte brut.
Valeurs Flatkey à confirmer avant d’ouvrir Roo Code
1. Confirmez l’URL de base de votre compte
La page d’accueil de Flatkey, vérifiée le 29 juin 2026, porte le titre Une passerelle API unique pour les équipes IA de production et une méta-description indiquant que Flatkey unifie l’accès aux modèles, le routage, la facturation, l’analyse de l’utilisation et les contrôles opérationnels. Les exemples publics de la page d’accueil incluent des complétions de chat de style OpenAI. Une vérification d’exécution authentifiée pour cet article a utilisé https://router.flatkey.ai/v1 et a renvoyé une liste de modèles valide.
Comme les exemples publics et les routes spécifiques au compte peuvent varier dans le temps, copiez l’URL de base Flatkey actuelle depuis votre console, votre documentation ou votre environnement de travail avant la production. Dans Roo Code, l’URL de base doit être la base du fournisseur, et non /v1/chat/completions.
2. Confirmez l’alias du modèle et la prise en charge des outils
La page de tarification de Flatkey, consultée le 29 juin 2026, indique qu’elle publie des tarifs rendus côté serveur pour 635 modèles d’IA auprès de 23 fournisseurs. Sa carte des points de terminaison comprend /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations et /v1/video/generations. Il s’agit d’une preuve du catalogue et des points de terminaison, pas d’une promesse que chaque clé Flatkey puisse appeler chaque modèle.
Pour une configuration API compatible OpenAI de Roo Code, choisissez un alias de modèle visible dans le compte qui prend en charge les conversations compatibles OpenAI et les appels d’outils. La vérification authentifiée pour cet article a renvoyé 56 modèles visibles dans le compte, et une petite requête d’appel d’outil avec gpt-5.4-mini a renvoyé HTTP 200 avec finish_reason: tool_calls et des métadonnées d’utilisation. Considérez cela comme une preuve datée du routage pour le compte testé, et non comme une recommandation permanente pour chaque espace de travail Flatkey.
3. Confirmer la propriété de la clé et la revue de l’utilisation
Roo Code peut agir sur un espace de travail de code, donc la propriété de la clé est importante. Utilisez une clé Flatkey limitée au développeur, à l’équipe ou à l’environnement qui assume le risque. Notez qui peut faire pivoter la clé, quel alias de modèle est autorisé, quelle famille de points de terminaison est attendue, et où le journal d’utilisation sera examiné après la première invite.
Étape par étape : configurer Roo Code avec Flatkey
- Vérifiez s’il s’agit d’une installation Roo Code existante. Comme la documentation officielle mentionne actuellement l’arrêt de l’extension, ne partez pas du principe qu’une nouvelle installation depuis la place de marché est disponible.
- Ouvrez les paramètres du fournisseur Roo Code. Dans la configuration de l’extension existante, allez à la zone du fournisseur de modèle ou de configuration de l’API.
- Sélectionnez OpenAI Compatible. Utilisez le type de fournisseur documenté par Roo Code pour les points de terminaison non compatibles OpenAI.
- Définissez l’URL de base. Saisissez l’URL de base Flatkey vérifiée, par exemple
https://router.flatkey.ai/v1lorsque c’est la valeur opérationnelle actuelle pour votre compte. - Collez la clé API Flatkey. Gardez-la hors des fichiers du dépôt, des commentaires de tickets, des captures d’écran et des invites.
- Définissez l’ID du modèle. Saisissez l’alias exact du modèle Flatkey. N’utilisez pas un nom générique de famille de fournisseur, sauf si Flatkey expose cet alias exact à votre clé.
- Exécutez le préflight curl ci-dessous. Le simple chat est utile, mais Roo Code nécessite un appel natif d’outils, alors incluez un schéma d’outil dans le test.
- Exécutez une invite Roo Code sans risque. Utilisez un espace de travail jetable ou une tâche non destructive avant de pointer Roo Code vers des dépôts de production.
- Vérifiez l’utilisation Flatkey. Confirmez l’horodatage, le propriétaire de la clé, l’alias du modèle, l’utilisation de jetons, le statut et la visibilité du coût.
- Documentez le retour arrière. Enregistrez les paramètres du fournisseur précédents, l’alias du modèle et le propriétaire avant de demander à d’autres développeurs de basculer.
Modèle de préflight pour l’appel natif d’outils
La manière la plus sûre de déboguer une configuration API compatible OpenAI de Roo Code est de tester d’abord la route Flatkey en dehors de Roo Code. Ce modèle vérifie le point de terminaison de chat et demande au modèle de renvoyer un appel d’outil au style OpenAI.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="replace-with-tool-capable-flatkey-model"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_ROO_MODEL"'",
"messages": [
{
"role": "user",
"content": "Call route_check with status ok and do not include prose."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Return the routing smoke-test status.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Une réponse saine devrait inclure un message d’assistant avec tool_calls. Si cette requête échoue, corrigez la clé Flatkey, l’URL de base, l’alias du modèle ou la capacité du modèle avant de modifier les paramètres de Roo Code. Si elle réussit mais que Roo Code échoue, concentrez-vous sur les champs Roo Code enregistrés, l’accès réseau local, l’état de l’extension ou l’ID de modèle exact saisi dans les paramètres du fournisseur.
Modes d’échec à déboguer en premier
| Symptôme | Cause probable | Correctif |
|---|---|---|
| Clé API invalide | La clé a été copiée incorrectement, a été renouvelée, est limitée à un autre environnement ou appartient à un fournisseur en amont plutôt qu’à Flatkey. | Utilisez une nouvelle clé Flatkey, testez avec curl, puis collez la même clé dans Roo Code. |
| Erreur de connexion | Mauvaise Base URL, chemin d’endpoint complet collé dans le champ Base URL, chemin réseau bloqué ou problème de proxy local. | Vérifiez l’URL de base du fournisseur depuis la même machine et retestez /chat/completions. |
| Modèle introuvable | L’ID de modèle Roo Code ne correspond pas à un alias Flatkey activé pour la clé. | Copiez l’alias exact depuis la tarification Flatkey, le catalogue ou la liste des modèles visible dans le compte. |
| Erreur d’appel d’outil | Le modèle sélectionné peut répondre au chat, mais ne prend pas en charge les appels natifs d’outils compatibles OpenAI. | Basculez vers un alias de modèle compatible avec les outils et relancez le pré-vérification avant d’utiliser Roo Code. |
| Extension indisponible | L’état actuel de distribution de Roo Code ne prend pas en charge le chemin d’installation ou de mise à jour prévu. | Considérez la configuration comme une maintenance héritée et choisissez un workflow d’agent de codage actif pour les nouveaux déploiements. |
| L’utilisation ne peut pas être rapprochée | L’équipe n’a pas enregistré le propriétaire de la clé, l’alias du modèle, l’utilisateur Roo Code, l’environnement ou l’horodatage. | Ajoutez une ligne au runbook avant d’étendre la route à davantage de développeurs. |
Installation existante ou nouvelle norme ?
La route Roo Code OpenAI compatible API peut être utile, mais l’avis d’arrêt de l’extension change la décision. Utilisez ce tableau avant de demander à une équipe de s’y fier.
| Situation | Action recommandée | Pourquoi c’est important |
|---|---|---|
| Une installation Roo Code existante est encore utilisée par un développeur | Documentez la route Flatkey, testez les appels d’outils et conservez un retour en arrière. | La maintenance peut continuer pendant que l’équipe planifie la migration ou le remplacement. |
| Nouveau déploiement d’agent de codage à l’échelle de l’équipe | Vérifiez d’abord la disponibilité actuelle de l’extension, puis comparez les alternatives actives. | Une extension arrêtée peut créer des risques de support, de sécurité et d’intégration. |
| Standardisation d’un cluster d’intégration d’outils | Utilisez la même clé Flatkey, la même Base URL, le même alias de modèle et le même schéma de journalisation d’utilisation pour tous les outils. | La cohérence facilite la facturation, le débogage et l’examen des achats. |
Runbook de production pour Roo Code avec Flatkey
Avant que davantage de développeurs utilisent la route Roo Code OpenAI compatible API, notez les éléments opérationnels qui rendent le support et l’examen des coûts possibles.
| Champ du runbook | Consignez ceci |
|---|---|
| Périmètre Roo Code | Installation locale existante, image d’équipe, profil archivé ou test de migration uniquement. |
| Clé Flatkey | Propriétaire, environnement, date de rotation et propriétaire de la révocation. |
| Base URL | L’URL de base exacte du fournisseur enregistrée dans Roo Code et la date de sa vérification. |
| Alias de modèle | ID de modèle Roo Code, alias de modèle Flatkey, famille d’endpoint et résultat d’appel natif d’outil. |
| Test de validation | Statut HTTP, raison de fin, total d’utilisation et présence ou non de tool_calls. |
| Revue de l’utilisation | Où les responsables de la plateforme et des finances vérifient le volume de requêtes, le coût et les changements inattendus de modèle. |
| Retour en arrière | Configuration précédente du fournisseur, alias de modèle précédent et personne pouvant la restaurer. |
Parcours de migration interne
Si votre équipe standardise les configurations d’outils compatibles OpenAI sur Flatkey, gardez cette configuration alignée avec le reste du cluster d’intégration. Utilisez le guide de migration de l’API compatible OpenAI comme base URL et point central de retour en arrière. Pour un autre modèle de client de bureau, comparez le guide de configuration de l’API Cherry Studio. Pour le routage d’agent de codage sur les machines des développeurs, consultez le guide cc-switch Claude Code.
Après que la première invite Roo Code sans risque fonctionne, consultez la page actuelle de tarification des modèles Flatkey, puis obtenez une clé pour chaque utilisateur, équipe ou frontière d’environnement distincte.
Questions fréquentes
Roo Code prend-il toujours en charge les fournisseurs compatibles OpenAI ?
La documentation du fournisseur compatible OpenAI de Roo Code décrit toujours les champs du fournisseur : API Provider, Base URL, API Key et Model ID. La page d’accueil de la documentation indique également que l’extension Roo Code a été arrêtée le 15 mai 2026, alors vérifiez votre chemin d’installation avant tout nouveau déploiement.
Quelle Base URL dois-je utiliser pour le fournisseur API compatible OpenAI de Roo Code ?
Utilisez la Base URL actuelle du fournisseur Flatkey pour votre compte. Les vérifications Flatkey authentifiées de cet article utilisaient https://router.flatkey.ai/v1, tandis que les exemples publics peuvent changer. Dans Roo Code, collez uniquement la base URL, pas l’endpoint complet de chat-completions.
Pourquoi l’appel natif d’outils est-il requis ?
La documentation des fournisseurs de Roo Code indique que l’appel natif d’outils est le seul protocole d’outils pris en charge pour les fournisseurs compatibles OpenAI. Un modèle capable de répondre en chat simple mais incapable de produire des appels d’outils au format OpenAI ne suffit pas pour une configuration Roo Code fiable.
Le Model ID doit-il correspondre exactement à l’alias du modèle Flatkey ?
Oui. Utilisez l’alias Flatkey exact que votre clé peut appeler, et vérifiez-le avec un test de base d’appel d’outil. Les noms de famille de modèles, les noms marketing des fournisseurs et les alias de passerelle peuvent différer.
Puis-je utiliser ce guide pour de nouveaux déploiements Roo Code ?
Utilisez-le uniquement après avoir vérifié la disponibilité actuelle de Roo Code. Les vérifications de routage Flatkey restent utiles, mais l’avis de fermeture de Roo Code signifie que les nouveaux déploiements à l’échelle de l’équipe nécessitent une décision explicite de prise en charge du produit.
Conclusion
Une configuration sûre de l’API compatible OpenAI de Roo Code via Flatkey doit prouver davantage qu’une simple réponse de chat réussie. Confirmez l’URL de base actuelle, utilisez une clé appartenant à Flatkey, sélectionnez un alias de modèle exact, testez les appels d’outils natifs et vérifiez la visibilité de l’utilisation avant de donner à Roo Code l’accès à de vrais travaux de code. Lorsque le chemin est prêt pour un autre utilisateur ou environnement, Obtenez une clé et conservez la ligne de retour en arrière à côté des instructions de configuration.
