OpenAI
Cette page a été traduite automatiquement. Afficher l’article original en anglais.

Gestion des projets dans la plateforme API

Découvrez comment créer et gérer des projets d’API OpenAI, notamment les membres, rôles, comptes de service, clés API, limites d’utilisation et budgets.

Dernière mise à jour : 2 days ago

Les projets permettent aux clients d’organiser leur travail. Les organisations peuvent gérer l’accès et les limites, provisionner des comptes de service (via l’interface utilisateur) et suivre l’utilisation dans un périmètre limité au sein d’un projet (p. ex. modèles, fonctionnalités, threads, assistants, fine-tuning, stockage, etc.). L’activité d’utilisation peut être ventilée par projet, et les utilisateurs peuvent consulter la facturation et définir des limites de dépenses par projet.

Les propriétaires d’organisation peuvent voir tous leurs projets actifs et archivés sur la page Projets. En savoir plus sur les rôles utilisateur et les autorisations dans la Plateforme API.

Image

Qui peut créer un projet ?

Seuls les propriétaires de l’organisation peuvent créer un projet. Consultez la section Rôles et autorisations pour en savoir plus.

Pour changer d’organisation, survolez le nom de votre organisation en haut à gauche de la page, puis sélectionnez l’organisation dans la liste :

Projects page with the organization switcher open, listing Personal and Staging organizations

Pour les organisations bénéficiant d’un forfait de facturation consolidée, les sous-organisations sont identifiées séparément. Il est impossible de créer des projets au sein des sous-organisations.

Image

Comment fonctionnent les projets ?

Chaque organisation comprend un « Projet par défaut » qui ne peut pas être supprimé. Vous pouvez configurer les limites de débit, les autorisations virtuelles des modèles et les plafonds de dépenses (depuis novembre 2024). Il hérite de toute la configuration de l’organisation ; vous ne pouvez donc pas y ajouter directement des membres ou des comptes de service.

Comment créer un projet ?

Survolez d’abord le nom du projet dans le coin gauche de la page, puis sélectionnez Créer un projet.

API platform project menu with Create project highlighted under Default project

Indiquez le nom, la description et le site Web de votre projet, puis sélectionnez Créer.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Comment ajouter des utilisateurs à un projet ?

Les nouveaux membres ajoutés à l’organisation ne sont pas automatiquement ajoutés au « Projet par défaut ». Les nouveaux membres peuvent être invités au projet lors de leur invitation dans l’organisation (en cochant la case « Inviter dans le projet par défaut ») ou après avoir accepté l’invitation à rejoindre l’organisation.

Les utilisateurs invités via l’API Admin suivent les règles définies par le point de terminaison /organization/invites.

Si une erreur survient lorsque vous invitez des utilisateurs à rejoindre un projet via l’interface utilisateur ou l’API Admin, vérifiez d’abord que le projet cible existe et n’est pas archivé avant de renvoyer l’invitation.

Les propriétaires de l’organisation sont automatiquement ajoutés comme propriétaires aux nouveaux projets créés dans celle-ci.

Quels sont les différents rôles des utilisateurs au sein des organisations et des projets, et quelles autorisations impliquent-ils ?

Alors que les organisations disposent des rôles « propriétaire » et « lecteur », les projets disposent des rôles « propriétaire » et « membre ». Les membres d’un projet sont comparables aux lecteurs d’une organisation. Consultez le tableau ci-dessous pour obtenir une description plus détaillée des autorisations associées à chaque rôle d’utilisateur.

RôlePortéeDescription
PropriétaireOrganisationPeut créer et consulter tous les projets, tous les utilisateurs et toutes les clés API. Peut surveiller tous les projets de l’organisation depuis la

