Descripción general
Los proyectos organizan el trabajo dentro de una organización de la API. Úsalos para gestionar el acceso, configurar los límites de modelos y de solicitudes, crear cuentas de servicio y hacer un seguimiento del uso, la facturación y los límites de gasto de un conjunto definido de recursos, como modelos, capacidades, hilos, asistentes, ajuste fino y almacenamiento.
Los propietarios de la organización pueden ver todos los proyectos activos y archivados en la página Proyectos.
Antes de empezar
Necesitas el rol de propietario de la organización para crear un proyecto. De forma predeterminada, las organizaciones pueden crear hasta 2000 proyectos.
Si tu organización utiliza la facturación consolidada, las suborganizaciones aparecen por separado en el selector de organizaciones. No puedes crear proyectos dentro de una suborganización.
Para cambiar de organización, abre el selector de organizaciones y selecciona la que quieras usar.
Proyecto Predeterminado
Todas las organizaciones incluyen un proyecto Predeterminado que no se puede eliminar. Hereda toda la configuración de la organización. Puedes configurar sus límites de solicitudes, permisos de modelos virtuales y límites de gasto.
No puedes añadir miembros ni cuentas de servicio directamente al proyecto Predeterminado. Puedes incluir el acceso al proyecto Predeterminado al invitar a alguien a la organización siguiendo los pasos de invitación a la organización de este artículo.
Crear un proyecto
Abre el selector de proyectos y selecciona Crear proyecto.
Introduce un nombre, una descripción y un sitio web para tu proyecto.
Selecciona Crear.
Los propietarios de la organización se añaden automáticamente como propietarios de los nuevos proyectos.
Entender los roles y el acceso
La tabla resume los roles de propietario y lector de la organización y los de propietario y miembro del proyecto que se utilizan en estos pasos. Los miembros de un proyecto tienen permisos similares a los de los lectores de una organización.
| Rol | Ámbito | Permisos |
|---|---|---|
| Propietario | Organización | Crear y ver todos los proyectos, usuarios y claves de API. Supervisar los proyectos en la página Proyectos. Establecer los límites de gasto de la organización y de los proyectos. Conceder acceso a la información de uso de otros usuarios. Archivar proyectos. |
| Lector | Organización | Ser añadido a proyectos, ejecutar inferencias, usar recursos y crear claves en esos proyectos. No puede crear proyectos ni gestionar usuarios. |
| Propietario | Proyecto | Todos los permisos de los miembros, además de añadir usuarios, gestionar los miembros y la configuración del proyecto, cambiar su nombre, establecer sus límites de gasto y archivarlo. |
| Miembro | Proyecto | Ejecutar inferencias, usar recursos, crear claves del proyecto y realizar solicitudes a la API que lean o modifiquen datos. |
Para obtener más información sobre los roles de la organización, consulta los roles de la organización. Para conocer otros roles, los roles personalizados y todos los permisos, consulta la guía de roles y permisos de la API.
Visibilidad de los proyectos
Con estos roles estándar, los usuarios que no sean propietarios de la organización solo pueden ver los proyectos a los que pertenecen. Los propietarios de la organización pueden ver todos los proyectos, miembros y claves de API de los proyectos, y acceder a la página Proyectos.
Los miembros de un proyecto pueden ver a los demás miembros de su proyecto y el rol de cada uno. Solo los miembros del proyecto y los propietarios de la organización pueden ver los modelos con ajuste fino, los hilos de asistentes y los archivos creados o añadidos en ese proyecto.
Puedes pertenecer a tantos proyectos como necesites. Una clave de API personal creada dentro de un proyecto está restringida a ese proyecto y a sus recursos.
Ámbito de los recursos
Los archivos, los asistentes, el almacenamiento y los hilos están restringidos a su proyecto. Los miembros ajenos a ese proyecto que no sean administradores no pueden acceder a sus recursos, y los recursos no se pueden mover entre proyectos.
Los modelos con ajuste fino del proyecto Predeterminado son una excepción: se puede acceder a ellos desde otros proyectos.
Gestionar los miembros de un proyecto
Invitar a alguien a tu organización
Para poder añadir a alguien a un proyecto, esa persona debe pertenecer a tu organización.
Cuando invitas a alguien a la organización, puedes incluir el acceso al proyecto Predeterminado seleccionando esa opción en el formulario de invitación. Déjala sin seleccionar si no quieres conceder acceso al proyecto Predeterminado. Los nuevos miembros de la organización no se añaden automáticamente al proyecto Predeterminado.
No necesitas crear otro proyecto antes de invitar a alguien. También puedes añadir a alguien a un proyecto después de que acepte la invitación a la organización.
Las invitaciones enviadas a través de la API de administración siguen las reglas del punto de acceso /organization/invites.
Añadir un miembro de la organización a un proyecto
Los propietarios de organizaciones y proyectos pueden añadir miembros:
Ve a la configuración de la organización.
Selecciona el proyecto y, a continuación, abre Miembros.
Selecciona + Añadir miembro.
Selecciona al usuario y asígnale el rol de Miembro o Propietario.
La lista de usuarios muestra a los usuarios de la organización con el rol de Lector. No incluye cuentas de servicio.
Si una invitación falla en la interfaz o en la API de administración, confirma que el proyecto de destino existe y no está archivado antes de volver a enviarla.
Cambiar un rol o eliminar a un miembro
Los propietarios de la organización y del proyecto pueden cambiar el rol de un usuario en ese proyecto o eliminarlo del proyecto.
Ve a la configuración de la organización.
Selecciona el proyecto y, a continuación, abre Miembros.
Asigna al usuario el rol de Miembro o Propietario, o selecciona Eliminar para eliminarlo.
Crear y gestionar cuentas de servicio
Una cuenta de servicio proporciona acceso a sistemas, en lugar de representar a un usuario individual. Las cuentas de servicio están restringidas a los proyectos.
Para crear cuentas de servicio, se necesitan permisos de gestión de cuentas de servicio. Los propietarios de organizaciones y proyectos tienen estos permisos.
Crear una cuenta de servicio
Elige el proyecto en el selector de proyectos.
Ve a la configuración de la organización y selecciona el proyecto.
Abre Miembros y selecciona + Cuenta de servicio.
Introduce un ID único para la cuenta de servicio utilizando letras, números y guiones.
Selecciona Crear.
Las cuentas de servicio creadas a nivel de proyecto son exclusivas del proyecto y no pueden utilizarse fuera del proyecto en el que se crean.
Se aplica el mismo formato de ID tanto si creas la cuenta de servicio desde la configuración de la organización como desde la del proyecto.
Una cuenta de servicio creada para un proyecto es exclusiva de ese proyecto y no puede utilizarse fuera de él.
Guardar la clave secreta
Al crear la cuenta de servicio, se crea de inmediato una clave de API y se muestra su clave secreta. Guarda la clave secreta de forma segura. No podrás volver a verla desde tu cuenta de OpenAI. Si la pierdes, genera una nueva clave.
De forma predeterminada, la clave de la cuenta de servicio tiene acceso de lectura y escritura a todos los recursos de la API de su proyecto. Puedes cambiar esos permisos más adelante en la sección Claves de API de la configuración del proyecto.
Actualizar o eliminar una cuenta de servicio
Las cuentas de servicio aparecen junto a los usuarios en la sección Miembros de la configuración del proyecto. Gestiona su acceso al proyecto siguiendo los mismos pasos de cambio de rol y eliminación que para los demás miembros del proyecto.
Todas las cuentas de servicio también aparecen junto a los usuarios en la página Miembros de la organización, incluidas las cuentas creadas desde la configuración de la organización y la de los proyectos.
Desde el menú Miembros de la organización, puedes cambiar el rol de una cuenta de servicio o seleccionar Eliminar.
Crear y gestionar claves de API
Cada proyecto tiene sus propias claves de API:
Ve a la configuración de la organización.
Selecciona el proyecto y, a continuación, abre Claves de API.
Selecciona + Crear nueva clave secreta para crear una clave, o selecciona el icono de edición junto a una clave existente para cambiar sus permisos.
Elegir los permisos de las claves
En el caso de las claves que pertenecen a usuarios, puedes establecer los permisos al crear una clave o editarlos más adelante:
Todos: permisos completos. Esta es la opción predeterminada.
Restringidos: elige los ámbitos de acceso para recursos o puntos de acceso específicos. Las opciones disponibles dependen del recurso y pueden incluir Ninguno, Lectura, Escritura o permisos específicos para cada solicitud.
Solo lectura: permisos de lectura para todos los puntos de acceso.
Por ejemplo, una clave restringida puede excluir el acceso de lectura y escritura al punto de acceso /v1/assistants.
Para crear claves de cuentas de servicio, se necesitan permisos de gestión de cuentas de servicio. Si no ves esa opción, pide a un propietario de la organización o del proyecto que cree la clave de la cuenta de servicio. El cuadro de diálogo de creación de claves no muestra estos controles de permisos para las claves de cuentas de servicio; cambia sus permisos después en la sección Claves de API de la configuración del proyecto.
Configurar el acceso a los modelos y los límites de solicitudes
Para gestionar los límites de solicitudes de un proyecto, se necesitan permisos de administración. Los propietarios de la organización tienen estos permisos, y los propietarios de proyectos también pueden gestionar los límites de solicitudes de sus proyectos a través de la API de gestión.
Ve a la configuración de la organización.
Selecciona el proyecto y, a continuación, abre Límites.
Usa Uso de modelos para elegir qué modelos puede utilizar el proyecto.
Establece un límite de solicitudes para cada modelo según tus necesidades.
Establecer límites y alertas de gasto
Los límites de gasto mensual de la API están disponibles tanto para organizaciones como para proyectos. Para cambiar un límite, necesitas permiso para gestionar la configuración de la organización o del proyecto correspondiente.
Un límite de gasto permite supervisar el gasto sin bloquear las solicitudes. Activa Aplicar un límite estricto si quieres que las solicitudes a la API fallen cuando el gasto registrado alcance el límite. El límite no se aplica de forma instantánea, por lo que el gasto registrado puede superar ligeramente el importe configurado.
Las alertas de gasto te avisan cuando se alcanza un umbral; no bloquean las solicitudes.
Establecer un límite de gasto para una organización
Ve a la configuración de la organización.
Abre Límites y busca Gasto.
Establecer un límite de gasto para un proyecto
Ve a la configuración de la organización.
Selecciona el proyecto y, a continuación, abre Límites.
Establece los valores de Límite de gasto mensual y Alertar cuando el gasto alcance.
Activa Aplicar un límite estricto si quieres detener el tráfico de la API cuando el gasto registrado alcance el límite.
También puedes cambiar el Uso de modelos en esta página.
Gestionar las alertas de gasto
Al crear un límite de gasto para un proyecto, también se crea de forma predeterminada una alerta al alcanzar el 100 % del límite. Selecciona Añadir alerta para añadir alertas con otros umbrales.
Los propietarios de la organización y del proyecto reciben las alertas de gasto del proyecto. Puedes añadir otros destinatarios de correo electrónico en la configuración de las alertas.
Para conocer los pasos de configuración actuales y cómo se aplican los límites, consulta la guía de límites de gasto.
Consultar el uso y la facturación
La actividad de uso se puede desglosar por proyecto, y puedes consultar la facturación y establecer límites de gasto para cada proyecto.
El acceso al panel de uso de un proyecto depende de tu rol en la organización y de la configuración de visibilidad del panel de uso. Ser propietario de un proyecto no concede acceso por sí solo.
Si no puedes ver el panel de uso de un proyecto, comprueba si la visibilidad está configurada como Visible para los propietarios de la organización.
Gestionar el almacenamiento de archivos
Cada proyecto tiene una cuota de almacenamiento de archivos de 100 GB. Si la superas, puede aparecer este error:
Has superado tu cuota de almacenamiento de archivos. Las organizaciones tienen un límite de 100 GB de archivos. Reduce el tamaño del archivo o ponte en contacto con el equipo de soporte.
Elimina los archivos que no uses para liberar espacio de almacenamiento. Puedes obtener una lista de los archivos almacenados a través de la API para identificar los que ya no necesitas.
Archivar un proyecto
Los propietarios de organizaciones y proyectos pueden archivar proyectos desde la página Proyectos o desde la configuración de cada proyecto. Introduce el nombre del proyecto cuando se te pida para confirmar.
El archivado es permanente: un proyecto archivado no se puede restaurar.
Para ver los proyectos archivados, abre la pestaña Archivados en la página Proyectos.
La única excepción es que los ajustes finos del «proyecto predeterminado» pueden consultarse desde otros proyectos.
Has superado tu cuota de almacenamiento de archivos. Las organizaciones están limitadas a 100 GB de archivos. Reduce el tamaño de los archivos o ponte en contacto con soporte.Los proyectos no se pueden eliminar. OpenAI conserva su historial para hacer un seguimiento del uso y la facturación.