Qu’est-ce qu’un groupe

Comprendre la relation entre les groupes MoleAPI, la disponibilité des modèles, la stratégie tarifaire et la stabilité

Dans MoleAPI, un groupe peut être compris comme « l’ensemble des canaux de modèles et de la stratégie tarifaire qu’utilise une API Key ».

Il ne s’agit pas d’un simple champ d’affichage : il influence directement :

les modèles visibles pour cette Key
le type de canaux utilisé lors de l’appel de ces modèles
la stratégie tarifaire correspondante
dans certains cas, la stabilité et les scénarios d’usage

Pourquoi utiliser des groupes

Si la plateforme mélangeait tous les modèles, tous les prix et tous les canaux, il serait difficile pour les utilisateurs de les distinguer selon leur usage.

L’existence des groupes permet de gérer séparément différents objectifs, par exemple :

faire passer l’environnement de test et l’environnement de production par des groupes différents
faire passer le trafic sensible aux coûts par un groupe moins cher
faire passer le trafic privilégiant la stabilité par un groupe plus stable
autoriser certains modèles spécifiques uniquement pour certaines Key

Comment comprendre un groupe

Une manière plus concrète de le comprendre est la suivante :

groupe = combinaison d’un ensemble de modèles + d’une stratégie de canaux + d’une stratégie tarifaire

Ainsi, même pour un même modèle, selon le groupe, il peut y avoir :

une disponibilité différente ; changer de groupe peut rendre un modèle indisponible
un prix unitaire différent ; certains groupes peuvent bénéficier de remises
une expérience de stabilité différente ; par exemple, le groupe relay peut être moins stable

Dans le filtre de gauche de la page de tarification de la console, sélectionnez « groupe de Token disponible » pour afficher la liste des modèles visibles dans ce groupe.

Page de tarification de la console MoleAPI : à gauche, le filtre des groupes de Token disponibles (par exemple default, discount) ; après sélection d’un groupe, la liste des modèles utilisables dans ce groupe s’affiche à droite

Types de groupes courants

Voici les catégories les plus courantes et les plus faciles à comprendre dans la documentation :

Type de groupe	Caractéristiques	Scénarios adaptés
`default`	Groupe par défaut, généralement plus stable et plus polyvalent	Projets en production, usage à long terme
`discount`	Groupe promotionnel ou remisé	Sensibilité au coût, volonté de suivre les évolutions des promotions
`relay`	Prix généralement plus bas, mais l’expérience peut davantage dépendre du canal utilisé	Tests, expérimentations, scénarios plus sensibles aux coûts

Référez-vous aux informations de groupe actuellement affichées dans la console et les annonces système.

Que choisir quand on débute

Si c’est votre première intégration, il est recommandé de :

commencer par le groupe par défaut pour valider le flux de bout en bout
ajuster ensuite en fonction du prix, de la couverture des modèles et de la stabilité

En effet, pour un débutant, réussir l’intégration est plus important que chercher immédiatement l’optimisation maximale des coûts.

Quand faut-il bien distinguer les groupes

Dans les scénarios suivants, il est recommandé de planifier clairement vos groupes :

1. Séparer production et test

Évitez de mélanger le trafic de test et le trafic métier de production dans une même stratégie.

2. Vous souhaitez contrôler les coûts

Si vous êtes très sensible au prix, les groupes constituent un levier de réglage très important.

3. Les permissions diffèrent selon les systèmes

Par exemple :

les projets expérimentaux internes peuvent utiliser un groupe moins cher
les produits en production n’exposent qu’un nombre limité de modèles stables

4. Vous souhaitez observer l’effet de différents canaux

Il arrive que l’expérience d’un même modèle diffère selon le groupe. Il est alors pertinent de commencer par des tests à faible trafic avant de définir une stratégie à long terme.

Relation entre les groupes et l’API Key

Le groupe est généralement configuré au niveau de l’API Key. Lors de la création ou de la modification d’une API Key, sélectionnez le groupe auquel cette Key appartient dans « groupe de Token » (par exemple default, discount, relay) ; chaque groupe correspond à un Ratio et à un périmètre de modèles différents.

Interface de sélection du groupe de Token lors de la création ou de la modification d’une API Key : sous le champ de saisie figurent les groupes default (standard 1x), discount (tarif spécial 0.8x), relay (relai 0.3x), etc., avec leur Ratio correspondant

Cela signifie que :

différentes Key peuvent utiliser différents groupes
un même compte peut disposer simultanément de plusieurs stratégies
vous pouvez attribuer des Key différentes selon les projets ou les environnements, puis leur configurer des groupes distincts

C’est aussi la raison pour laquelle nous recommandons souvent :

une Key de test
une Key de production
si nécessaire, une Key distincte pour chaque système

Recommandations d’usage

Bonnes pratiques recommandées

les débutants devraient commencer par default
séparer plusieurs Key selon l’environnement
pour les activités critiques, privilégier d’abord la stabilité, puis envisager des groupes moins chers
avant la mise en production, effectuer des tests réels dans le groupe cible

Pratiques non recommandées

utiliser une seule Key et un seul groupe pour tous les projets
basculer directement le trafic de production vers un groupe inconnu sans bien comprendre son fonctionnement
ne regarder que le prix, sans tenir compte de la disponibilité des modèles ni de la stabilité

Conseil en une phrase

Commencez par valider le flux avec le groupe par défaut, puis optimisez les groupes selon vos besoins en coût, en modèles et en stabilité.