page Projets
. Peut définir les plafonds de dépenses de l’organisation et des projets. Peut accorder à d’autres membres de l’organisation l’autorisation de consulter les informations d’utilisation. Peut archiver des projets.
LecteurOrganisationPeut effectuer des inférences, utiliser des ressources et créer des clés dans ses projets. Peut être ajouté à des projets.
Ne peut ni créer de projets ni gérer les utilisateurs.
PropriétaireProjetPeut ajouter d’autres utilisateurs au projet et renommer celui-ci, et dispose également de toutes les capacités d’un membre. Peut définir les plafonds de dépenses du projet. Peut archiver le projet.
MembreProjetPeut effectuer des inférences, utiliser des ressources et créer des clés au niveau du projet.

Si je ne suis pas propriétaire de l’organisation, à quoi ai-je accès ?

Les utilisateurs qui ne sont pas propriétaires de l’organisation peuvent uniquement voir les projets dont ils sont membres. Seul le propriétaire de l’organisation peut voir tous les projets, membres et clés API au niveau des projets, et accéder à la page Projets.

  • Seuls les membres d’un projet et les propriétaires de l’organisation peuvent voir les modèles affinés créés dans ce projet, les fils de discussion des assistants créés ou les fichiers ajoutés.

  • Les membres d’un projet peuvent voir tous les autres membres de ce projet ainsi que leur rôle, par exemple Propriétaire ou Membre.

Comment modifier le rôle d’un utilisateur dans un projet ou retirer un utilisateur d’un projet ?

Seul le propriétaire d’un projet peut modifier le rôle d’un utilisateur dans ce projet ou l’en retirer. Consultez la section Rôles et autorisations pour en savoir plus.

Pour modifier un utilisateur dans un projet, accédez aux paramètres de l’organisation, sélectionnez le projet, puis cliquez sur Membres. Vous pouvez attribuer à chaque membre le rôle de Membre ou de Propriétaire. Vous pouvez également sélectionner Retirer pour retirer l’utilisateur du projet.

Qu’est-ce qu’un compte de service et en quoi diffère-t-il d’un compte utilisateur classique ?

Un compte de service agit comme un pseudo-utilisateur conçu pour l’accès système, distinct des comptes d’utilisateurs individuels. Seuls les propriétaires de l’organisation et du projet peuvent créer des comptes de service.

Les comptes de service sont limités aux projets uniquement.

Ajouter un membre à un projet

Si vous cliquez sur le bouton + Ajouter un membre, la liste des utilisateurs de votre organisation ayant le rôle de Lecteur s’affiche. Si l’utilisateur à ajouter ne fait pas encore partie de votre organisation, vous devez d’abord l’y ajouter (vous pouvez laisser la case « Ajouter au projet par défaut » décochée si vous ne souhaitez pas lui accorder un accès plus large). Cette liste n’inclut pas les comptes de service. À cette étape, vous pouvez lui attribuer le rôle de Propriétaire ou de Membre :

Project members with Add team members dialog assigning a user the Member role

Lorsque vous ajoutez un membre à l’équipe, vous devez lui attribuer le rôle de Membre ou de Propriétaire. Les membres d’un projet peuvent envoyer des requêtes API qui lisent ou modifient des données, tandis que les propriétaires peuvent également modifier les paramètres et les plafonds de dépenses du projet, ainsi que gérer ses membres. Consultez la section Rôles et autorisations pour en savoir plus.

Comment créer un compte de service pour un projet

Accédez d’abord au projet pour lequel vous souhaitez créer un compte de service en le sélectionnant dans la liste déroulante de la barre de navigation :

API platform project switcher open with options to create a project or manage projects

Accédez ensuite aux paramètres de l’organisation -> Projet -> Membres -> puis cliquez sur + Compte de service :

Les comptes de service créés au niveau du projet sont propres au projet et ne peuvent pas être utilisés en dehors du projet dans lequel ils ont été créés.

Project Members page with Create a service account dialog after selecting the Service account option

Nommer le compte de service

Que vous créiez le compte de service au niveau de l’organisation ou exclusivement pour un projet, vous pouvez lui attribuer un identifiant unique composé de lettres, de chiffres et de traits d’union afin de l’identifier facilement.

