Atlas Embedding and Reranking API 사용하려면 애플리케이션을 마이그레이션하세요.

Embedding 및 Reranking API Preview에 있습니다. 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다.

기존 Voyage AI 사용자인 경우, Atlas Embedding and Reranking API 사용하도록 애플리케이션 마이그레이션 하려면 다음 단계를 완료하세요.

절차

무료 Atlas 계정에 등록 하거나 로그인.

Atlas 를 처음 사용하는 경우 조직 과 프로젝트 생성됩니다.

자세히 학습 Atlas 계정 만들기를 참조하세요.

프로젝트 에 대한 모델 API 키를 만듭니다.

Atlas 프로젝트 의 탐색 모음에서 AI Models 을 선택합니다.
Create model API key를 클릭합니다.
API 키에 이름을 지정한 다음 Create를 클릭합니다.

API 키가 유효한지 확인하려면 Embedding and Reranking API 에 테스트 요청 수행할 수 있습니다.

curl \
  --request POST 'https://ai.mongodb.com/v1/embeddings' \
  --header "Authorization: Bearer $VOYAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "input": "Sample text",
    "model": "voyage-4-lite",
    "input_type": "document"
  }'

API 키 생성 및 관리에 대해 자세히 학습 모델 API 키를 참조하세요.

기존 Voyage API 키를 모델 API 키로 바꿉니다.

예시 를 들어 API 키를 환경 변수로 설정하다 경우 값을 업데이트 .

VOYAGE_API_KEY="<your-new-model-api-key>"

코드에서 API 키를 직접 전달하는 경우 클라이언트 초기화하거나 API 요청을 수행하는 값을 업데이트 .

참고

API 키를 환경 변수로 설정하다 경우 다음 명령을 실행 변수가 설정하다 되었는지 확인할 수 있습니다.

echo $VOYAGE_API_KEY

명시적 API 엔드포인트를 Embedding 및 Reranking API 엔드포인트로 대체합니다.

애플리케이션 에서 API 엔드포인트를 명시적으로 지정하는 경우 동등한 Embedding 및 Reranking API API 포인트를 사용하도록 업데이트 .

이전 엔드포인트	새 엔드포인트
`https://api.voyageai.com/v1/embeddings`	`https://ai.mongodb.com/v1/embeddings`
`https://api.voyageai.com/v1/rerank`	`https://ai.mongodb.com/v1/rerank`
`https://api.voyageai.com/v1/multimodalembeddings`	`https://ai.mongodb.com/v1/multimodalembeddings`
`https://api.voyageai.com/v1/contextualizedembeddings`	`https://ai.mongodb.com/v1/contextualizedembeddings`

참고

voyageai Python 클라이언트 (버전 0.3.7 이상)를 사용하는 경우 클라이언트 API 키 형식에 따라 요청을 올바른 엔드포인트로 자동 라우팅합니다. base_url 매개변수를 명시적으로 설정하지 않고 클라이언트 를 사용하는 경우 엔드포인트를 변경할 필요가 없습니다.

자세한학습 은 Python 클라이언트를 참조하세요.

애플리케이션 이 새 API 키와 함께 작동하는지 확인합니다.

애플리케이션 테스트하여 임베딩 및 순위 재지정 API 사용하여 임베딩을 올바르게 생성하고 순위 재지정 작업을 수행하는지 확인합니다.

이전 Voyage AI API 키를 삭제합니다.

애플리케이션 모델 API 키와 작동하는지 확인한 후, 무단 액세스 방지하기 위해Voyage AI 플랫폼에서 이전 API 키를 삭제 .