Documentation
Intégrations
Kunavo utilise deux formats de communication déjà pris en charge par tous les clients sérieux. L’intégration consiste donc à renseigner une URL de base et une clé, plutôt qu’à installer un SDK. Voici la configuration pour chaque client.
Kunavo est une passerelle indépendante d’API IA compatible avec OpenAI : une seule clé API et un solde à l’usage vous donnent accès à Claude, GPT ainsi qu’à des modèles d’image, de vidéo et d’audio, sans compte par fournisseur. Il n’y a aucun SDK Kunavo à installer : tout client doté d’un champ d’URL de base fonctionne. Configurez un client compatible avec OpenAI avec https://api.kunavo.com/v1, ou un client de type Anthropic avec https://api.kunavo.com, puis fournissez une clé Kunavo.
/v1 : le SDK OpenAI en a besoin dans base_url, tandis que les clients Anthropic ajoutent eux-mêmes /v1/messages et ne demandent donc que l’origine. Inverser ces configurations est l’erreur la plus fréquente lors de l’installation — voir la page ANTHROPIC_BASE_URL. Chaque page ci-dessous précise la forme attendue par le client et la date à laquelle sa configuration a été vérifiée pour la dernière fois à partir de sa propre documentation.Agents de programmation, éditeurs et interfaces en ligne de commande
Tous ces clients disposent d’un champ pour configurer un fournisseur personnalisé, et tous traitent « OpenAI-compatible » ou « Anthropic » comme un protocole, et non comme un fournisseur. C’est pourquoi saisir un identifiant de modèle Claude dans un fournisseur compatible avec OpenAI est la configuration prévue, et non une solution de contournement.
Une entrée models.providers dans ~/.openclaw/openclaw.json — baseUrl https://api.kunavo.com, api "anthropic-messages" — fait fonctionner un agent OpenClaw toujours actif avec Claude ; cacheRetention est défini à côté, car un point de terminaison Anthropic personnalisé ne reçoit aucun marqueur de cache tant que ce paramètre ne l’est pas.
Un fournisseur nommé dans ~/.hermes/config.yaml — api https://api.kunavo.com, transport anthropic_messages, sélectionné avec provider: custom:kunavo — fait fonctionner Hermes Agent avec Claude via le protocole Messages, en envoyant ses propres marqueurs de cache et sa limite de sortie.
Deux variables d’environnement — ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN — font passer Claude Code au paiement à l’usage sans modifier l’installation.
Providers → Custom provider → OpenAI Compatible, URL de base avec /v1 et identifiant du modèle Claude saisi — Kilo Code ne sait jamais quel vendeur se trouve derrière.
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.
Le fournisseur OpenAI Compatible de Cline prend une URL de base, une clé et un identifiant de modèle, ainsi que les prix par modèle utilisés pour afficher le coût courant de la session.
Un bloc [model_providers.kunavo] dans ~/.codex/config.toml avec env_key, afin que la clé reste dans l’environnement et jamais dans le fichier de configuration.
Un bloc fournisseur dans opencode.json — @ai-sdk/openai-compatible pour les complétions de chat, @ai-sdk/openai lorsque vous voulez la surface /v1/responses.
CCR est désormais une application de bureau, et non un config.json : ajoutez Kunavo comme endpoint API personnalisé, puis laissez ses règles de routage envoyer chaque catégorie de requêtes vers un modèle différent.
Un bloc language_models.openai_compatible dans settings.json déclare l’endpoint et ses modèles ; la clé est saisie dans l’interface Agent Panel, jamais dans le fichier.
Le fournisseur `openai` de Continue désigne un protocole, pas un vendeur : fournissez-lui un apiBase et chaque modèle — chat, édition, autocomplétion — devient une entrée dans config.yaml.
OPENAI_API_BASE plus OPENAI_API_KEY, puis `aider --model openai/<id>` — le préfixe achemine l’identifiant vers votre endpoint plutôt que vers la table des fournisseurs d’Aider.
Ajoutez Kunavo comme Custom Configuration : racine du service comme endpoint, ANTHROPIC_AUTH_TOKEN comme champ d’authentification, Anthropic Messages natif — la partie Claude Code ne nécessite donc aucun routage local.
Aucune option base_url n’existe — le SDK lance la CLI Claude Code et transmet tout votre environnement ; ANTHROPIC_BASE_URL l’achemine donc, ou ClaudeAgentOptions(env=...) le fait par client.
Une connexion Custom URL dans le Model Routing d’Amp — format API chat-completions, URL de base https://api.kunavo.com/v1, clé comme jeton bearer — transfère les modèles associés vers une seule clé, pour les niveaux qui proposent cette option.
Quatre variables d’environnement — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY et COPILOT_MODEL — font passer Copilot CLI à votre propre endpoint ; GitHub précise que le BYOK ne nécessite aucune connexion GitHub.
La configuration de Crush est en Bash — une seule commande `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` dans un crushrc place l’agent terminal de Charm sur Claude et GPT.
Settings → Models → « Add model provider » → « Custom model API » demande cinq champs — Provider ID, display name, base URL, API protocol et API key — et place Claude et GPT dans le même sélecteur que la carte DeepSeek intégrée.
Dyad accepte tout endpoint compatible OpenAI via Settings → AI Providers → Add Custom Provider : API Base URL https://api.kunavo.com/v1, la clé sur la propre page du fournisseur, puis une ligne Add Custom Model par identifiant de modèle.
Une entrée customModels dans ~/.factory/settings.json — model, baseUrl et provider — place Droid sur tout endpoint parlant Anthropic Messages ou OpenAI Chat Completions.
Settings → Models → Configure providers → OpenAI : Host URL reçoit l’origine seule, car goose ajoute lui-même le chemin de requête (v1/chat/completions).
Une ligne `jan config set --base-url https://api.kunavo.com/v1` écrit Kunavo dans ~/.jan/config.toml, et la CLI d’aperçu Jan Agent — qui ne fournit aucun moteur d’inférence — fonctionne avec cette clé.
Junie CLI accepte un endpoint personnalisé sous forme de profil JSON dans $JUNIE_HOME/models/, où baseUrl est l’URL complète de l’endpoint et fasterModel détermine où aboutissent les requêtes auxiliaires.
Kimi Code conserve les fournisseurs dans ~/.kimi-code/config.toml — définissez providers.<name>.base_url sur https://api.kunavo.com/v1 avec type = "openai" et la CLI exécute les identifiants Claude et GPT avec une seule clé.
mini-SWE-agent ne possède aucune variable d’environnement pour l’URL de base — l’endpoint va sous model.model_kwargs.api_base dans une configuration YAML, que mini transmet directement à litellm.completion.
Un bloc [[providers]] de cinq lignes dans .vibe/config.toml — api_base, api_key_env_var, api_style — dirige Vibe CLI vers Kunavo, la clé restant dans une variable d’environnement plutôt que dans le fichier.
Settings > Model Providers demande une Base URL et une clé API — cinq champs documentés, dont deux que la documentation de Msty Go vous laisse déterminer par test.
Une entrée Custom Provider sous nanocoder.providers dans agents.config.json — name, baseUrl, apiKey, models — sans ligne sdkProvider nécessaire, car la valeur par défaut est openai-compatible.
Un bloc fournisseur dans ~/.omp/agent/models.yml — baseUrl, api, apiKey — dirige Oh My Pi vers Kunavo, et la découverte remplit la liste des modèles depuis GET /v1/models.
Une seule table [model_providers.kunavo] dans ~/.openinterpreter/config.toml — base_url, env_key, wire_api = "chat" — et l’agent terminal Rust fonctionne avec tout modèle accessible par la clé.
Settings → LLM → Advanced demande trois champs — Custom Model, Base URL, API Key — avec l’identifiant du modèle portant le préfixe openai/ et l’URL de base conservant son /v1.
Un bloc fournisseur personnalisé dans ~/.pi/agent/models.json — baseUrl, api et identifiants des modèles — place l’agent de codage terminal Pi d’Earendil sur Claude et GPT avec une seule clé.
Qoder Settings → Models → + Add → Provider → Custom accepte une Base URL compatible OpenAI, une API Key et des Model IDs saisis manuellement — l’application Qoder autonome accède ainsi à Claude et GPT, absents de son propre catalogue.
Qwen Code lit ses endpoints dans modelProviders de ~/.qwen/settings.json — une entrée avec un baseUrl et un envKey place Claude et GPT dans son sélecteur /model.
Une entrée dans ai-features.openAiCustom.customOpenAiModels — model, url et apiKey — place Kunavo derrière Theia Coder, Architect et la complétion en ligne.
twinny n’a pas de champ d’URL de base — Add provider → OpenAI-compatible server, puis Protocol https, Hostname api.kunavo.com, Port vide et API path /v1 ; son panneau de chat utilise votre clé.
Clients de chat et interfaces auto-hébergées
Applications de bureau et interfaces auto-hébergées, pour lesquelles l’avantage tient à une seule clé et un seul solde accessibles depuis un même sélecteur de modèles, plutôt qu’à un compte par fournisseur.
Une connexion OpenAI sous Admin Settings, ou OPENAI_API_BASE_URL et OPENAI_API_KEY au démarrage du conteneur — les deux aboutissent au même /v1.
Settings → Model Services → fournisseur personnalisé : collez la clé et l’adresse API, cliquez sur Get Model List, et tout le catalogue remplit le sélecteur.
Ajoutez un fournisseur de type OpenAI API Compatible avec l’API Host défini sur la racine du service — Chatbox ajoute lui-même /v1/chat/completions.
Trois variables d’environnement — OPENAI_API_KEY, OPENAI_PROXY_URL et OPENAI_MODEL_LIST — placent Claude et GPT dans un seul sélecteur LobeChat auto-hébergé.
Pointez la source Chat Completion de SillyTavern vers Kunavo avec un endpoint personnalisé et une seule clé API — Claude et GPT dans le même menu de modèles.
API Settings → Proxy → Add Configuration : le Proxy URL est le chemin complet /v1/chat/completions, et le Model Name doit être exactement un identifiant du catalogue.
La surface compatible OpenAI d’Ollama et celle de Kunavo ont la même structure ; les outils conçus pour un Ollama local fonctionnent donc en changeant l’URL de base.
AnythingLLM atteint un endpoint pour lequel il ne fournit aucun fournisseur nommé via Generic OpenAI — Base URL avec /v1, une clé et un identifiant de modèle saisi manuellement, puisqu’il ne récupère aucune liste.
Settings → Providers → « + » crée un fournisseur personnalisé à partir de trois champs — Provider name, API Base URL défini sur https://api.kunavo.com/v1 et API Key — puis Fetch lit la liste des modèles depuis l’endpoint.
Un seul champ obligatoire — API Base URL, dans le formulaire Add Model du plugin compatible avec l’API OpenAI — dirige chaque nœud LLM d’un espace Dify vers Kunavo.
LibreChat utilise une passerelle sous forme de bloc endpoints.custom dans librechat.yaml — quatre champs obligatoires, la clé provenant de .env, puis un redémarrage avant son affichage dans le sélecteur.
Model Hub > Model Providers > Add Provider > Open AI Compatible : une API Key et un Inference Endpoint de https://api.kunavo.com/v1 — la note de l’application indique que la plupart des endpoints compatibles OpenAI nécessitent /v1.
Le champ Base URL de l’identifiant OpenAI — https://api.kunavo.com/v1, en conservant le /v1 — place chaque OpenAI Chat Model d’un workflow n8n sur Kunavo ; le nœud de modèle lui-même n’a aucun champ d’endpoint.
Trois variables d’environnement — OPENAI_API_KEY, BASE_URL (origine seule) et CUSTOM_MODELS — placent un NextChat auto-hébergé sur Claude et GPT avec une seule clé.
Settings → Copilot → BYOK → Add a custom provider : un Display name, votre clé et https://api.kunavo.com/v1 — Quick Chat toujours disponible, Agent Chat sous opencode lorsque le fournisseur y est affiché.
Settings → OpenAI Compatible API → Add Provider → Custom : Provider Name, une Base URL conservant /v1 et la clé — cochez ensuite les identifiants de modèles dans la liste récupérée par Page Assist.
Models → Add custom model : l’Endpoint URL complet https://api.kunavo.com/v1/chat/completions, un en-tête Authorization avec Bearer et votre clé, le Model ID et sa longueur de contexte — une entrée par modèle, appelée directement depuis votre navigateur.
Tout le reste
Un client absent de cette liste fonctionne presque certainement lui aussi. Vérifiez s’il permet de modifier l’endpoint : s’il propose un paramètre « URL de base », « endpoint personnalisé » ou « fournisseur compatible avec OpenAI », Kunavo convient. Commencez par le guide de démarrage rapide, puis consultez les complétions de chat ou l’API Messages, selon le format utilisé par le client. Les identifiants de modèle sont disponibles sur GET /v1/models, qui alimente également la liste déroulante des modèles dans les clients qui en proposent une. Enfin, la description OpenAPI 3.1 fournit le contrat complet lisible par machine, directement exploitable par la plupart des générateurs de clients et des frameworks d’agents.