Enregistrer la clé API du compte de service

Après avoir sélectionné le bouton Créer, une clé API est immédiatement créée pour le compte de service et la clé secrète s’affiche. Enregistrez cette clé secrète dans un emplacement sûr et sécurisé. Pour des raisons de sécurité, vous ne pourrez plus la consulter depuis votre compte OpenAI. Si vous perdez cette clé secrète, vous devrez en générer une nouvelle.

Members page with Save your key modal after creating a service account

Par défaut, la clé API du compte de service dispose d’autorisations de lecture et d’écriture sur toutes les ressources API du projet. Ces autorisations peuvent être modifiées dans les paramètres Clés API de votre projet.

Les comptes de service sont répertoriés avec les membres du projet sur la page des paramètres des membres de votre projet. Consultez cette section pour en savoir plus sur la modification ou la suppression de l’accès d’un compte de service depuis la page des paramètres des membres de votre projet.

Tous les comptes de service, dans les projets comme dans les organisations, seront affichés avec vos utilisateurs humains sur la page des membres au niveau de l’organisation.

Les comptes de service sont gérés comme des comptes ordinaires. Depuis Organization -> menu Members, vous pouvez supprimer un compte de service ou mettre à jour son rôle :

OpenAI API Members settings with a service account role menu open for Reader or Owner

Comment gérer les clés API dans les projets de mon organisation ?

Vous pouvez créer et gérer les clés API de chaque projet depuis la page des paramètres de ce projet. Dans les paramètres de l’organisation, sélectionnez le projet, puis cliquez sur Clés API.

Pour créer une clé secrète, sélectionnez + Créer une clé secrète. Vous pouvez également sélectionner l’icône Modifier à côté d’une clé secrète pour en modifier les autorisations.

API keys page for a project with the Create new secret key button highlighted

Vous pouvez définir les autorisations de chacune de vos clés API lors de la création d’une clé secrète ou en modifiant une clé existante.

Trois niveaux d’autorisation sont disponibles : Toutes, Restreintes et Lecture seule.

  • Toutes — La clé secrète dispose de toutes les autorisations. Il s’agit du paramètre par défaut.

  • Restreintes — Permet à l’utilisateur de définir les autorisations Aucune, Lecture et Écriture pour chaque point de terminaison.

  • Par exemple, vous pouvez créer une clé API qui ne dispose spécifiquement d’aucune autorisation de lecture ou d’écriture sur le point de terminaison /v1/assistants :

Create new secret key dialog in the API platform with Restricted permissions selected
  • Lecture seule — Les autorisations de lecture sont définies pour tous les points de terminaison.

Comment l’accès est-il géré pour les utilisateurs appartenant à plusieurs projets ou organisations ?

Les utilisateurs peuvent être membres d’autant de projets que nécessaire. Dans un projet, les utilisateurs peuvent générer une clé API personnelle dont la portée et l’accès sont limités à ce projet et à ses ressources.

Comment définir et gérer les limites de débit des projets de mon organisation ?

Seul le propriétaire d’une organisation peut définir et gérer les limites de débit au niveau des projets. Consultez la section Rôles et autorisations pour en savoir plus.

Dans les paramètres de l’organisation, cliquez sur le projet à modifier, puis sélectionnez Limites dans la section Projet de la liste de navigation. Vous pouvez modifier votre Utilisation des modèles sur cette page.

L’utilisation des modèles vous permet de configurer les modèles utilisables par le projet, et des limites de débit peuvent être définies pour chaque modèle selon les besoins.

Comment définir et gérer les plafonds de dépenses des projets de mon organisation ?

