Documentation

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.

Les deux conventions diffèrent volontairement sur /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.

OpenClawAnthropic

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.

Hermes AgentAnthropic

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.

Claude CodeAnthropic

Deux variables d’environnement — ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN — font passer Claude Code au paiement à l’usage sans modifier l’installation.

Kilo CodeOpenAI

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.

Roo CodeOpenAI

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.

ClineOpenAI

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.

Codex CLIOpenAI

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.

opencodeOpenAI

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.

Claude Code RouterAnthropic

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.

ZedOpenAI

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.

ContinueOpenAI

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.

AiderOpenAI

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.

CC SwitchAnthropic

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.

Claude Agent SDKAnthropic

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.

AmpOpenAI

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.

GitHub Copilot CLIOpenAI

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.

CrushOpenAI

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.

DeepSeek HarnessOpenAI

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.

DyadOpenAI

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.

Factory DroidAnthropic

Une entrée customModels dans ~/.factory/settings.json — model, baseUrl et provider — place Droid sur tout endpoint parlant Anthropic Messages ou OpenAI Chat Completions.

gooseOpenAI

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).

Jan AgentOpenAI

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 CLIOpenAI

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 CodeOpenAI

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-agentOpenAI

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.

Mistral Vibe CLIOpenAI

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.

Msty GoOpenAI

Settings &gt; 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.

NanocoderOpenAI

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.

Oh My PiOpenAI

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.

Open InterpreterOpenAI

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é.

OpenHandsOpenAI

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.

PiOpenAI

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é.

QoderOpenAI

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 CodeOpenAI

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.

Theia IDEOpenAI

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.

twinnyOpenAI

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.

Open WebUIOpenAI

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.

Cherry StudioOpenAI

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.

ChatboxOpenAI

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.

LobeChatOpenAI

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é.

SillyTavernOpenAI

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.

Janitor AIOpenAI

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.

OllamaOpenAI

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.

AnythingLLMOpenAI

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.

ChatWiseOpenAI

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.

DifyOpenAI

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.

LibreChatOpenAI

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.

Msty StudioOpenAI

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.

n8nOpenAI

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.

NextChatOpenAI

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é.

Copilot for ObsidianOpenAI

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é.

Page AssistOpenAI

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.

TypingMindOpenAI

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.