---
title: "Modèles"
description: "Comment Beeuni choisit un modèle et comment la facturation fonctionne pour les modèles gérés et ceux utilisant votre propre clé."
---
Beeuni exécute chaque [session](/docs/fr/work/sessions) avec un modèle. Cette page explique
les modèles gérés et ceux utilisés avec votre propre clé de fournisseur (BYOK),
comment Beeuni choisit automatiquement un modèle et deux subtilités de
facturation à connaître.
Cette page concerne les projets pour lesquels LLM Gateway est activé. LLM
Gateway est une [fonctionnalité expérimentale](/docs/fr/feature-flags), **activée par défaut**
là où la plateforme la propose — vérifiez son état ou modifiez-le dans Settings
→ Feature flags .
La désactivation de cette option est entièrement prise en charge. Le projet
utilise alors la **gestion native des modèles d’harness standard**. Chaque session de
ce projet utilise le [harness](/docs/fr/work/harnesses) harness standard : harness expérimental appelle les modèles
uniquement par l’intermédiaire de la passerelle.
- Les clés API de vos fournisseurs (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`,
`OPENROUTER_API_KEY`, …) sont injectées dans le bac à sable sous forme de variables
d’environnement standard — ajoutez-les sur la page Model settings ou en tant
que [secrets](/docs/fr/project/secrets). harness standard se connecte automatiquement à chaque
fournisseur à l’aide de sa clé.
- Les identifiants de modèle sont des références `provider/model` natives
d’harness standard, comme `anthropic/claude-opus-4-8`. Les identifiants simples gérés et les
références `beeuni/…` n’existent pas hors de la passerelle.
- Le sélecteur de modèles affiche la même liste avant et après le démarrage du
bac à sable : les fournisseurs auxquels vos clés permettent de se connecter,
ainsi que les modèles gratuits d’OpenCode Zen (OpenCode s’y connecte sans
clé). L’effort de réflexion correspond au contrôle de réflexion du
compositeur (les variantes propres au modèle) ; les valeurs par défaut de
génération de la passerelle ne s’appliquent pas.
- Les fonctionnalités de la passerelle présentées sur cette page — modèles
gérés, chaîne de modèles par défaut, budgets, journaux — ne s’appliquent pas ;
OpenCode résout le modèle par défaut dans le bac à sable.
## Modèles gérés et BYOK
Un identifiant de modèle a l’une de ces trois formes :
- **Géré** — un identifiant simple, comme `glm-5.2`, `deepseek-v4-pro-0813` ou
`grok-4.6`. Beeuni fournit les identifiants d’accès. Les comptes cloud paient
avec des crédits Beeuni.
- **BYOK** — un identifiant `provider/model`, comme `anthropic/claude-opus-4-8`. Vous fournissez
la clé. Votre compte fournisseur paie.
- **ChatGPT** — un identifiant `codex/`. Vous connectez une fois votre
abonnement ChatGPT par OAuth, et il paie.
Connectez une clé BYOK sur la page Model settings du projet ou définissez
directement la variable d’environnement du fournisseur en tant que
[secret](/docs/fr/project/secrets).
Chaque fournisseur lit sa propre clé. Selon models.dev, certains fournisseurs
partagent une variable d’environnement, par exemple OpenCode Zen
(`opencode`) et OpenCode Go (`opencode-go`) répertorient tous deux
`OPENCODE_API_KEY`. Le fournisseur auquel appartient le nom le conserve. Tous les
autres fournisseurs lisent `_API_KEY` : OpenCode Go lit `OPENCODE_GO_API_KEY`,
Z.ai Coding Plan lit `ZAI_CODING_PLAN_API_KEY` et Moonshot China lit `MOONSHOTAI_CN_API_KEY`. Une clé
Zen ne répertorie donc jamais les modèles Go. Le formulaire de connexion et
`beeuni providers set` utilisent le nom approprié.
### OpenCode Zen et Go (connexion avec OpenCode)
Connectez OpenCode Zen ou OpenCode Go avec une clé API, ou connectez-vous
plutôt avec votre compte OpenCode Console :
1. Ouvrez **Customize → Models → Providers** et repérez **OpenCode Go**.
2. Choisissez **Sign in with OpenCode**. Copiez le code, choisissez **Open auth
page** et approuvez l’appareil dans votre espace de travail OpenCode.
3. Le champ de clé indique que le fournisseur est connecté. Supprimez la clé
pour vous déconnecter.
Depuis l’interface de ligne de commande : `beeuni providers login opencode-go`, ou `beeuni providers
login opencode` pour Zen. Les modèles Zen s’utilisent par identifiant, par
exemple `opencode/glm-5.3-flash` ; le sélecteur ne les répertorie pas. Zen et Go ont chacun
leur propre connexion ; se connecter à l’un ne connecte jamais l’autre. La
connexion dure 30 jours et Beeuni la renouvelle avant son expiration. Quand
OpenCode refuse une connexion, Beeuni la renouvelle une fois et réessaie la
requête. Si le renouvellement échoue également, la requête renvoie
`provider_reauth_required` : reconnectez-vous.
### Modèles gérés par Beeuni
Le sélecteur les répertorie sous **Beeuni**, avec leurs tarifs par jeton. La
plateforme fournit les identifiants d’accès par l’intermédiaire de sa
passerelle de modèles configurée.
| Modèle | Identifiant |
| --- | --- |
| GPT-6 Astra | `gpt-6-astra` |
| GPT-6 Sol (modèle par défaut de la plateforme) | `gpt-6-sol` |
Utilisez d’autres modèles avec une clé BYOK ou un abonnement ChatGPT. Une clé
BYOK donne accès à tout le catalogue de son fournisseur, par exemple
`anthropic/claude-opus-5-5` avec une clé Anthropic. Un abonnement ChatGPT donne accès à tous
les modèles que Codex propose à un compte ChatGPT, par exemple `codex/gpt-6.1-sol`. Par
défaut, le sélecteur affiche le modèle le plus récent de chaque famille.
Les deux listes sont mises à jour automatiquement. L’API consulte
[models.dev](https://models.dev) et la liste de modèles publiée par la CLI Codex toutes
les heures. Une nouvelle version apparaît donc dans l’heure qui suit son
inscription, sans qu’une version de Beeuni soit nécessaire. Lorsque vous
connectez un fournisseur, son modèle stable le plus récent avec appel d’outils
devient le modèle par défaut.
## Désactiver des fournisseurs ou des modèles
Ouvrez **Customize → Models → Providers**. Ouvrez le menu **⋯** sur la ligne
**Beeuni** et choisissez **Disable provider** pour utiliser uniquement vos
propres fournisseurs. Beeuni apparaît dans la même liste que les autres
fournisseurs, avec le nombre de ses modèles et une description de leur
facturation en crédits. Tous les fournisseurs utilisent le même menu. Seuls
les fournisseurs désactivés affichent un badge d’état. Choisissez **Enable
provider** dans le menu pour rétablir l’accès.
Ouvrez l’onglet **Models** pour activer ou désactiver des modèles individuels.
Un fournisseur désactivé bloque tous ses modèles, y compris ceux ajoutés par la
suite. Si vous réactivez le fournisseur, les choix relatifs aux modèles
individuels sont conservés. Les identifiants restent enregistrés.
Le modèle par défaut du projet et son fournisseur ne peuvent pas être
désactivés. Sélectionnez d’abord un autre modèle par défaut qui est activé.
Les responsables de projet peuvent modifier l’accès ; les lecteurs peuvent le
consulter.
Ces commandes s’appliquent aux nouvelles requêtes envoyées par la passerelle
Beeuni, y compris aux choix enregistrés pour les sessions et aux modèles de
repli. Une requête déjà envoyée à un fournisseur amont se termine normalement.
Les cibles désactivées renvoient `provider_disabled` ou `model_disabled` ; choisissez un
modèle activé pour continuer. Le mode harness standard natif n’utilise pas cette
politique de la passerelle.
Les préférences de visibilité existantes, limitées au sélecteur, restent
séparées. Réinitialiser la liste des modèles ne supprime pas les restrictions
d’accès explicites.
## Effort de réflexion
Dans les deux modes, le contrôle de réflexion du compositeur définit la
**variante** du modèle pour la session. Les choix sont les niveaux publiés par
le modèle lui-même (models.dev `reasoning_options`), et non une échelle fixe ; un modèle
sans réglage n’affiche aucun contrôle. `Auto` efface la variante.
- Mode natif (passerelle désactivée) : harness standard applique la variante dans le
champ de requête propre au fournisseur.
- Passerelle activée : la requête contient `reasoning_effort` ; la passerelle le
traduit pour chaque fournisseur amont (OpenAI → `reasoning_effort`, Claude →
réflexion adaptative, OpenAI sur Amazon Bedrock → champ de requête
`reasoning.effort` de Bedrock). Pour un fournisseur amont où la traduction n’est pas
encore prise en charge (Nova, Grok sur Bedrock actuellement), la valeur est
ignorée et le modèle utilise sa valeur par défaut.
- Amazon Bedrock refuse l’identifiant régional simple de la plupart des
modèles actuels (« le débit à la demande n’est pas pris en charge »). Le
sélecteur privilégie l’identifiant de profil d’inférence `global.` /
régional lorsque le catalogue en contient un, et la passerelle réessaie une
fois l’identifiant simple refusé pour chaque préfixe de profil
(`global.`, `us.`).
- À chaque démarrage, le bac à sable récupère l’ensemble des modèles utilisables
du projet auprès de l’API (`GET /v1/llm/models?scope=picker`, la même composition que celle du
sélecteur Web), afin que tout modèle proposé dans le sélecteur soit
disponible à l’exécution.
- Une valeur par défaut du projet pour chaque modèle se trouve dans Customize
→ Models → Routing → Advanced → **Generation defaults** (`model_generation_config`). Elle
ne remplit qu’un champ absent de la requête ; la variante de la session
l’emporte donc toujours.
## Comment la sélection automatique choisit un modèle
Ne définissez aucun modèle et Beeuni en résoudra un en examinant jusqu’à cinq
niveaux, dans l’ordre. (L’identifiant `auto` correspond à ce même
comportement, mais n’est pas encore disponible dans le sélecteur de modèles.)
1. Un modèle explicitement défini — le champ `model:` d’une session, d’un
canal ou d’un déclencheur.
2. Le modèle par défaut de l’[agent](/docs/fr/project/agents) pour ce projet.
3. Le modèle par défaut du projet.
4. Le modèle par défaut du compte.
5. Le modèle par défaut de la plateforme.
Beeuni utilise le premier niveau qui contient une valeur qu’il peut encore
fournir. Un modèle par défaut enregistré qui cesse de fonctionner — clé
déconnectée, modèle retiré — est automatiquement ignoré. Une session ne
s’interrompt jamais à cause d’un modèle par défaut obsolète. Consultez la
[référence du manifeste](/docs/fr/project/manifest) pour le champ `model:` du
déclencheur.
:::warning[Surprises de facturation avec BYOK]
Deux coûts sont faciles à manquer sur un compte cloud payant :
- Les crédits couvrent les appels aux modèles, les outils et l’utilisation de l’ordinateur. Consultez Billing pour le solde et Usage pour le détail.
- **Basculement silencieux.** Si votre clé BYOK atteint une limite de débit ou
rencontre une erreur de facturation au cours d’un tour, Beeuni réessaie avec
un modèle géré et facture vos crédits au lieu de faire échouer la session.
Si vous constatez des frais en crédits sur un projet utilisant uniquement
BYOK, vérifiez ces deux causes avant de signaler un problème de facturation.
:::
Lorsqu’un modèle de repli répond, la session l’indique. Le compositeur affiche
**Running on** et le nom du modèle à côté du sélecteur de modèles. Les détails
de chaque tour indiquent le modèle qui a répondu, celui qu’il a remplacé et ce
que Beeuni a facturé pour ce tour. **Customize → Models → Costs** comptabilise
ces dépenses sous le modèle qui a répondu.
## Activation des modèles par projet
Le projet contrôle les modèles proposés par ses sélecteurs. Par défaut, le
modèle le plus récent de chaque famille est proposé automatiquement. Les
modèles gérés par Beeuni ainsi que tous les modèles référencés par les valeurs
par défaut ou la politique de routage du projet sont toujours proposés — un
filtre ne les supprime jamais.
Vous pouvez remplacer la valeur par défaut pour des modèles individuels sur la
page **Manage models** (Customize → Models). Chaque exception est enregistrée
par projet et prend effet immédiatement. Le sélecteur de modèles des sessions
et la palette de commandes masquent les modèles que vous désactivez ; les
nouveaux modèles restent activés par défaut à mesure que le catalogue
s’étoffe.
L’activation détermine les modèles proposés, et non ceux qui peuvent être
utilisés : une requête qui nomme directement un modèle désactivé (par exemple
via l’API brute) s’exécute quand même. Le modèle par défaut du projet ne peut
pas être désactivé — définissez d’abord un autre modèle par défaut.
## Clés de fournisseur et accès des membres
Lorsque **Pooled provider secrets** est désactivé, une clé de fournisseur
connectée s’applique à l’ensemble du projet. Les remplacements personnels de
ces secrets du projet renvoient `llm_credentials_project_wide`.
Activez **Pooled provider secrets** et **LLM Gateway** dans Settings → Feature
flags pour utiliser les ressources de secrets de fournisseur. Ouvrez
**Customize → Models → Providers** et choisissez **Add key** à côté d’un
fournisseur. Attribuez à chaque clé un libellé distinct. La valeur ne peut pas
être lue ; les écrans suivants affichent son libellé et sa liste d’accès.
Les nouvelles clés appartiennent à ce projet. Par défaut, **Everyone in this
project** peut les utiliser. Ouvrez **⋯ → Manage access** pour une clé et
choisissez **Specific members** afin d’en limiter l’accès. Les ressources
existantes à l’échelle du compte conservent les autorisations accordées aux
membres. L’appartenance au compte, les autorisations du projet, les permissions
de l’agent relatives aux secrets et la sélection de session restent
applicables.
L’autorisation accordée à un membre permet l’utilisation sans révéler la clé.
La rotation d’une clé préserve ses accès et les sélections des sessions. Sa
suppression retire l’accès à tout le monde.
### Choisir des clés pour une session
Ouvrez **Session overrides → Provider keys** dans le compositeur. Choisissez
un fournisseur, puis sélectionnez jusqu’à dix clés. Choisissez **Save changes**
dans le pied de page du panneau. Pour une nouvelle session, la sélection est
envoyée avec le premier prompt.
- Sans sélection explicite, la clé existante du projet reste disponible.
- Ne sélectionner aucune clé désactive ce fournisseur pour la session. La clé
du projet n’est pas rétablie.
- **Reset to project default** supprime la sélection explicite.
- Les clés révoquées ou inactives apparaissent comme indisponibles. Supprimez-les
de la sélection, choisissez une autre clé ou réinitialisez la sélection.
- La suppression de la dernière clé sélectionnée laisse un pool vide. Les
paramètres de la session affichent toujours ce fournisseur, afin que vous
puissiez le réinitialiser.
- Une erreur de lecture affiche **Try again**. La clé n’apparaît jamais comme
sélection héritée.
En cas de limite de débit avant le début de la réponse, la passerelle essaie une
autre clé sélectionnée. Elle ne rejoue jamais une réponse partielle avec une
autre clé. Si toutes les clés sont limitées, réessayez après la première fin de
période de refroidissement, dans la limite de 60 secondes. Un pool explicite
n’emprunte pas silencieusement la clé d’un autre membre ni l’identifiant
hérité du projet.
### Comptes ChatGPT
Choisissez **Add account** sous **ChatGPT Plus/Pro**. Chaque autorisation crée
une connexion distincte nommée dans ce projet. Par défaut, **Everyone in this
project** peut l’utiliser. Utilisez **Manage access → Specific members** pour
limiter l’accès.
Une session peut sélectionner plusieurs comptes ChatGPT auxquels elle a accès.
Sans sélection, la connexion utilisable la plus récente du membre est celle
utilisée par défaut. La connexion partagée d’un autre membre nécessite une
sélection explicite. L’ancienne connexion du projet reste disponible si le
membre ne dispose d’aucune connexion utilisable qui lui soit propre. Une clé de
passerelle partagée ne peut pas emprunter la connexion ChatGPT privée de son
créateur.
Lorsque la passerelle est activée, les clés API Google Gemini utilisent le
point de terminaison compatible avec OpenAI de Google. Le mode harness standard natif
continue d’utiliser les secrets du projet.
Les modèles masqués par d’anciennes préférences du sélecteur portent la mention
**Hidden from picker**. Les requêtes directes restent autorisées. Ouvrez le
menu de ce modèle et choisissez **Disable model** pour bloquer également
l’inférence.
Les liens indiquant le nombre de modèles d’un fournisseur ouvrent l’onglet
**Models**. Tous les groupes de fournisseurs apparaissent ensemble dans la
même liste, où vous pouvez activer ou désactiver les modèles et définir des
valeurs par défaut. La recherche réduit la liste. Connectez un fournisseur
avant de gérer ses modèles.
Les sélections de fournisseurs restent des brouillons tant que vous n’avez pas
cliqué sur **Save changes** dans le pied de page des remplacements de session.
Cette action enregistre les modifications pour tous les fournisseurs, y
compris la réinitialisation aux valeurs par défaut. Vous pouvez changer de
section ou fermer puis rouvrir le panneau sans perdre ces brouillons. Le
rechargement de la page supprime les modifications non enregistrées.
Si l’enregistrement échoue, le panneau reste ouvert et affiche l’erreur.
Corrigez la sélection ou réessayez. Les fournisseurs déjà enregistrés le
restent ; les modifications en attente restent dans le panneau.
## Budgets
Un budget de passerelle limite les dépenses liées aux modèles d’un projet, ou
d’un membre de ce projet, par jour, par semaine ou par mois. **Block** refuse
les nouvelles requêtes une fois la limite atteinte ; **Warn only** les laisse
s’exécuter. Définissez les budgets sur la page Models du projet.
Lorsque le budget atteint 80 % puis 100 % de sa limite, Beeuni envoie un e-mail
aux propriétaires et administrateurs du compte, ainsi qu’aux responsables du
projet, une fois par seuil et par période.
## Utiliser la passerelle depuis Claude Code
La passerelle fournit l’API Anthropic Messages à `POST /v1/messages`. Claude Code et
les SDK Anthropic peuvent l’utiliser pour appeler n’importe quel modèle de la
passerelle.
1. Créez une clé dans **Customize → Gateway**, onglet **Gateway**.
2. Démarrez Claude Code en définissant la passerelle comme point de terminaison
de son API :
```bash
ANTHROPIC_BASE_URL=https://gateway.beeuni.ai \
ANTHROPIC_AUTH_TOKEN=beeuni_gw_... \
claude --model kimi-k3
```
La passerelle lit la clé depuis `Authorization: Bearer` ou depuis `x-api-key` ;
`ANTHROPIC_API_KEY` fonctionne donc également.
La passerelle traduit ces champs de Claude Code pour chaque fournisseur :
- `thinking: {type: "adaptive"}` avec `output_config.effort` devient
`reasoning_effort`. Voir [Effort de réflexion](#thinking-effort).
- L’utilisation sur le `message_delta` final comporte `input_tokens`,
`cache_read_input_tokens` et `cache_creation_input_tokens`. Claude Code
les utilise pour `/context` et la compaction automatique.
- Les images renvoyées par un outil, comme un `Read` d’une capture d’écran, parviennent au modèle
dans un message utilisateur après le résultat de l’outil.
- Un flux du fournisseur qui se termine avant la fin renvoie un événement `api_error`,
et Claude Code réessaie alors le tour.
Limites :
- `/v1/messages/count_tokens` renvoie `404`. Claude Code estime alors
le nombre de jetons à partir des caractères.
- Le texte de raisonnement n’est pas renvoyé sous forme de blocs `thinking`.
- Les modèles ChatGPT (`codex/*`) nécessitent une connexion ChatGPT partagée avec
**Tout le monde dans ce projet**. Une clé de passerelle ne peut pas utiliser une connexion privée.
- Claude Code ne permet pas de définir une fenêtre de contexte par modèle. Définissez
`CLAUDE_CODE_MAX_CONTEXT_TOKENS` sur la fenêtre la plus petite que vous utilisez.