**地理区** 是一组命名的云提供商区域,Atlas 在其中通过 Embedding and Reranking API 处理您提交用于推理的内容。地理区域不等同于 Atlas 集群运行的云提供商区域。集群区域决定 Atlas 存储您集群数据的位置,而推理地域则决定 Atlas 处理您的推理内容的位置,您可以分别设置每个选项。
当您将模型API密钥的范围限定为某个地理位置时,使用该密钥的请求将在该地理位置内托管的 Voyage AI模型上运行。要学习;了解有关“地理位置”概念的更多信息,包括可用的地理位置和支持这些地理位置的指定服务,请参阅Atlas中的地理位置和指定服务。
Embedding and Reranking API 地理区域终结点
每个地理区域都有自己的 Embedding and Reranking API 终结点。您调用的终结点必须与您的模型 API 密钥所属的地理位置匹配。
端点 | 地理 |
|---|---|
| 未限定范围的。Atlas 可以为来自任何地理区域的请求提供服务。 |
| 欧洲 |
| United States |
范围终结点遵循模式 <geography>.ai.mongodb.com,其中 <geography> 是您随请求发送的模型 API 密钥的 geography 值。
要创建不属于地理范围的密钥,将 geography 设置为 any。要了解密钥和终结点如何对应,请参阅 Embedding and Reranking API 概述。
要学习;了解地理位置ACID 一致性保证什么以及如何决定是否将键的范围限定为一个,请参阅Atlas中的地理位置和指定服务 。
地理区域中可用的模型
范围终结点不提供服务所有 Voyage AI 模型。模型表的“支持的终结点”列对于每个终结点都提供服务的模型列出 All,对于仅非范围终结点提供服务的模型列出 ai.mongodb.com。
要查看哪些终结点为特定模型提供服务,请参阅 《模型废弃、生命周期状态和支持》。
要学习;了解有关每个模型的更多信息,请参阅 Voyage AI嵌入和重排名模型概述。
管理地理范围资源
要使用地理范围资源,请参阅以下部分:
要创建范围限定为地理区域的模型 API 密钥,请参阅 密钥范围。
要求新模型 API 密钥使用指定地区,请参阅 《使用资源策略限制模型 API 密钥作用域》。
要从 REST API 或客户端库向地区的终结点发送请求,请参阅 范围内终结点。
要了解密钥和终结点如何对应,请参阅 终结点。
要查看适用于范围终结点的速率限制,请参阅 地理速率限制。
要按地理位置过滤器和分段使用数据,请参阅 按地理位置使用情况。