Documentation

Dyad

Dyad accepte n’importe quel point de terminaison compatible avec OpenAI via Add Custom Provider : trois champs, une clé sur la page du fournisseur, puis une ligne par identifiant de modèle souhaité dans le sélecteur.

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.

Paramètres → Fournisseurs d’IA → Ajouter un fournisseur personnalisé

Settings → AI Providers → Add Custom Provider
  ID                  kunavo
  Display Name        Kunavo
  API Base URL        https://api.kunavo.com/v1

Then on the new provider's own page
  Set Kunavo API Key  sk-kn-...            → Save Key

Provider page → bottom → Add Custom Model
  Model ID            claude-sonnet-5
  Name                Claude Sonnet 5 (Kunavo)
  Description         Kunavo, OpenAI-compatible
  Max Output Tokens   128000
  Context Window      1000000

L’URL de base conserve le /v1 — mais ce n’est pas la documentation qui le confirme. La page consacrée aux modèles personnalisés indique seulement : « You can usually find the API Base URL in the provider's documentation » et ne donne aucun exemple ; elle ne permet donc pas de trancher. Deux éléments de l’application publiée le confirment : l’espace réservé de la boîte de dialogue indique E.g., https://api.example.com/v1, et un fournisseur personnalisé est construit comme un client compatible avec OpenAI, auquel votre valeur est transmise telle quelle comme baseURL — Dyad ajoute la route, jamais le /v1. Toutes les URL de base des points de terminaison compatibles avec OpenAI que Dyad définit en dur se terminent de la même façon. Sans cette partie, l’URL de base provoque une erreur 404, et non un rejet de la clé.

Deux champs ne figurent pas sur la page de documentation. Dans la boîte de dialogue de l’application publiée, le premier s’appelle ID du fournisseur, et non ID, et un champ Variable d’environnement (facultative) est ajouté — un nom de variable tel que KUNAVO_API_KEY, lu uniquement si aucune clé n’est enregistrée dans les paramètres. La clé elle-même ne figure pas dans cette boîte de dialogue : créez d’abord le fournisseur, ouvrez-le, puis utilisez la zone Définir la clé API Kunavo sur sa page.

Saisissez la fenêtre de contexte ; ne la laissez pas vide. Dyad avertit seulement que les champs vides reprennent « default values, which may be smaller than optimal ». La valeur par défaut de l’application publiée est de 128,000 jetons, et Dyad compacte une conversation lorsque le seuil atteint la plus basse de ces deux valeurs : le plafond propre au fournisseur et votre fenêtre de contexte moins 25,000. Un fournisseur personnalisé est enregistré sous un identifiant custom:: ; il est donc soumis au plafond de 250,000, et non à celui de Google ou d’OpenAI. Si le champ reste vide, un modèle d’un million de jetons commence ainsi à résumer à 103,000 jetons au lieu de 250,000 — il effectue davantage de passes de compactage sur le même travail, sans raison.

Cette configuration a été relevée dans la documentation de Dyad et son code source publié à la date indiquée ci-dessous. Kunavo n’a pas exécuté Dyad avec son point de terminaison — ni compilation, ni modification en streaming, ni aller-retour d’outil en mode Agent — et il en va de même pour tous les clients de cette famille. Une page de configuration publiée ne constitue pas un test de compatibilité. Gardez à disposition la route qui fonctionne actuellement pendant que vous essayez celle-ci, et testez une fonctionnalité limitée avant d’y transférer un projet.

