지리는 클라우드 공급자 리전의 이름을 가진 그룹으로, 그 내에서 Atlas가 Embedding and Reranking API를 통해 추론을 위해 제출하는 콘텐츠를 처리합니다. 지리적 위치는 Atlas 클러스터가 실행되는 클라우드 공급자 리전과 동일하지 않습니다. 클러스터 리전은 Atlas가 클러스터 데이터를 저장하는 장소를 정하는 반면, inference Geography는 Atlas가 추론을 위해 콘텐츠를 처리하는 장소를 정합니다. 각각 별도로 설정할 수 있습니다.
When you scope a model API key to a Geography, requests that use that key run on Voyage AI models hosted inside that Geography. To learn more about the Geography concept, including the available Geographies and the Designated Services that honor them, see Geographies and Designated Services in Atlas.
Embedding and Reranking API 지역 엔드포인트
각 지역에는 고유의 Embedding and Reranking API 엔드포인트가 있습니다. 호출하는 엔드포인트는 모델 API 키의 범위가 지정된 지역(Geography)과 일치해야 합니다.
엔드포인트 | 지리 |
|---|---|
| 범위가 지정되지 않음. Atlas는 모든 지역에서 요청을 제공할 수 있습니다. |
| 유럽 |
| 미국 |
범위가 지정된 엔드포인트는 <geography>.ai.mongodb.com 패턴을 따릅니다. 여기서 <geography>는 요청과 함께 보내는 모델 API 키의 geography 값입니다.
지역에 접속되지 않는 키를 만들려면 geography을 any(으)로 설정하세요. 키와 엔드포인트가 서로 어떻게 대응하는지 학습하려면, Embedding and Reranking API 개요를 참조하세요.
To learn what a Geography guarantees and how to decide whether to scope a key to one, see Geographies and Designated Services in Atlas.
지역별 이용 가능 모델
스코프된 엔드포인트는 모든 Voyage AI 모델을 제공하지 않습니다. 모델 테이블의 지원 엔드포인트 열에는 모든 엔드포인트가 제공하는 모델에 대해 All을 표시하고, 범위가 지정되지 않은 엔드포인트만이 제공하는 모델에 대해 ai.mongodb.com을 표시합니다.
주어진 모델을 어떤 엔드포인트가 제공하는지 확인하려면, 모델 사용 중단, 수명 주기 상태 및 지원을 참조하세요.
각 모델에 대해 자세히 학습하려면 Voyage AI 임베딩 및 리랭킹 모델 개요를 참조하세요.
지리 범위가 지정된 리소스 관리
지리 범위의 리소스를 사용하려면, 다음 섹션을 참조하십시오.
지역에 대한 모델 API 키를 생성하려면 키 범위를 참조하세요.
새 모델 API 키가 정해진 지역을 사용하도록 하려면 리소스 정책을 사용하여 모델 API 키 범위 제한을(를) 참조하세요.
REST API 또는 클라이언트 라이브러리에서 지역의 엔드포인트로 요청을 보내려면, 범위 지정 엔드포인트를 참조하세요.
키와 엔드포인트가 어떻게 일치하는지 학습하려면 엔드포인트를 참조하세요.
범위가 지정된 엔드포인트에 적용되는 속도 제한을 검토하려면 지역 속도 제한을 참조하세요.
지역별 사용 데이터를 필터 및 구분하려면 지역별 사용을 참조하세요.