Documentation

Amp

Amp route les modèles côté serveur : il n’y a donc aucune variable d’URL de base à définir sur votre machine. Ajoutez une connexion Custom URL dans Model Routing, et le cloud d’Amp appellera le point de terminaison. Cette fonctionnalité est réservée à une offre payante ; c’est le premier élément à vérifier.

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.

Paramètres → Routage des modèles → Ajouter → URL personnalisée

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

Vérifiez d’abord votre offre Amp. Au 2026-09-21, la page Model Routing d’Amp indique que « les routeurs et passerelles de modèles d’IA sont expérimentaux et en accès anticipé, réservés aux clients Megawatt, Gigawatt et Enterprise. Leur déploiement pour tous les utilisateurs aura bientôt lieu. » Une connexion Custom URL relève de cette catégorie ; le menu Add ne la proposera donc pas sur un compte Hobby. Amp n’a publié aucune date de déploiement, et cette page n’en prédit aucune.

Kunavo n’a pas testé Amp avec ce point de terminaison. Tous les champs ci-dessus proviennent de la documentation d’Amp, et non d’une session réalisée par notre équipe : cette fonctionnalité est réservée à une offre payante d’Amp. Considérez ceci comme une transcription des spécifications d’Amp, et laissez Check Access vous indiquer si cela fonctionne.

chat-completions conserve le suffixe /v1 dans l’URL de base, car Amp n’ajoute que la route. L’exemple détaillé de sa documentation tranche la question : « une URL de base https://api.example.com/v1 avec chat-completions envoie les requêtes vers https://api.example.com/v1/chat/completions ». La même page précise qu’une URL de base se terminant déjà par /v1 est « acceptée et n’est pas doublée » et que le formulaire de connexion affiche l’URL de requête au fur et à mesure de la saisie : vous pouvez donc vérifier l’URL assemblée avant d’enregistrer.

Les modèles système Dictation et Realtime Voice d’Amp sont des fonctionnalités vocales, et Kunavo ne propose aucun modèle de reconnaissance vocale ni de synthèse vocale. Une connexion Custom URL ne peut servir de point de terminaison pour aucun de ces modèles ; laissez ces lignes à Amp.

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

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Ouvrez Model Routing dans vos paramètres personnels (les administrateurs de l’espace de travail peuvent utiliser Workspace Model Routing pour partager une connexion avec tous les membres), ouvrez le menu Add, puis choisissez Custom URL.
Définissez le format d’API sur chat-completions, collez https://api.kunavo.com/v1 dans le champ URL de base et votre clé sk-kn- dans le champ de clé. Amp l’envoie au format Authorization: Bearer <key> dans tous les cas ; c’est l’en-tête utilisé par Kunavo pour l’authentification. Laissez donc les champs Headers et Query Parameters vides.
Saisissez la correspondance des modèles, à raison d’un motif par ligne. À gauche se trouve l’ID canonique du modèle Amp ; à droite, après ->, l’ID reçu par Kunavo. Les deux libellés diffèrent (Amp écrit openai/gpt-5.6-sol, Kunavo reconnaît gpt-5-6-sol), la flèche est donc indispensable. Utilisez le sélecteur Models pour insérer les ID canoniques au lieu de les saisir de mémoire.
Cliquez sur Check Access. Amp répertorie les modèles du point de terminaison lorsque la correspondance est générale et envoie une requête d’un jeton lorsque la correspondance désigne exactement un modèle. Vérifiez ensuite que le graphe de routage sous la liste des connexions indique que Kunavo sert les modèles que vous avez associés, et que tous les modèles non associés indiquent toujours Amp.

Vérifié avec Documentation Model Routing d’Amp 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 ce que coûte Amp et ce qu’une connexion change ou ne change pas sur la facture.

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

# 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 Amp
`gpt-5-6-sol`	$2.00 / $12.00	l’agent principal du mode Medium et Puck, le modèle de travail par défaut d’Amp
`gpt-6-astra`	$4.00 / $20.00	l’agent principal du mode High et le sous-agent Oracle dans la plupart des modes
`claude-fable-5-1`	$7.00 / $35.00	l’agent principal du mode Ultra, réservé aux tâches complexes et ouvertes
`gpt-5-6-terra`	$0.70 / $4.20	le sous-agent Search : récupération dans la base de code, où le volume domine
`claude-haiku-4-5`	$0.70 / $3.50	View Media, le modèle d’Amp pour les images, les PDF et les vidéos : Claude lit les images, pas les vidéos

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 qu’une connexion ne change pas