Kunavo ne propose aucun modèle d’embeddings, de synthèse vocale ou de transcription de la parole ; un fournisseur personnalisé ajouté de cette manière ne traite donc que les complétions de chat. La boucle de création de Dyad ne demande rien pour les trois autres usages : cela ne vous prive donc d’aucune fonctionnalité ici, mais signifie seulement que le fournisseur que vous venez d’ajouter ne remplace pas directement une pile qui en a également besoin.

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

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Dans Dyad, ouvrez Paramètres, repérez la section Fournisseurs d’IA et cliquez sur Ajouter un fournisseur personnalisé. Renseignez l’ID, le nom d’affichage et l’URL de base de l’API comme ci-dessus. L’ID est « used internally and cannot be changed later » ; choisissez donc une valeur qui vous conviendra. Le nom d’affichage apparaît dans le sélecteur et n’a qu’un rôle esthétique.
Ouvrez le fournisseur que vous venez de créer, collez la clé dans Définir la clé API Kunavo, puis cliquez sur Enregistrer la clé. Si l’URL de base est vide, Dyad refuse directement la requête et renvoie une erreur URL de base de l’API manquante, au lieu d’une erreur réseau.
Sur la même page, faites défiler jusqu’en bas et cliquez sur Ajouter un modèle personnalisé. Le Model ID doit correspondre exactement au slug du catalogue — la documentation de Dyad précise qu’il « doit correspondre exactement à ce qui est indiqué dans la documentation de l’API du fournisseur. C’est l’identifiant envoyé à l’API » — par exemple claude-sonnet-5, et non un nom d’affichage.
Renseignez les champs Nombre maximal de jetons de sortie et Fenêtre de contexte à partir de /models, au lieu de les laisser vides, puis répétez l’opération avec Ajouter un modèle personnalisé pour chaque identifiant que vous voulez voir dans le sélecteur — il n’y a ni importation groupée ni liste récupérée automatiquement.
Sélectionnez le nouveau modèle dans le sélecteur et confiez-lui une vraie tâche — par exemple l’ajout d’un composant, et pas une salutation. Le mode Build exécute une boucle agentique qui renvoie un ensemble de travail à chaque étape ; un premier essai doit donc mettre à l’épreuve le streaming et les modifications répétées.

Vérifié avec La page des modèles personnalisés de Dyad le 21 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 des tarifs et des coûts d’API de Dyad.

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

# 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 Dyad
`claude-sonnet-5`	$1.40 / $7.00	le modèle par défaut du mode Build — qualité de programmation par dollar pour une boucle qui tourne toute la journée
`claude-opus-5`	$3.50 / $17.50	le mode Plan pour une refactorisation dont un plan erroné pourrait coûter une session entière
`claude-haiku-4-5`	$0.70 / $3.50	le mode Ask et les questions rapides sur la base de code, où le volume domine
`gpt-5-6-sol`	$2.00 / $12.00	un deuxième avis provenant d’une autre famille — ajoutez-le comme second modèle personnalisé chez le même fournisseur
`gpt-5-6-terra`	$0.70 / $4.20	un grand ensemble de travail, une fois le champ Context Window correctement renseigné

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.

Trois limites à connaître avant de changer

Il s’agit des propres règles de Dyad, pas de celles de Kunavo, et chacune détermine ce qu’une clé client peut atteindre. C’est pourquoi cette page décrit une route vers les modèles, et non vers l’ensemble de Dyad.

Par conception, les modes Pro sont inaccessibles avec votre propre clé. La FAQ sur les tarifs de Dyad le dit clairement : les modes Pro tels que Smart Context ne peuvent utiliser que les crédits d’IA de Dyad Pro, et pas vos propres clés d’API, car ils nécessitent un traitement côté serveur faisant intervenir plusieurs modèles. Turbo Edits est l’autre exception. Un fournisseur personnalisé donne accès aux modèles et aux modes ordinaires, pas à ces mécanismes.
Le mode Agent est limité dans l’offre gratuite. Le plafond est de 20 messages Agent par période de 23 heures, quelle que soit la clé configurée — Build, Ask et Plan ne sont pas plafonnés. Un arrêt inattendu en cours de session peut donc être dû au quota de Dyad, et non à votre solde ou à votre point de terminaison.
Le protocole Anthropic Messages est inaccessible depuis Dyad. Un fournisseur personnalisé est toujours construit comme un client de complétion de chat OpenAI, et le fournisseur Anthropic intégré n’accepte aucune substitution d’URL de base. Les modèles Claude sont donc accessibles ici via l’interface compatible avec OpenAI — c’est ce que fait la configuration ci-dessus, et c’est pourquoi la requête de vérification de cette page utilise le format OpenAI.

Questions fréquentes

