Las claves de API de modelo sirven como mecanismo de autenticación y autorización para la API de Integración y Reclasificación, y permiten acceder a los modelos de Voyage AI a través de la API. Esta página describe cómo crear y administrar sus claves de API en la interfaz de usuario de Atlas.
Nota
Se denomina clave API de modelo para distinguirla de otras claves API en Atlas. Se utiliza de la misma manera que las claves API de otros proveedores de modelos.
Crear y administrar claves API de modelos
Puede crear y administrar claves API de modelos desde la interfaz de usuario de Atlas en los niveles de organización y proyecto. Se aplican límites de tarifa a la Claves API según si las creó en el nivel de organización o de proyecto.
Permisos requeridos
Para crear, actualizar y eliminar claves API de modelo:
A nivel de organización, es necesario tener
Organization Owneracceso a Atlas.En el nivel de proyecto, debe tener acceso, o superior a
Project Model OwnerProject OwnerAtlas.
Para ver las claves API del modelo:
En los niveles de organización y proyecto, debe tener o más acceso a
Organization Read OnlyAtlas.Solo en el nivel de proyecto, debe tener o acceso superior a
Project Read OnlyAtlas.
Para obtener una lista completa de los permisos para cada rol,consulte Acceso a organizaciones y proyectos.
Crear una clave API.
Al crear una clave de API de modelo a nivel de organización, vincúlela a un proyecto. Una vez creada, no podrá cambiar el proyecto al que está vinculada. Se aplican límites de velocidad a cada clave del proyecto.
Nota
Si crea una clave de API de modelo a través de Atlas, como se describe en el siguiente procedimiento, esta solo autenticará las solicitudes dirigidas a https://ai.mongodb.com/v1/embeddings. Por el contrario, si crea una clave directamente a través de VoyageAI, autenticará las solicitudes dirigidas a https://api.voyageai.com/v1/embeddings.
Para crear claves API de modelo a nivel de 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.
Vaya a la AI Models página 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.
En el nivel del proyecto, haga clic en AI Models debajo del encabezado Services en la barra de navegación.
Ver una clave API
Los propietarios de organizaciones pueden ver y editar todas las claves API de modelo de la organización a nivel de organización. Los propietarios de proyectos solo pueden ver y editar las claves API de modelo de los proyectos a los que tienen acceso.
Para ver las claves API del modelo a nivel de organización, complete los siguientes pasos:
Inicia sesión en Atlas.
Para ver las claves API del modelo a nivel de proyecto, complete los siguientes pasos:
Inicia sesión en Atlas.
Vaya a la AI Models página 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.
En el nivel del proyecto, haga clic en AI Models debajo del encabezado Services en la barra de navegación.
Editar una clave API
Para editar las claves API del modelo a nivel de organización, complete los siguientes pasos:
Inicia sesión en Atlas.
Edita la clave.
En la Actions columna, haga clic en la clave correspondiente a la que desea editar.
En la página Edit Model API Key, modifique el nombre de la clave API del modelo.
El nombre de la clave API del modelo debe ser exclusivo del 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, complete los siguientes pasos:
Inicia sesión en Atlas.
Vaya a la AI Models página 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.
En el nivel del proyecto, haga clic en AI Models debajo del encabezado Services en la barra de navegación.
Edita la clave.
En la Actions columna, haga clic en la clave correspondiente a la que desea editar.
En la página Edit Model API Key, modifique 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.
Eliminar una clave API
Al eliminar una clave API de modelo, MongoDB la desactiva inmediatamente y rechaza cualquier solicitud de API realizada con ella. Una vez eliminada, no se puede ver, restaurar ni modificar.
Para eliminar claves de API de modelo 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.
Vaya a la AI Models página 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.
En el nivel del proyecto, haga clic en AI Models debajo del encabezado Services en la barra de navegación.
Próximos pasos
Después de crear una clave API de modelo, puede:
Establezca límites de velocidad para las claves API de su modelo.
Supervise el uso de la clave API en tiempo real.