Le routage des modèles change qui facture vos jetons, et rien d’autre. Le calcul orb d’Amp est facturé séparément à la minute ; une connexion ne change donc rien à cette ligne. Les outils hors modèles, comme la recherche Web, continuent de consommer des crédits Amp quel que soit le routage des modèles. L’abonnement Amp qui déverrouille l’option Custom URL est lui-même un coût fixe à payer avant le premier jeton.

Deux modèles utilisés par défaut par Amp ne figurent pas dans le tableau ci-dessus, car Kunavo ne les propose pas : les modèles GLM utilisés par le mode Low et le sous-agent Read Thread. Une connexion ne peut pas reproduire la configuration de l’offre la moins chère d’Amp ; une correspondance définie sur */* laissera donc ces deux modèles sur Amp sans avertissement. C’est le comportement attendu, et non une erreur de configuration : selon la règle d’Amp, tout modèle qu’aucune connexion ne sert est servi par Amp.

Questions fréquentes

Amp peut-il utiliser un point de terminaison d’API personnalisé ?

Oui, avec une connexion Custom URL dans Model Routing, mais pas avec toutes les offres. La documentation Model Routing d’Amp indique que les routeurs et passerelles de modèles d’IA, catégorie dont relève Custom URL, sont expérimentaux et en accès anticipé, réservés aux clients Megawatt, Gigawatt et Enterprise. Amp précise qu’il les déploiera bientôt pour tous les utilisateurs, sans indiquer de date. C’était la situation au 21 septembre 2026. Sur un compte Hobby, le menu Add ne propose pas du tout cette option ; vérifiez donc d’abord votre offre, plutôt que l’URL de base.

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

Cela dépend du format d’API choisi, d’où les fréquentes erreurs d’interprétation de ce champ. Avec chat-completions, Amp ajoute uniquement /chat/completions ; l’URL de base doit donc être la racine /v1. Dans son exemple documenté, https://api.example.com/v1 devient ainsi https://api.example.com/v1/chat/completions. Avec anthropic-messages, Amp ajoute plutôt /v1/messages ; l’origine seule convient alors. Amp précise aussi qu’une URL de base se terminant déjà par /v1 est acceptée et que le suffixe n’est pas ajouté une deuxième fois. Le formulaire de connexion affiche l’URL de requête assemblée au fur et à mesure de la saisie ; vous pouvez donc la vérifier avant d’enregistrer.

Où Amp stocke-t-il la clé d’API d’un point de terminaison personnalisé ?

Sur les serveurs d’Amp, et non sur votre machine. Amp relaie les requêtes d’inférence depuis son propre cloud. Une connexion Custom URL se configure donc dans Model Routing, dans les paramètres de votre compte, plutôt que dans un fichier de configuration local ou une variable d’environnement. Le point de terminaison indiqué doit être accessible depuis l’infrastructure d’Amp. Amp envoie les identifiants dans un en-tête Authorization: Bearer pour ses trois formats d’API. La documentation publiée des paramètres CLI d’Amp ne comporte ni paramètre d’URL de base ni paramètre de clé d’API : c’est le même constat du côté du client.

Pourquoi Amp utilise-t-il encore ses propres modèles après l’ajout d’une connexion ?

Parce qu’une connexion ne sert que les modèles inclus dans sa correspondance ; Amp sert lui-même tous les autres. Vérifiez trois éléments dans l’ordre : si la connexion est active ; sa position dans la liste de priorité — connexions personnelles d’abord, puis celles de l’espace de travail, puis Amp, la priorité 0 étant essayée en premier ; enfin, si la correspondance des modèles correspond bien au modèle exécuté par votre mode. Le graphe de routage sous la liste des connexions montre quelle connexion sert chaque modèle. La commande amp config model-providers check-access --provider-model lance une brève inférence et indique quelle connexion l’a réellement servie.

Kunavo a-t-il testé Amp avec son point de terminaison ?

Non. Kunavo n’a pas testé Amp en conditions réelles. Cette page retranscrit la documentation Model Routing d’Amp consultée le 21 septembre 2026 ; elle ne rend pas compte d’une session réalisée. La fonctionnalité Custom URL est réservée à une offre payante d’Amp. Les champs présentés ici ont donc été vérifiés dans les spécifications publiées d’Amp, et non avec un client en cours d’exécution. Le bouton Check Access d’Amp vérifie les identifiants auprès du fournisseur et constitue le test faisant autorité. Si le nom d’un champ indiqué sur cette page ne correspond plus à celui affiché par Amp, fiez-vous à la page d’Amp.