Una geografía es un grupo con nombre de regiones de proveedor de nube dentro de la cual Atlas procesa el contenido que envía para inferencia a través de la Embedding and Reranking API. Una geografía no es lo mismo que la región del proveedor de nube donde se ejecuta su clúster de Atlas. La región del clúster rige dónde Atlas almacena los datos de su clúster, mientras que la geografía de inferencia rige dónde Atlas procesa su contenido para inferencia, y usted configura cada una por separado.
Cuando limita el alcance de una clave API de modelo a una geografía, las solicitudes que utilizan esa clave se ejecutan en modelos de Voyage AI alojados dentro de esa geografía. Para aprender más sobre el concepto de geografía, incluidas las geografías disponibles y los servicios designados que las respetan, consulte Geografías y servicios designados en Atlas.
Embedding and Reranking API Geography Endpoints
Cada geografía tiene su propio endpoint de la Embedding and Reranking API. El endpoint al que llama debe coincidir con la geografía a la que está limitada la clave de la API de su modelo.
Endpoint | Geografía |
|---|---|
| Sin ámbito. Atlas puede servir la solicitud desde cualquier geografía. |
| Europa |
| Estados Unidos |
Los puntos finales con ámbito siguen el patrón <geography>.ai.mongodb.com, donde <geography> es el valor geography de la clave API del modelo que envía con la solicitud.
Para crear una clave que no esté limitada a una geografía, establezca geography en any. Para aprender cómo se corresponden las claves y los endpoints, consulte Embedding and Reranking API Overview.
Para aprender qué garantiza una geografía y cómo decidir si se debe limitar una clave a una, consulte Geografías y servicios designados en Atlas.
Modelos disponibles en geografías
Los endpoints con ámbito no sirven todos los modelos de Voyage AI. La columna Endpoints compatibles de las tablas de modelos enumera All para los modelos que sirven todos los endpoints y ai.mongodb.com para los modelos que solo sirve el endpoint sin ámbito.
Para comprobar qué endpoints sirven un modelo determinado, consulte Model Deprecations, Lifecycle States, and Support.
Para aprender más sobre cada modelo, consulte Descripción general de los modelos de incrustación y reclasificación de Voyage AI.
Gestionar recursos con alcance geográfico
Para trabajar con recursos con ámbito geográfico, consulte las siguientes secciones:
Para crear una clave de API de modelo con ámbito geográfico, consulta Key Scope.
Para exigir que las nuevas claves de API de modelo utilicen una geografía determinada, consulta Restringir el alcance de la clave de API de modelo mediante una política de recursos.
Para enviar solicitudes a un endpoint de geografía desde la REST API o una librería de clientes, consulte Scoped Endpoints.
Para aprender cómo se corresponden las claves y los endpoints, consulte Endpoints.
Para revisar los límites de velocidad que se aplican a los endpoints con ámbito, consulte Límites de velocidad geográficos.
Para filtrar y segmentar sus datos de uso por geografía, consulte Uso por geografía.