Docs Menu
Docs Home
/
AI 모델
Docs Home
/
AI 모델
Docs Home
/
AI 모델

Voyage AI 모델에 액세스

MongoDB Atlas 통해 제공되는 임베딩 및 리랭킹 API 사용하여 Voyage AI 모델에 액세스 할 수 있습니다. 다음 방법을 사용하여 API 에 액세스 .

  • REST API: 언어에 구애받지 않고 액세스.

  • Python 클라이언트: 사용 편의성을 위한 공식 클라이언트 .

이 페이지에는 API 액세스 방법이 요약되어 있습니다. 요금 제한 및 사용 계층을 포함하여 API 에 대한 자세한 내용은 API 참조를 참조하세요.

API 키

Embedding and Reranking API API 키를 사용하여 사용량을 모니터 하고 권한을 관리 . 모델 API 키를 생성하고 관리 하려면 MongoDB Atlas UI 사용합니다. 지침은 모델 API 키를 참조하세요.

REST API

다음 예시는 REST API 통해 임베딩 서비스를 호출하는 방법을 보여줍니다. API cURL과 모든 프로그래밍 언어 의 HTTP 요청을 지원합니다.

인증은 모델 API 키를 통해 처리되며, 이 키를 모든 API 요청의 권한 부여 헤더에 베어러 토큰으로 포함해야 합니다.

자세한 학습 은 전체 API 사양을 참조하세요.

Python 클라이언트

pip을 사용하여 공식 Python 패키지 설치하려면 다음을 수행합니다.

pip install --upgrade voyageai

--upgrade 또는 -U 옵션을 사용하여 최신 버전의 패키지 설치합니다. 이를 통해 최신 기능 및 버그 수정에 액세스 할 수 있습니다. 모델별 매개변수는 각 모델 페이지의 사용 예시를 참조하세요.

중요

Python 클라이언트 라이브러리의 버전 0.3.7 이상을 사용해야 합니다. 이 버전에는 Embedding 및 Reranking API 에 대한 지원 추가됩니다.

voyageai.Client 클래스는 Voyage의 API 호출하기 위한 동기 인터페이스를 제공합니다. 클라이언트 객체 생성하고 이를 사용하여 Voyage AI 모델에 액세스 .

예시

다음 예시 사용자 지정 설정으로 클라이언트 초기화하고 임베딩을 생성하는 방법을 보여줍니다.

import voyageai
# Initialize the client with custom settings
vo = voyageai.Client(
    api_key="<model-api-key>",  # Or use VOYAGE_API_KEY environment variable
    max_retries=3,              # Retry up to 3 times on rate limit errors
    timeout=30                  # Timeout after 30 seconds
)
# Generate embeddings
result = vo.embed(
    texts=["MongoDB is redefining what a database is in the AI era."],
    model="voyage-4-large"
)
print(f"Embedding dimension: {len(result.embeddings[0])}")
print(f"Total tokens used: {result.total_tokens}")

다음 표에서는 클라이언트 초기화할 때 전달할 수 있는 매개변수에 대해 설명합니다.

Parameter
유형
필수 사항
설명

api_key

문자열

No

모델 API 키입니다. 기본값은 없음입니다.

없음인 경우 클라이언트 다음 순서로 API 키를 검색합니다.

  • voyageai.api_key_path, 키가 포함된 파일 의 경로

  • 키가 포함된 파일 의 경로로 설정하다 수 있는 환경 변수 VOYAGE_API_KEY_PATH

  • voyageai.api_key키를 저장 데 사용할 수 있는 voyageai 모듈의 속성입니다.

  • 환경 변수 VOYAGE_API_KEY

참고: Python 클라이언트 는 API 키 형식에 따라 요청을 올바른 API 엔드포인트로 자동 라우팅합니다.

  • MongoDB Atlas 에서 생성된 모델 API 키 는 https://ai.mongodb.com/ 엔드포인트로 라우팅됩니다.

  • Voyage 플랫폼에서 생성된 API 키는 https://api.voyageai.com/ 엔드포인트로 라우팅됩니다.

클라이언트 만들 때 base_url 매개 변수를 설정하여 이 동작을 재정의할 수 있습니다.

max_retries

Integer

No

속도 제한 오류 또는 일시적으로 서버 사용할 수 없는 경우 각 API 요청 에 대한 최대 재시도 횟수입니다. 기본값은 0입니다.

클라이언트 대기 후 재시도 전략을 사용하여 이러한 오류를 처리하다 하고 최대 재시도 제한에 도달하면 예외를 발생시킵니다. 기본값 으로 클라이언트 재시도하지 않습니다.

timeout

Integer

No

요청 중단하기 전에 API 의 응답을 기다리는 최대 시간(초)입니다. 기본값은 없음입니다.

지정된 시간 초과를 초과하면 요청 종료되고 시간 초과 예외가 발생합니다. 기본값 으로 시간 초과 제약 조건이 적용되지 않습니다.

base_url

문자열

No

API 요청에 대한 사용자 지정 기본 URL . 기본값 으로 클라이언트 제공된 API 키를 기반으로 올바른 엔드포인트를 자동으로 감지합니다.

돌아가기

모델

이 페이지의 내용