Las claves API de modelo sirven como mecanismo de autenticación y autorización para la API de Embedding y Reranking, y te permiten acceder a los modelos de Voyage AI a través de la API. Esta página describe cómo crear y administrar las claves API en la Interfaz de Usuario de Atlas.
Nota
Se le llama clave de API de modelo para distinguirla de otras claves de API en Atlas. Utiliza esta clave de la misma manera que las claves de API de otros proveedores de modelos.
Crea y gestiona las claves API del modelo
Puede crear y gestionar claves API de modelos desde la Interfaz de Usuario Atlas tanto a nivel de organización como de proyecto. Se aplican límites de tarifa a Claves API según si las creaste a nivel de organización o de proyecto.
Permisos requeridos
Para crear, actualizar y borrar claves API del modelo:
A nivel organizacional, debes tener
Organization Owneracceso a Atlas.A nivel de proyecto, debes tener
Project Model Owner,Project Ownero acceso superior a Atlas.
Para ver las claves API del modelo:
A nivel organizativo y de proyecto, debes tener
Organization Read Onlyo un nivel de acceso superior a Atlas.Solo a nivel de proyecto, debes tener acceso
Project Read Onlyo superior a Atlas.
Para obtener una lista completa de permisos para cada rol, consulte Acceso a la organización y el proyecto.
Crear una clave API.
Cuando crees una clave API de modelo a nivel de organización, vincula la clave a un proyecto. Después de crear la clave, no podés cambiar a qué proyecto está vinculada la clave. Se aplican límites de tasa a cada clave en el proyecto.
Nota
Si crea una clave de API de modelo a través de Atlas, como se describe en el siguiente procedimiento, la clave solo autentica solicitudes a https://ai.mongodb.com/v1/embeddings. Por el contrario, si crea una clave directamente a través de VoyageAI, autenticará solicitudes a https://api.voyageai.com/v1/embeddings.
Para crear claves API de modelos a nivel de la organización, complete los siguientes pasos:
Para crear claves API de modelos a nivel de proyecto, completa los siguientes pasos:
Inicia sesión en Atlas.
Ve a la página AI Models en la Interfaz de Usuario de Atlas.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
A nivel de proyecto, haz clic en AI Models en el encabezado Services de la barra de navegación.
Ver una clave de API
Los propietarios de la organización pueden ver y editar todas las claves de API de modelo de la organización a nivel de organización. Los propietarios de proyectos solo pueden ver y editar las claves API del modelo de los proyectos a los que tienen acceso.
Para ver las claves API del modelo a nivel de organización, completa los siguientes pasos:
Inicia sesión en Atlas.
Para ver las claves API del modelo a nivel de proyecto, completa los siguientes pasos:
Inicia sesión en Atlas.
Ve a la página AI Models en la Interfaz de Usuario de Atlas.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
A nivel de proyecto, haz clic en AI Models en el encabezado Services de la barra de navegación.
Editar una clave API
Para editar las claves API del modelo a nivel de la organización, se deben completar los siguientes pasos:
Inicia sesión en Atlas.
Edita la clave.
En la columna Actions, haz clic en correspondiente a la clave que deseas editar.
En la página Edit Model API Key, modifica el nombre de la clave API del modelo.
el nombre de la clave de la API del modelo debe ser único para el proyecto y puede tener hasta 250 caracteres de longitud.
Haz clic en Save para aplicar los cambios.
Para editar las claves API del modelo a nivel de proyecto, completa los siguientes pasos:
Inicia sesión en Atlas.
Ve a la página AI Models en la Interfaz de Usuario de Atlas.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
A nivel de proyecto, haz clic en AI Models en el encabezado Services de la barra de navegación.
Edita la clave.
En la columna Actions, haz clic en correspondiente a la clave que deseas editar.
En la página Edit Model API Key, modifica el nombre de la clave API del modelo.
El nombre debe ser único en el proyecto y puede tener hasta 250 caracteres de longitud.
Haz clic en Save para aplicar los cambios.
Borrar una clave de API
Cuando borras una clave API de un modelo, MongoDB inhabilita inmediatamente la clave y rechaza cualquier solicitud API realizada con la clave eliminada. Una vez que elimines la clave, no podrás verla, restaurarla ni modificarla.
Para borrar claves API de modelos a nivel de organización, complete los siguientes pasos:
Inicia sesión en Atlas.
Para borrar claves de API de modelo a nivel de proyecto, completa los siguientes pasos:
Inicia sesión en Atlas.
Ve a la página AI Models en la Interfaz de Usuario de Atlas.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
A nivel de proyecto, haz clic en AI Models en el encabezado Services de la barra de navegación.
Próximos pasos
Después de crear una clave API de modelo, podrá:
Establece límites de tasa para las claves de API de tu modelo.
Supervisa el uso de la clave de la API en tiempo real.