Fonctionnalités de la plateforme
Comptes entreprise
Comment se comportent les clés API, les budgets des membres, les erreurs et les journaux lorsqu'une équipe partage un solde d'entreprise.
Un compte entreprise permet à toute une équipe de dépenser à partir d’un seul solde. Le solde du compte du propriétaire devient le solde de l’entreprise, chaque membre appelle l’API avec sa propre clé, et chaque débit est prélevé sur ce solde partagé. Les endpoints, les corps de requête et la configuration des clients sont les mêmes que pour un compte personnel ; cette page ne couvre que ce qui change lorsque l’appelant appartient à une entreprise.
Un membre envoie une requête
acme-…Avec sa propre clé, qui commence par le préfixe de l'entreprise.
Vérification du budget
Le coût estimé doit tenir dans ce qui reste du budget du membre.
Facturé à l'entreprise
Aux prix, groupes et abonnement du compte du propriétaire.
Journalisé au nom du membre
Le propriétaire et les administrateurs peuvent la ventiler par membre, modèle, clé et date.
| Rôle | Compte | Ce qu’il peut faire |
|---|---|---|
| Propriétaire | Le compte qui a fait la demande | Son solde est le solde de l’entreprise. Gère tout le monde, recharge le solde et voit l’utilisation de toute l’entreprise. Ne peut pas être désactivé. |
| Administrateur | Créé à partir d’une invitation | Appelle l’API dans la limite d’un budget, invite et gère les membres, recharge le solde et voit l’utilisation de toute l’entreprise. |
| Membre | Créé à partir d’une invitation | Utilise l’API, l’atelier d’images et de vidéos et Castaly dans la limite d’un budget. Ne peut pas recharger le solde. |
Les administrateurs et les membres sont de nouveaux comptes créés à partir d’une invitation par e-mail. L’adresse invitée ne doit pas déjà être inscrite : un compte personnel existant ne peut donc pas rejoindre une entreprise. Ces comptes ne participent pas aux récompenses de la plateforme.
Le propriétaire et les administrateurs peuvent désactiver un compte à tout moment ; ses sessions et ses clés cessent alors immédiatement de fonctionner. Les comptes sont désactivés, jamais supprimés : leur historique d’utilisation est conservé.
Clés API
Section intitulée « Clés API »Les clés d’entreprise commencent par le préfixe de clé de l’entreprise, par exemple acme- suivi de 48 lettres et chiffres. Vous choisissez le préfixe lors de la demande ; il est fixé à l’approbation et ne peut plus être modifié ensuite. Un préfixe compte de 2 à 16 lettres minuscules et chiffres et commence par une lettre.
La même clé fonctionne aussi avec sk- à la place du préfixe. Utilisez cette forme pour tout client qui n’accepte que les clés commençant par sk- : les deux formes désignent la même clé, avec les mêmes autorisations et la même facturation.
Authorization: Bearer acme-<48 characters>Authorization: Bearer sk-<48 characters>Une clé présentée avec un préfixe qui n’est pas celui de sa propre entreprise est rejetée comme clé invalide avec 401.
Les clés créées par le propriétaire avant l’approbation de la demande s’affichent elles aussi avec le préfixe de l’entreprise. Leur forme en sk- continue de fonctionner : les intégrations existantes n’ont rien à changer.
Les administrateurs et les membres ne créent et ne voient que leurs propres clés dans la console. Le propriétaire et les administrateurs peuvent gérer toutes les clés de l’entreprise depuis la console entreprise, filtrées par membre.
Budgets des membres
Section intitulée « Budgets des membres »Chaque administrateur et chaque membre dispose d’un budget. Aucun argent ne leur est transféré ; le budget est le montant maximal qu’ils peuvent dépenser sur le solde de l’entreprise.
| Mode | Comportement |
|---|---|
| Illimité | Limité uniquement par le solde de l’entreprise. |
| Ponctuel | Une enveloppe fixe qui ne se réinitialise jamais d’elle-même. |
| Mensuel | Repart de zéro à 00:00 UTC le 1er de chaque mois. |
Modifier uniquement la limite conserve le montant déjà utilisé. Passer à un autre mode repart de zéro.
Avant l’exécution d’une requête, la passerelle réserve son coût estimé sur le budget restant du membre et refuse la requête s’il ne suffit pas. La requête est ensuite réglée à son coût réel. Le règlement ne refuse jamais : la dernière requête peut donc faire légèrement dépasser la limite à un membre, et la suivante est refusée. Lorsqu’une requête échoue ou est remboursée, le montant revient aussi au budget du membre.
Les membres reçoivent un e-mail lorsqu’ils ont utilisé 80 % de leur budget, puis à nouveau lorsqu’il est épuisé.
Facturation, groupes et limites de débit
Section intitulée « Facturation, groupes et limites de débit »Pour la passerelle, la requête d’un membre est une requête du compte du propriétaire. Tout, hormis le budget, suit le propriétaire :
- Les débits sont prélevés sur le solde de l’entreprise comme ils le seraient pour le propriétaire, abonnement du propriétaire compris.
- Les prix, les groupes et les modèles qu’une clé peut appeler sont ceux du compte du propriétaire.
- Les limites de débit s’appliquent à l’entreprise entière. Le propriétaire et tous les membres partagent un même quota : un
429peut donc venir du trafic de quelqu’un d’autre.
Lorsque le solde de l’entreprise est épuisé, les requêtes de tout le monde dans l’entreprise échouent avec 403 et insufficient_user_quota, comme pour un compte personnel. Le propriétaire et les administrateurs peuvent recharger depuis la console entreprise ; les membres ne le peuvent pas. Si une alerte de solde est définie, le propriétaire et les administrateurs reçoivent un e-mail lorsque le solde passe en dessous.
| Situation | Statut | Comment la reconnaître |
|---|---|---|
| La clé porte le préfixe d’une autre entreprise | 401 |
Rejetée comme clé invalide |
| Le budget du membre est épuisé | 403 |
code vaut enterprise_member_budget_exhausted |
| Le membre a été désactivé, ou l’entreprise a été suspendue | 403 |
message indique que le compte est désactivé |
| Le solde de l’entreprise est épuisé | 403 |
code vaut insufficient_user_quota |
| L’entreprise dans son ensemble a atteint une limite de débit | 429 |
Comme pour un compte personnel |
Réessayer ne résout pas les cas 401 et 403. Une erreur de budget disparaît lorsqu’un administrateur relève la limite ou, pour un budget mensuel, au début du mois suivant ; une erreur de solde disparaît après une recharge.
Tâches asynchrones
Section intitulée « Tâches asynchrones »Une tâche soumise avec la clé d’un membre ne peut être consultée qu’avec les clés de ce membre. La consulter avec la clé d’un autre membre renvoie le même résultat qu’une tâche inexistante. Les clés du propriétaire peuvent consulter les tâches soumises par n’importe qui dans l’entreprise.
Utilisation et journaux
Section intitulée « Utilisation et journaux »- Chaque journal de requête indique quel membre a envoyé la requête.
- Dans leur propre console, les administrateurs et les membres ne voient que leurs propres requêtes.
- La page des journaux du propriétaire affiche les requêtes de toute l’entreprise, avec une colonne Membre supplémentaire.
- Le propriétaire et les administrateurs peuvent ventiler les dépenses par membre, modèle, clé et date dans la console entreprise, et ouvrir les requêtes individuelles de n’importe quel membre.
- La période couverte suit la conservation des journaux du compte du propriétaire, voir Conservation des données. Si le propriétaire la raccourcit, les rapports de l’entreprise raccourcissent d’autant.
Obtenir un compte entreprise
Section intitulée « Obtenir un compte entreprise »Faites la demande depuis la console Modelflare en indiquant le nom de l’entreprise, le préfixe de clé souhaité et un e-mail de contact. Une fois la demande approuvée, votre compte devient le propriétaire, son solde devient le solde de l’entreprise, et vous invitez votre équipe depuis la console entreprise. La page Entreprise décrit l’offre complète.