Documentation

Page Assist

Page Assist a été conçu pour une instance Ollama locale, mais le même écran accepte un endpoint hébergé : Settings → OpenAI Compatible API → Add Provider → Custom, trois champs, et la barre latérale résume l’onglet ouvert avec Claude ou GPT plutôt qu’avec le modèle qui tient dans la RAM de votre ordinateur portable.

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.

Paramètres → API compatible avec OpenAI → Ajouter un fournisseur → Personnalisé

Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra

Le Base URL conserve son suffixe /v1. La page OpenAI Compatible API ne le précise pas elle-même : c’est le champ qui le fait. Son texte d’aide indique « L’URL de base du fournisseur de l’API OpenAI. ex. (http://localhost:1234/v1) », et les deux pages des fournisseurs similaires qui donnent une URL concrète pour le même champ le confirment : pour LM Studio, « par défaut, c’est http://localhost:1234/v1 », et pour LLaMA.cpp, http://localhost:8080/v1. Page Assist ajoute uniquement la route. Sans suffixe, l’origine seule entraîne donc une erreur 404 plutôt qu’une erreur 401 — l’inverse des clients de type Anthropic, qui ne demandent que l’origine.

La Model List est récupérée, et non saisie — en général. Après Save, Page Assist ouvre une Model List avec le message « Veuillez sélectionner les modèles de chat que vous souhaitez utiliser avec ce fournisseur », alimentée par l’endpoint. Kunavo répond avec GET /v1/models, la liste se remplit donc automatiquement. Si elle est vide, l’extension affiche « Aucun modèle trouvé. Vérifiez que vous avez ajouté un fournisseur correct avec une URL de base et une clé API ». Le message est juste : une liste vide signale bien plus souvent un problème d’URL de base ou de clé qu’un problème de catalogue. Vérifiez-les à l’aide de la curl ci-dessous avant de modifier l’extension. Vous pouvez aussi ajouter les identifiants manuellement via Add Custom Model : le champ Model ID accepte tel quel un slug du tableau de cette page.

Choisissez Chat Model, et non l’autre option. Le formulaire Add Custom Model propose un choix Model Type, et Kunavo ne fournit aucun modèle d’embedding : aucun modèle du catalogue ne répond à cet endpoint, la seconde option n’a donc aucune destination ici. La fonctionnalité Knowledge Base en dépend : la propre page du fournisseur indique que vous devez en définir un dans RAG Settings et recommande nomic-embed-text. Gardez une instance Ollama locale configurée à côté de ce fournisseur pour cette tâche : Page Assist peut gérer plusieurs fournisseurs simultanément, et ces deux rôles n’ont pas à provenir du même endroit.

Les paramètres audio nécessitent une configuration distincte. La section Text-to-Speech de Page Assist propose un fournisseur OpenAI TTS avec sa propre API Key, son propre Base URL et son propre TTS Model, et Kunavo ne fournit aucun modèle de synthèse vocale. L’inverse est également vrai : Kunavo ne fournit aucun modèle de reconnaissance vocale, et la saisie vocale de Page Assist utilise le système de reconnaissance propre au navigateur, configuré sous Speech Recognition Language, plutôt qu’un appel API. Laissez ces deux sections configurées comme elles le sont déjà.

Cette configuration est tirée de la documentation du fournisseur et des libellés de sa propre interface à la date indiquée ci-dessous. Kunavo n’a pas exécuté Page Assist avec son endpoint : aucune version de l’extension n’a été épinglée, aucune session dans la barre latérale, aucune réponse en streaming ni aucun échange d’appels d’outils. Une page de configuration publiée ne constitue pas un test, et rien ici ne doit être interprété comme tel. Vous pouvez vérifier vous-même en dix secondes le curl ; le comportement de l’extension au-delà d’un endpoint fonctionnel relève de Page Assist.

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 Page Assist.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Cliquez sur l’icône Page Assist dans la barre d’outils du navigateur, puis sur l’icône Settings et ouvrez l’onglet OpenAI Compatible API.
Cliquez sur Add Provider. Kunavo ne figure pas parmi les préréglages de la liste déroulante ; choisissez donc Custom — c’est la branche indiquée à l’étape 5 du guide du fournisseur pour tout ce qui n’y figure pas.
Renseignez Provider Name, Base URL = https://api.kunavo.com/v1 et API Key, puis cliquez sur Save.
Dans la Model List qui s’ouvre, cochez les identifiants souhaités. Deux est généralement le bon nombre : un modèle peu coûteux pour résumer les pages et un modèle performant pour les questions qui suivent.
Ouvrez la barre latérale sur une vraie page — Ctrl+Shift+L ouvre l’interface Web —, choisissez le modèle dans le sélecteur et posez-lui une question sur l’onglet. Une page qui contient du contenu réel vous en apprendra davantage qu’un simple message de bienvenue, car le texte de la page est ce qui coûte de l’argent.

Vérifié avec La page OpenAI Compatible API de Page Assist 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.

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 Page Assist.

# 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 Page Assist
`claude-haiku-4-5`	$0.70 / $3.50	le choix par défaut pour une barre latérale : résumés de pages et questions de suivi, où le volume domine
`gpt-5-6-terra`	$0.70 / $4.20	les pages longues — documentation, fils de discussion, transcriptions — envoyées intégralement plutôt que raccourcies
`claude-sonnet-5`	$1.40 / $7.00	la question qui suit le résumé, lorsque la réponse doit être juste
`gpt-5-6-sol`	$2.00 / $12.00	un second avis provenant d’une autre famille ; ajoutez-le comme deuxième identifiant coché, chez le même fournisseur

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.

Ce que la page vous coûte et ce qui quitte le navigateur

La facturation d’un client avec barre latérale diffère de celle d’un éditeur, et la différence tient à la page. À chaque échange entre Page Assist et l’onglet, le texte extrait de celui-ci est envoyé sous forme de jetons d’entrée : une page de documentation ou un long fil de discussion peut en contenir des dizaines de milliers, et ce texte est renvoyé à chaque question de suivi dans la même conversation. C’est pourquoi le tableau des modèles ci-dessus commence par les identifiants les moins chers : avec ce client, le volume d’entrée dépasse généralement celui de sortie d’un ordre de grandeur, et claude-haiku-4-5 ou gpt-5-6-terra qui lit une page entière est préférable à un modèle plus performant qui n’en lit qu’une version tronquée.

Trois paramètres génèrent du trafic sans que vous l’ayez demandé explicitement, et ils figurent tous sur la page Settings du fournisseur :

Generate Title using AI — « Génère automatiquement un titre de chat à partir de la conversation ». Un appel supplémentaire par conversation, avec le modèle sélectionné.
Internet Search, avec Internet Search ON by default et Total Search Results : les pages récupérées sont ajoutées au prompt, et le coût en jetons augmente donc avec le nombre de résultats.
Page Action, l’extension associée : le modèle « commence par lire la page, puis effectue les actions une par une ». Le DOM est donc lu à chaque étape, et non une fois par conversation. L’option Require approval before each action est activée par défaut ; il est recommandé de la laisser activée.

La limite de confidentialité suit la même logique. Page Assist stocke localement dans le navigateur les conversations, la base de connaissances et les paramètres ; ce qui traverse le réseau, c’est ce que vous envoyez. Une fois ce fournisseur sélectionné, cela signifie que le texte de la page, votre message et l’historique de la conversation sont transmis à api.kunavo.com, puis au fournisseur amont qui sert l’identifiant du modèle. Consultez la politique de confidentialité pour savoir ce qui est conservé de notre côté. Si vous ne copieriez pas une page dans une fenêtre de chat, repassez à une instance Ollama locale pour la traiter ; l’extension permet de configurer les deux fournisseurs en même temps précisément pour que ce changement se fasse depuis une seule liste déroulante.

Si vous êtes arrivé ici depuis le préréglage OpenRouter

OpenRouter n’a pas besoin de la branche Custom. Il figure parmi les préréglages de la page OpenAI Compatible API du fournisseur, aux côtés d’Ollama, LM Studio, Groq, Together, Mistral, xAI et d’une vingtaine d’autres. Suivez les quatre mêmes premières étapes, puis choisissez OpenRouter dans la liste déroulante à la place de Custom, saisissez sa clé dans API Key et cliquez sur Save. Le préréglage fournit sa propre Base URL et les identifiants de modèle OpenRouter sont préfixés par le fournisseur — au format anthropic/claude-sonnet-4.5 —, tandis que ceux du tableau ci-dessus ne comportent pas de préfixe. Choisir un fournisseur revient ici à choisir l’espace de noms des identifiants à saisir.

Dans le cas précis de ce client, le changement vaut la peine si vous voulez accéder depuis un seul écran à des modèles que Kunavo ne propose pas, ou si vous avez déjà une clé et que la configuration supplémentaire ne vous coûte rien. Passer à Kunavo vaut la peine parce que les identifiants du tableau sont aussi ceux que vous utilisez dans vos outils de programmation : une même clé couvre les deux, et la mise en cache des prompts pour le contexte de page renvoyé est le principal facteur de coût d’une barre latérale — voir la mise en cache. Rien ne vous empêche de conserver les deux fournisseurs : Page Assist les affiche ensemble, et le sélecteur de modèles ne tient pas compte du fournisseur associé à chaque entrée.

Questions fréquentes

Comment utiliser une API personnalisée avec Page Assist ?

Cliquez sur l’icône Page Assist dans la barre d’outils du navigateur, ouvrez Settings, accédez à l’onglet OpenAI Compatible API, puis cliquez sur Add Provider. Si votre endpoint ne figure pas parmi les préréglages de la liste déroulante, sélectionnez Custom et renseignez Provider Name, Base URL et API Key, puis cliquez sur Save. Page Assist ouvre ensuite une Model List récupérée depuis l’endpoint, où vous cochez les modèles de chat à utiliser avec ce fournisseur. Vous pouvez aussi saisir les identifiants manuellement via Add Custom Model si la récupération ne renvoie aucun résultat.

L’URL de base de Page Assist doit-elle se terminer par /v1 ?

Oui, pour un endpoint compatible avec OpenAI. La page OpenAI Compatible API ne le précise pas, mais le texte d’aide du champ Base URL l’indique : « L’URL de base du fournisseur de l’API OpenAI. ex. (http://localhost:1234/v1) ». Les pages LM Studio et LLaMA.cpp affichent le même suffixe pour ce champ : http://localhost:1234/v1 et http://localhost:8080/v1. Pour Kunavo, utilisez donc https://api.kunavo.com/v1. Page Assist ajoute uniquement la route ; si vous omettez le suffixe, vous obtiendrez une erreur 404 plutôt qu’une erreur d’authentification.

Pourquoi Page Assist n’affiche-t-il aucun modèle après l’ajout d’un fournisseur ?

La liste est récupérée depuis l’endpoint avec la clé que vous venez de saisir, et le propre message de l’extension indique ce qu’il faut vérifier : « Aucun modèle trouvé. Vérifiez que vous avez ajouté un fournisseur correct avec une URL de base et une clé API. » Testez la même paire en dehors de l’extension avec une requête curl vers /v1/models : si vous obtenez du JSON, le problème vient de la configuration du fournisseur ; une erreur 401 indique un problème de clé et une erreur 404 signale généralement qu’il manque /v1 dans la Base URL. Sinon, ajoutez les identifiants manuellement via Add Custom Model ; cette méthode ne dépend pas de la récupération.

Page Assist peut-il utiliser Claude ou GPT à la place d’un modèle local ?

Oui. « OpenAI Compatible API » désigne le format de communication, et non le fournisseur ; l’identifiant du modèle est transmis au Base URL que vous avez configuré. Un identifiant Claude ou GPT est donc résolu par cet endpoint, et non par l’extension. Les fonctionnalités des modèles locaux ne sont pas affectées : Page Assist peut gérer plusieurs fournisseurs simultanément, vous pouvez donc utiliser en parallèle une entrée Ollama et une entrée hébergée, puis passer de l’une à l’autre avec le sélecteur de modèles.

Quel modèle coûte le moins cher avec Page Assist ?

Avec ce client, les jetons d’entrée dominent, car chaque échange dans un onglet renvoie le texte extrait de celui-ci dans la conversation. Un modèle économique avec un contexte étendu constitue donc le meilleur choix par défaut : claude-haiku-4-5 pour les pages ordinaires, gpt-5-6-terra pour les pages longues. Vous pouvez aussi cocher un identifiant plus performant, comme claude-sonnet-5, pour les questions dont la réponse compte. Le tableau de cette page indique les tarifs par million pour chacun, et la mise en cache des prompts influe davantage sur la facture de la barre latérale que le choix du modèle.

La Knowledge Base de Page Assist peut-elle utiliser Kunavo ?

Pas pour l’étape d’indexation. La Knowledge Base est une fonctionnalité RAG, et la documentation du fournisseur indique qu’il faut configurer un modèle d’embedding dans RAG Settings ; elle recommande nomic-embed-text. Kunavo ne fournit aucun modèle d’embedding, cette option nécessite donc un autre fournisseur. Une instance Ollama locale est le choix habituel et fonctionne en parallèle sans conflit. La partie chat n’est pas affectée : une fois les documents indexés, le modèle qui répond aux questions les concernant peut être n’importe quel identifiant de chat de ce fournisseur.

Kunavo a-t-il testé Page Assist ?

Non. La vérification effectuée le 21 septembre 2026 porte sur la documentation OpenAI Compatible API de Page Assist et les libellés anglais de l’interface de l’extension : le parcours dans Settings, les libellés et l’ordre des champs, l’exemple de Base URL et le message affiché pour une liste vide en sont tirés. Kunavo n’a pas installé l’extension, épinglé une version ni envoyé de requête via celle-ci, et ne fait aucune affirmation concernant le streaming, l’extraction de page ou le fonctionnement de la récupération de la Model List dans une version donnée. La requête curl sur cette page est la partie que vous pouvez vérifier indépendamment.