Documentation

goose

goose sépare l’endpoint en deux éléments : une URL d’hôte et un chemin de requête qu’il ajoute lui-même. Indiquez l’origine seule et laissez le chemin tel quel : le fournisseur OpenAI intégré pourra ainsi communiquer avec Claude et GPT avec une seule clé.

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

Configurer les fournisseurs → OpenAI, ou l’environnement

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

L’URL d’hôte ne doit pas contenir /v1. goose décrit OPENAI_BASE_PATH comme le « chemin de requête ajouté à l’hôte (par défaut : v1/chat/completions) » et indique aux utilisateurs de proxy de définir OPENAI_HOST sur « la racine de votre proxy (sans chemin final) ». Ces deux indications déterminent la configuration : l’origine va dans le champ, et le /v1 est fourni par le chemin par défaut. Saisir https://api.kunavo.com/v1 demande /v1/v1/chat/completions — et la même page indique qu’un 404 signifie que le chemin est incorrect, pas que la clé l’est.

Cette configuration a été relevée dans la documentation de goose à la date indiquée ci-dessous. Kunavo n’a pas exécuté goose contre son endpoint : ni session, ni échange en continu, ni aller-retour d’appel d’outil. Une page de configuration publiée ne constitue pas un test et rien ici ne doit être interprété comme tel ; la curl ci-dessous est la partie que vous pouvez vérifier en dix secondes, et le comportement du client dépend de vous et de goose.

Kunavo ne propose aucun modèle d’intégration, de synthèse vocale ou de reconnaissance vocale ; cet endpoint traite donc uniquement les complétions de chat. Toute configuration de goose qui transcrit de l’audio ou construit un index vectoriel conserve la clé du fournisseur qu’elle utilise déjà : rediriger le fournisseur OpenAI ici ne déplace pas ces appels.

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

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Dans goose Desktop : barre latérale → Paramètres → Modèles → Configurer les fournisseurs → OpenAI. Dans la CLI : goose configure → Configurer les fournisseurs → OpenAI.
Renseignez Clé API et URL d’hôte. Laissez ID d’organisation et Projet vides : goose indique qu’ils servent au suivi de l’utilisation et à la gestion des ressources sur les comptes OpenAI, et Kunavo n’a pas d’équivalent à y renseigner. Cliquez sur Soumettre.
Choisissez le modèle. goose précise explicitement que goose configure « ne permet pas de saisir des noms de modèles personnalisés ». Si l’identifiant souhaité ne figure pas dans la liste obtenue, saisissez-le dans goose Desktop ou définissez GOOSE_MODEL dans config.yaml, ce qui remplace le fichier pour ce processus.
Démarrez une session et donnez-lui une tâche qui utilise un fichier. goose s’appuie sur les appels d’outils pour presque tout ce qu’il fait : sa page de fournisseur avertit qu’un modèle sans prise en charge des appels d’outils « ne peut faire que des complétions de chat » et que les extensions doivent être désactivées dans ce cas. Un premier essai qui lit et modifie un fichier vous en apprendra donc davantage qu’une simple salutation.

Vérifié avec la page goose Configurer un fournisseur LLM le 29 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.

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

# 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 goose
`claude-sonnet-5`	$1.40 / $7.00	le modèle de travail par défaut pour les sessions qui modifient des fichiers
`claude-opus-5`	$3.50 / $17.50	planifier une modification dont une erreur coûterait cher
`claude-haiku-4-5`	$0.70 / $3.50	requêtes économiques — triage, résumés, boucle qui tourne toute la journée
`gpt-5-6-sol`	$2.00 / $12.00	un second avis provenant d’une autre famille, avec la même clé et la même URL d’hôte

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.

L’autre méthode : le fichier fournisseur de Kunavo

goose charge également les définitions de fournisseurs depuis des fichiers JSON dans son répertoire custom_providers. Un fournisseur ajouté de cette manière possède sa propre entrée dans le sélecteur, sa propre clé et une liste de modèles enregistrée, au lieu d’utiliser l’emplacement nommé OpenAI. Kunavo en publie un à l’adresse kunavo.com/goose/kunavo.json. Il est généré à partir du catalogue en temps réel : la liste comprend donc les modèles proposés aujourd’hui par Kunavo et indique le nom de la variable de clé, jamais une clé :

terminal

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Sous Windows, le répertoire est %APPDATA%\Block\goose\config\custom_providers\. Dans goose Desktop, le fournisseur apparaît ensuite sous Configurer les fournisseurs sous le nom Kunavo ; la clé peut alors être enregistrée dans le trousseau plutôt que dans l’environnement.

