Voyage AI 실전·API — embeddings 엔드포인트

Voyage AI 실전·API

Voyage 텍스트 임베딩 API는 문자열(또는 문자열 리스트)과 모델 이름 등을 받아 임베딩 리스트를 담은 응답을 반환해요. 실제 요청·응답 형태를 볼게요.

엔드포인트

POST https://api.voyageai.com/v1/embeddings

Body 파라미터

input (string array, 필수) — 단일 텍스트 문자열 또는 문자열 리스트. 예:

["I like cats", "I also like dogs"]

제약:

  • 리스트 최대 길이 1,000
  • 총 토큰 수: voyage-4-lite, voyage-3.5-lite은 최대 1M; voyage-4, voyage-3.5, voyage-2는 320K; voyage-4-large, voyage-3-large, voyage-code-3, voyage-finance-2, voyage-law-2는 120K

model (string, 필수) — 사용할 모델 이름(예: voyage-4-large).

Python 사용 예

import voyageai

vo = voyageai.Client()  # VOYAGE_API_KEY 환경 변수 사용

texts = ["I like cats", "I also like dogs"]
result = vo.embed(texts, model="voyage-4-large", input_type="document")

print(result.embeddings[0][:3])

참고 파라미터

  • input_type — document(문서 인덱싱) vs query(검색 쿼리). 검색 품질에 영향을 줌
  • truncation — 토큰 초과 시 처리 방식
  • output_dimension — 256, 512, 1024, 2048 차원 선택

더 알아보기