Modèles

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 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, 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 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. 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/<id>. 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.

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 <PROVIDER_ID>_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 :

Ouvrez Customize → Models → Providers et repérez OpenCode Go.
Choisissez Sign in with OpenCode. Copiez le code, choisissez Open auth page et approuvez l’appareil dans votre espace de travail OpenCode.
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 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.)

Un modèle explicitement défini — le champ model: d’une session, d’un canal ou d’un déclencheur.
Le modèle par défaut de l’agent pour ce projet.
Le modèle par défaut du projet.
Le modèle par défaut du compte.
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 pour le champ model: du déclencheur.

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.

Créez une clé dans Customize → Gateway, onglet Gateway.
Démarrez Claude Code en définissant la passerelle comme point de terminaison de son API :

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