Seuls les propriétaires d’une organisation et ceux d’un projet peuvent définir et gérer les plafonds de dépenses du projet. Consultez la section Rôles et autorisations pour en savoir plus. Pour modifier les limites au niveau de l’organisation, accédez aux paramètres de l’organisation, cliquez sur Limites, puis faites défiler la page jusqu’à Limites d’utilisation.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Pour définir les limites de votre projet, accédez aux paramètres de l’organisation, cliquez sur le projet à modifier, puis sélectionnez Limites. Vous pouvez modifier le Plafond de dépenses mensuel, le Seuil de notification et l’Utilisation des modèles.

La définition d’un plafond de dépenses mensuel vous permet d’établir des seuils de dépenses souples pour votre projet. Lorsque l’utilisation dépasse cette limite au cours d’un mois civil donné (UTC), les requêtes API continuent d’être traitées sans interruption. Cette fonctionnalité vous aide à surveiller l’utilisation grâce aux alertes de plafond de dépenses, mais elle n’impose aucun plafond strict aux dépenses. Lorsqu’un plafond de dépenses est créé pour un projet, une alerte est créée par défaut au seuil de 100 %. Vous pouvez définir des alertes supplémentaires à différents seuils en cliquant sur Ajouter une alerte.

Veuillez noter que les propriétaires de l’organisation et du projet recevront toujours ces messages et que ce comportement n’est pas personnalisable.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Comment définir des plafonds de dépenses pour mon organisation ou mon projet ?

OpenAI prend désormais en charge les plafonds mensuels de dépenses API au niveau de l’organisation comme du projet. Un plafond de dépenses peut surveiller les dépenses sans les bloquer, ou être appliqué comme limite stricte afin que les requêtes API échouent une fois le plafond atteint. Pour connaître les dernières étapes de configuration et le comportement actuel, consultez Plafonds de dépenses dans la documentation destinée aux développeurs.

Comment supprimer ou archiver un projet ?

Les projets peuvent être archivés depuis la nouvelle page de liste des projets ou depuis les paramètres d’un projet. Une fois archivé, un projet ne peut pas être restauré. Lorsque vous lancerez l’archivage, vous devrez saisir le nom du projet pour continuer.

Vous pouvez consulter la liste de tous les projets archivés dans l’onglet « Archivés » de la même page de liste des projets.

API platform Projects page with the Archived tab selected to view archived projects

Il est impossible de supprimer des projets. Nous conservons l’historique de tous les projets afin d’assurer la continuité du suivi de l’utilisation et de la facturation.

Le nombre de projets que mon organisation peut avoir est-il limité ?

Par défaut, les organisations peuvent créer jusqu’à 2 000 projets.

Les ressources peuvent-elles être partagées entre plusieurs projets ?

Les ressources d’un projet, telles que les fichiers, assistants, espaces de stockage ou fils de discussion, sont limitées à ce projet et ne sont pas accessibles aux membres non administrateurs extérieurs à celui-ci. De plus, les ressources ne peuvent pas être déplacées d’un projet à l’autre.

La seule exception est que les fine-tunes du « projet par défaut » sont accessibles depuis d’autres projets.

Quel est le quota de stockage de fichiers par projet ?

OpenAI prend actuellement en charge un quota de stockage de fichiers de 100 Go par projet.

Si ce quota est dépassé, l’erreur suivante s’affiche :

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 l’assistance.

Nous vous recommandons de supprimer les fichiers inutilisés stockés sur votre compte. À titre de référence, vous pouvez afficher et lister les fichiers avec l’API.

Je suis propriétaire d’un projet. Pourquoi ne puis-je pas voir le tableau de bord Utilisation de mon projet ?

La visibilité du tableau de bord Utilisation d’un projet n’est pas liée au rôle de l’utilisateur dans ce projet. Elle dépend plutôt de votre rôle au sein de l’organisation et des paramètres disponibles à l’adresse https://platform.openai.com/settings/organization/data-controls/visibility

Project setting for Usage dashboard visibility with Visible to organization owners selected

Si vous ne voyez pas un tableau de bord Utilisation, ce paramètre est probablement défini sur « Visible par les propriétaires de l’organisation ».

Cet article vous a-t-il été utile ?