Comment ajouter un fournisseur d’API personnalisé à Dyad ?

Ouvrez Paramètres, repérez la section Fournisseurs d’IA et cliquez sur Ajouter un fournisseur personnalisé. Renseignez un ID, utilisé en interne et impossible à modifier ultérieurement, un nom d’affichage pour le sélecteur et l’URL de base de l’API de votre point de terminaison. Enregistrez, puis ouvrez le fournisseur que vous venez de créer et collez votre clé dans la zone « Définir la clé API <name> » sur sa page — la clé ne fait pas partie de la boîte de dialogue de création. Enfin, faites défiler jusqu’en bas de cette page et utilisez Ajouter un modèle personnalisé pour chaque identifiant de modèle que vous souhaitez rendre disponible. La documentation de Dyad résume en une ligne l’exigence relative au point de terminaison : tout fournisseur convient dès lors qu’il propose une API compatible avec OpenAI.

L’URL de base de l’API de Dyad doit-elle se terminer par /v1 ?

Pour un point de terminaison compatible avec OpenAI, oui — par exemple https://api.kunavo.com/v1. La documentation de Dyad sur les modèles personnalisés ne permet pas de trancher : elle indique seulement que l’on trouve généralement l’URL de base de l’API dans la documentation du fournisseur, sans donner d’exemple. La réponse se trouve dans la boîte de dialogue elle-même, dont l’espace réservé indique « E.g., https://api.example.com/v1 », et dans la façon dont Dyad construit le client : votre valeur devient telle quelle l’URL de base d’un client compatible avec OpenAI, auquel seule la route est ajoutée. Sans /v1, l’URL de base provoque une erreur 404 plutôt qu’une erreur d’authentification ; si elle comprend déjà /chat/completions, elle provoque la même erreur.

Puis-je utiliser Dyad avec des modèles Claude sans compte Anthropic ?

Oui, via un fournisseur personnalisé plutôt que l’entrée Anthropic intégrée de Dyad. Dyad construit chaque fournisseur personnalisé comme un client de complétion de chat OpenAI ; l’identifiant de modèle que vous saisissez est donc résolu au niveau du point de terminaison configuré et non dans l’application. Un identifiant Claude peut ainsi lui être transmis. Le fournisseur Anthropic intégré, lui, ne convient pas : il est construit sans argument d’URL de base. Il n’existe donc aucune substitution de type ANTHROPIC_BASE_URL, et il ne peut joindre que le point de terminaison propre à Anthropic.

Un fournisseur personnalisé dans Dyad est-il différent d’OpenRouter ?

La différence tient uniquement à la configuration, pas à la nature du service. OpenRouter est la seule passerelle indépendante multi-fournisseurs dotée d’un préréglage intégré dans la liste des fournisseurs de Dyad ; elle ne nécessite donc qu’une clé. Toutes les autres passerelles passent par Ajouter un fournisseur personnalisé, où vous devez également saisir manuellement l’identifiant, le nombre maximal de jetons de sortie et la fenêtre de contexte de chaque modèle. Le mainteneur de Dyad a indiqué précisément cette méthode lorsqu’une passerelle a demandé à être ajoutée comme préréglage. Comparez les deux en fonction du prix, des conditions d’approvisionnement et des modèles qui vous intéressent, et non selon la présence d’un logo dans la liste.

Pourquoi mon modèle personnalisé Dyad commence-t-il à résumer la conversation si tôt ?

Le champ Context Window a probablement été laissé vide. Lorsqu’il est vide, Dyad utilise la valeur par défaut de 128,000 jetons et compacte la conversation lorsque le seuil atteint la plus basse de ces deux valeurs : le plafond propre au fournisseur et la fenêtre de contexte moins 25,000. Un fournisseur personnalisé est soumis au plafond de 250,000, et non à celui de Google ou d’OpenAI. Si le champ est vide, le compactage commence donc vers 103,000 jetons, même pour un modèle doté d’une fenêtre bien plus grande. Saisissez les valeurs réelles du catalogue du fournisseur dans Max Output Tokens et Context Window : le seuil atteindra alors le plafond.