Aperçu
Les projets organisent le travail au sein d’une organisation API. Utilisez-les pour gérer les accès, configurer les limites des modèles et les limites de débit, créer des comptes de service et suivre l’utilisation, la facturation et les limites de dépenses pour un ensemble défini de ressources, comme les modèles, les fonctionnalités, les fils de discussion, les assistants, l’affinage et le stockage.
Les propriétaires de l’organisation peuvent consulter tous les projets actifs et archivés sur la page Projets.
Avant de commencer
Vous devez avoir le rôle de propriétaire de l’organisation pour créer un projet. Les organisations peuvent créer jusqu’à 2 000 projets par défaut.
Si votre organisation utilise la facturation consolidée, les sous-organisations apparaissent séparément dans le sélecteur d’organisation. Vous ne pouvez pas créer de projets dans une sous-organisation.
Pour changer d’organisation, ouvrez le sélecteur d’organisation et sélectionnez celle que vous voulez utiliser.
Projet par défaut
Chaque organisation comprend un projet par défaut, qui ne peut pas être supprimé. Il hérite de toute la configuration de l’organisation. Vous pouvez configurer ses limites de débit, ses autorisations de modèles virtuels et ses limites de dépenses.
Vous ne pouvez pas ajouter de membres ni de comptes de service directement au projet par défaut. Vous pouvez inclure l’accès au projet par défaut lorsque vous invitez une personne dans l’organisation, en suivant les étapes d’invitation à l’organisation décrites dans cet article.
Créer un projet
Ouvrez le sélecteur de projet et sélectionnez Créer un projet.
Entrez un nom, une description et un site Web pour votre projet.
Sélectionnez Créer.
Les propriétaires de l’organisation sont automatiquement ajoutés comme propriétaires aux nouveaux projets.
Comprendre les rôles et les accès
Le tableau résume les rôles de propriétaire et de lecteur de l’organisation ainsi que les rôles de propriétaire et de membre du projet utilisés dans ces étapes. Les membres du projet ont des autorisations semblables à celles des lecteurs de l’organisation.
| Rôle | Portée | Autorisations |
|---|---|---|
| Propriétaire | Organisation | Créer et consulter tous les projets, utilisateurs et clés API. Surveiller les projets sur la page Projets. Définir les limites de dépenses de l’organisation et des projets. Accorder l’accès aux données d’utilisation des autres utilisateurs. Archiver les projets. |
| Lecteur | Organisation | Être ajouté à des projets, effectuer des inférences, utiliser des ressources et créer des clés dans ces projets. Ne peut pas créer de projets ni gérer les utilisateurs. |
| Propriétaire | Projet | Toutes les autorisations des membres, plus l’ajout d’utilisateurs, la gestion des membres et des paramètres du projet, le changement de nom du projet, la définition de ses limites de dépenses et son archivage. |
| Membre | Projet | Effectuer des inférences, utiliser des ressources, créer des clés de projet et envoyer des requêtes API qui lisent ou modifient des données. |
Pour en savoir plus sur les rôles dans l’organisation, consultez les rôles dans l’organisation. Pour connaître les rôles supplémentaires, les rôles personnalisés et l’ensemble des autorisations, consultez le guide des rôles et des autorisations de l’API.
Visibilité des projets
Avec ces rôles standard, les utilisateurs qui ne sont pas propriétaires de l’organisation ne peuvent voir que les projets dont ils font partie. Les propriétaires de l’organisation peuvent voir tous les projets, les membres et les clés API de projet, et peuvent accéder à la page Projets.
Les membres d’un projet peuvent voir les autres membres de leur projet et le rôle de chacun. Seuls les membres du projet et les propriétaires de l’organisation peuvent voir les modèles affinés, les fils de discussion des assistants et les fichiers créés ou ajoutés dans ce projet.
Vous pouvez faire partie d’autant de projets que nécessaire. Une clé API personnelle créée dans un projet est limitée à ce projet et à ses ressources.
Portée des ressources
Les fichiers, les assistants, le stockage et les fils de discussion sont limités à leur projet. Les membres non administrateurs qui ne font pas partie de ce projet ne peuvent pas accéder à ses ressources, et les ressources ne peuvent pas être déplacées d’un projet à l’autre.
Les modèles affinés du projet par défaut font exception : ils sont accessibles à partir d’autres projets.
Gérer les membres du projet
Inviter une personne dans votre organisation
Une personne doit faire partie de votre organisation avant que vous puissiez l’ajouter à un projet.
Lorsque vous invitez une personne dans l’organisation, vous pouvez inclure l’accès au projet par défaut en sélectionnant cette option dans le formulaire d’invitation. Laissez cette option désélectionnée si vous ne voulez pas accorder l’accès au projet par défaut. Les nouveaux membres de l’organisation ne sont pas automatiquement ajoutés au projet par défaut.
Vous n’avez pas besoin de créer un autre projet avant d’inviter une personne. Vous pouvez aussi ajouter une personne à un projet après qu’elle a accepté l’invitation à rejoindre l’organisation.
Les invitations envoyées par l’API d’administration suivent les règles du point de terminaison /organization/invites.
Ajouter un membre de l’organisation à un projet
Les propriétaires de l’organisation et du projet peuvent ajouter des membres :
Accédez aux paramètres de l’organisation.
Sélectionnez le projet, puis ouvrez Membres.
Sélectionnez + Ajouter un membre.
Sélectionnez l’utilisateur et attribuez-lui le rôle de Membre ou de Propriétaire.
La liste des utilisateurs affiche les utilisateurs de l’organisation ayant le rôle de Lecteur. Elle n’inclut pas les comptes de service.
Si une invitation échoue dans l’interface utilisateur ou l’API d’administration, vérifiez que le projet cible existe et n’est pas archivé avant de renvoyer l’invitation.
Modifier un rôle ou retirer un membre
Les propriétaires de l’organisation et du projet peuvent modifier le rôle d’un utilisateur dans le projet ou le retirer de ce projet.
Accédez aux paramètres de l’organisation.
Sélectionnez le projet, puis ouvrez Membres.
Attribuez à l’utilisateur le rôle de Membre ou de Propriétaire, ou sélectionnez Retirer pour le retirer.
Créer et gérer des comptes de service
Un compte de service fournit un accès système plutôt que de représenter un utilisateur individuel. Les comptes de service sont limités aux projets.
La création de comptes de service nécessite des autorisations de gestion des comptes de service. Les propriétaires de l’organisation et du projet disposent de ces autorisations.
Créer un compte de service
Choisissez le projet dans le sélecteur de projet.
Accédez aux paramètres de l’organisation et sélectionnez le projet.
Ouvrez Membres et sélectionnez + Compte de service.
Entrez un identifiant unique de compte de service composé de lettres, de chiffres et de traits d’union.
Sélectionnez Créer.
Les comptes de service créés au niveau du projet sont propres au projet et ne peuvent pas être utilisés à l’extérieur du projet dans lequel ils sont créés.
Le même format d’identifiant s’applique, que vous créiez le compte de service à partir des paramètres de l’organisation ou du projet.
Un compte de service créé pour un projet est propre à ce projet et ne peut pas être utilisé en dehors de celui-ci.
Enregistrer la clé secrète
La création du compte de service crée immédiatement une clé API et affiche sa clé secrète. Enregistrez la clé secrète en lieu sûr. Vous ne pourrez pas la consulter de nouveau dans votre compte OpenAI. Si vous la perdez, générez une nouvelle clé.
Par défaut, la clé de compte de service peut lire et modifier toutes les ressources API de son projet. Vous pouvez modifier ces autorisations par la suite dans les paramètres Clés API du projet.
Mettre à jour ou supprimer un compte de service
Les comptes de service apparaissent aux côtés des utilisateurs dans les paramètres Membres du projet. Gérez leur accès au projet en suivant les mêmes étapes de changement de rôle et de retrait que pour les autres membres du projet.
Tous les comptes de service apparaissent aussi aux côtés des utilisateurs sur la page Membres de l’organisation, y compris les comptes créés à partir des paramètres de l’organisation et du projet.
Dans le menu Membres de l’organisation, vous pouvez modifier le rôle d’un compte de service ou sélectionner Retirer.
Créer et gérer des clés API
Chaque projet possède ses propres clés API :
Accédez aux paramètres de l’organisation.
Sélectionnez le projet, puis ouvrez Clés API.
Sélectionnez + Créer une nouvelle clé secrète pour créer une clé, ou sélectionnez l’icône de modification à côté d’une clé existante pour modifier ses autorisations.
Choisir les autorisations de la clé
Pour les clés appartenant à un utilisateur, vous pouvez définir les autorisations lors de la création de la clé ou les modifier plus tard :
Toutes : Toutes les autorisations. Il s’agit de l’option par défaut.
Restreintes : Choisissez les portées pour des ressources ou des points de terminaison précis. Les options disponibles dépendent de la ressource et peuvent inclure Aucune, Lecture, Écriture ou des autorisations propres à la requête.
Lecture seule : Autorisations de lecture pour tous les points de terminaison.
Par exemple, une clé restreinte peut exclure l’accès en lecture et en écriture au point de terminaison /v1/assistants.
La création de clés de compte de service nécessite des autorisations de gestion des comptes de service. Si vous ne voyez pas cette option, demandez à un propriétaire de l’organisation ou du projet de créer la clé de compte de service. La boîte de dialogue de création de clés n’affiche pas ces commandes d’autorisation pour les clés de compte de service; modifiez leurs autorisations par la suite dans les paramètres Clés API du projet.
Configurer l’accès aux modèles et les limites de débit
La gestion des limites de débit d’un projet nécessite des autorisations d’administration. Les propriétaires de l’organisation disposent de ces autorisations, et les propriétaires de projet peuvent aussi gérer les limites de débit du projet au moyen de l’API de gestion.
Accédez aux paramètres de l’organisation.
Sélectionnez le projet, puis ouvrez Limites.
Utilisez Utilisation des modèles pour choisir les modèles que le projet peut utiliser.
Définissez une limite de débit pour chaque modèle, au besoin.
Définir des limites et des alertes de dépenses
Des limites de dépenses mensuelles pour l’API sont disponibles au niveau de l’organisation et du projet. Vous devez avoir l’autorisation de gérer les paramètres de l’organisation ou du projet concerné avant de modifier une limite.
Une limite de dépenses permet de surveiller les dépenses sans bloquer les requêtes. Activez Appliquer une limite stricte si vous voulez que les requêtes API échouent une fois que les dépenses suivies atteignent la limite. L’application de la limite n’est pas instantanée; les dépenses enregistrées peuvent donc dépasser légèrement le montant configuré.
Les alertes de dépenses vous avisent lorsqu’un seuil est atteint; elles ne bloquent pas les requêtes.
Définir une limite de dépenses pour une organisation
Accédez aux paramètres de l’organisation.
Ouvrez Limites et trouvez Dépenses.
Définir une limite de dépenses pour un projet
Accédez aux paramètres de l’organisation.
Sélectionnez le projet, puis ouvrez Limites.
Définissez les valeurs des champs Limite de dépenses mensuelles et Alerter lorsque les dépenses atteignent.
Activez Appliquer une limite stricte si vous voulez bloquer le trafic API une fois que les dépenses suivies atteignent la limite.
Vous pouvez aussi modifier l’Utilisation des modèles sur cette page.
Si vos dépenses dépassent le budget mensuel de votre projet, comparez l’utilisation pour le même projet et le même mois. Vérifiez si l’option Appliquer une limite stricte était activée au moment de l’utilisation. Si elle était désactivée, le budget servait à surveiller les dépenses et les requêtes API se poursuivaient. Si vous voulez que les futures requêtes échouent une fois que les dépenses suivies atteignent le budget, un propriétaire de l’organisation ou du projet peut activer Appliquer une limite stricte dans les paramètres Limites du projet.
Si la limite stricte était déjà activée, les dépenses enregistrées peuvent tout de même dépasser légèrement le budget pendant que son application prend effet. Si les dépenses pour ce projet et ce mois restent nettement supérieures à la limite appliquée et demeurent inexpliquées après ces vérifications, communiquez avec l’assistance en fournissant l’identifiant du projet, la limite appliquée, les dépenses enregistrées, ainsi que les dates et le fuseau horaire pertinents. Incluez les identifiants des requêtes pertinentes, si disponibles. N’incluez pas de clés API.
Gérer les alertes de dépenses
La création d’une limite de dépenses pour un projet crée aussi, par défaut, une alerte à 100 % de la limite. Sélectionnez Ajouter une alerte pour ajouter des alertes à d’autres seuils.
Les propriétaires de l’organisation et du projet reçoivent les alertes de dépenses du projet. Vous pouvez ajouter d’autres destinataires de courriel dans les paramètres de l’alerte.
Pour connaître les étapes de configuration et le fonctionnement actuel de l’application des limites, consultez le guide des limites de dépenses.
Consulter l’utilisation et la facturation
L’utilisation peut être ventilée par projet, et vous pouvez consulter la facturation et définir des limites de dépenses pour chaque projet.
L’accès au tableau de bord d’utilisation d’un projet dépend de votre rôle dans l’organisation et des paramètres de visibilité du tableau de bord d’utilisation. Le fait d’être propriétaire d’un projet ne suffit pas à lui seul pour obtenir cet accès.
Si vous ne pouvez pas voir le tableau de bord d’utilisation d’un projet, vérifiez si la visibilité est réglée sur Visible pour les propriétaires de l’organisation.
Gérer le stockage des fichiers
Chaque projet dispose d’un quota de stockage de fichiers de 100 Go. Si vous le dépassez, vous pourriez voir cette erreur :
Vous avez dépassé votre quota de stockage de fichiers. Les organisations sont limitées à 100 Go de fichiers. Veuillez réduire la taille du fichier ou communiquer avec le soutien technique.
Supprimez les fichiers inutilisés pour libérer de l’espace de stockage. Vous pouvez lister les fichiers stockés au moyen de l’API pour repérer les fichiers dont vous n’avez plus besoin.
Archiver un projet
Les propriétaires de l’organisation et du projet peuvent archiver des projets à partir de la page Projets ou des paramètres du projet concerné. Entrez le nom du projet lorsque vous y êtes invité pour confirmer.
L’archivage est permanent : un projet archivé ne peut pas être restauré.
Pour consulter les projets archivés, ouvrez l’onglet Archivés sur la page Projets.
La seule exception est que les ajustements fins dans le « projet par défaut » peuvent être accessibles à partir d’autres projets.
Vous avez dépassé votre quota de stockage de fichiers. Les organisations sont limitées à 100 Go de fichiers. Veuillez réduire la taille des fichiers ou contacter le soutien.Les projets ne peuvent pas être supprimés. OpenAI conserve leur historique pour le suivi de l’utilisation et de la facturation.