Endpoint. Le fichier définit base_url sur https://api.kunavo.com/v1. La documentation de goose ne précise pas si ce champ attend l’URL de base /v1 ou l’URL complète /v1/chat/completions indiquée dans son exemple ; son code source tranche la question : derive_base_path produit le même chemin v1/chat/completions dans les deux cas.
Les identifiants GPT utilisent l’API Responses. goose envoie les identifiants de modèle qui commencent par gpt-5 ou gpt-6 à /v1/responses, et tous les autres à /v1/chat/completions. Kunavo prend les deux en charge ; les identifiants Claude et GPT du fichier fonctionnent donc avec une seule clé.
Seuls les modèles prenant en charge les appels d’outils sont répertoriés. goose s’appuie sur les outils dans presque tous ses échanges. Les modèles d’image, de vidéo et d’audio sont donc omis du fichier, même si la même clé permet de les appeler.

La même réserve que pour le reste de cette page s’applique : ces informations proviennent de la documentation et du code source de goose ; elles n’ont pas été testées en exécution. Vous préférez créer le fournisseur manuellement ? Configurer les fournisseurs → Ajouter un fournisseur personnalisé demande les mêmes éléments : le type OpenAI Compatible, l’URL de l’API https://api.kunavo.com/v1, votre clé sk-kn- et une liste de modèles séparés par des virgules.

Questions fréquentes

Comment configurer goose pour utiliser une API personnalisée compatible avec OpenAI ?

Utilisez le fournisseur OpenAI intégré et indiquez-lui un hôte. Dans goose Desktop, accédez à Settings → Models → Configure providers → OpenAI ; les champs sont API Key, Host URL, Organization ID et Project. Dans la CLI, exécutez `goose configure` → Configure Providers → OpenAI ; les mêmes valeurs vous seront demandées. Pour utiliser des variables d’environnement, renseignez OPENAI_API_KEY et OPENAI_HOST. Si vous avez besoin d’utiliser plusieurs endpoints à la fois, le flux Add Custom Provider de goose ajoute une entrée distincte pour chacun dans la liste des fournisseurs.

L’URL d’hôte de goose doit-elle se terminer par /v1 ?

Non, et l’ajouter brise la requête. goose indique que OPENAI_BASE_PATH correspond au chemin de requête ajouté à l’hôte, avec v1/chat/completions comme valeur par défaut, et recommande aux utilisateurs de proxy de définir OPENAI_HOST sur la racine du proxy, sans chemin final. Le champ doit donc contenir l’origine seule — https://api.kunavo.com — et /v1 est fourni par le chemin par défaut. Un hôte qui se termine par /v1 demande /v1/v1/chat/completions, ce qui produit une erreur 404 et non une erreur d’authentification.

Pourquoi goose renvoie-t-il une erreur 404 après la configuration d’un hôte personnalisé ?

Selon la documentation de goose, une erreur 404 signifie généralement que le chemin de base ne correspond pas à l’endpoint : la plupart des proxys utilisent v1/chat/completions, certains chat/completions sans v1, et la valeur configurée doit correspondre. Kunavo utilise v1/chat/completions, la valeur par défaut de goose. Une erreur 404 avec Kunavo signifie donc le plus souvent que /v1 a aussi été ajouté à l’hôte et se retrouve en double. Une erreur 401 indiquant qu’aucune clé API n’a été transmise signale un autre problème : goose précise qu’une clé placée dans config.yaml est ignorée.

goose peut-il utiliser des modèles Claude via un endpoint compatible avec OpenAI ?

Oui. Le type de fournisseur désigne un protocole réseau, pas un éditeur : goose envoie une complétion de chat au format OpenAI à l’hôte configuré et transmet directement l’identifiant du modèle. Un identifiant Claude est donc résolu par cet endpoint, et non par goose. À retenir : goose utilise beaucoup les appels d’outils et sa page de fournisseur précise qu’un modèle sans prise en charge des appels d’outils ne peut faire que des complétions de chat, avec les extensions désactivées. Choisissez donc des identifiants qui prennent en charge les outils.

Kunavo a-t-il testé cette configuration ?

Non. Les éléments vérifiés sont la documentation de goose (21 et 29 septembre 2026), dont sont tirés les noms et l’ordre des champs ainsi que la règle associant l’hôte et le chemin, et, pour le fichier fournisseur, le code source des fournisseurs de goose (29 septembre). Kunavo n’a pas exécuté de session goose contre son endpoint et ne fait aucune affirmation sur la diffusion en continu, les aller-retours d’appels d’outils ou le comportement des extensions de ce client. La seule chose que vous pouvez vérifier séparément est le bon fonctionnement de l’endpoint et de la clé ; la commande curl de cette page le permet.

Existe-t-il un fichier fournisseur Kunavo prêt à l’emploi pour goose ?

Oui : https://kunavo.com/goose/kunavo.json. Enregistrez-le dans le répertoire custom_providers de goose (~/.config/goose/custom_providers/ sur macOS et Linux, %APPDATA%\Block\goose\config\custom_providers\ sous Windows), définissez KUNAVO_API_KEY et Kunavo apparaîtra dans la liste des fournisseurs, avec ses identifiants de modèles déjà renseignés. Le fichier est généré à partir du catalogue en temps réel : il ne répertorie donc que les modèles actuellement proposés par Kunavo et ne contient aucune clé.