VoyageAI by MongoDB: voyage-code-4

voyage-code-4는 MongoDB 계열사인 Voyage AI의 코드 임베딩 모델입니다. 채팅이나 텍스트 생성 계열이 아니라 임베딩 범주에 속하므로, 답변을 작성하는 것이 아니라 입력을 벡터로 변환하는 것이 그 역할입니다. 제공자 릴리스 날짜는 2026-08-13입니다. 소스 코드를 대상으로 검색, 탐색 또는 에이전트 도구를 구축하고 있다면, 이것이 바로 평가해 볼 만한 종류의 모델입니다.

이 모델은 텍스트를 유일한 입력 모달리티로 받고 임베딩을 유일한 출력 모달리티로 생성합니다. 컨텍스트 길이는 32000 토큰이고, 최대 출력은 28800입니다. 제공자는 이 모델이 코딩 에이전트와 코드 검색을 위해 설계되었다고 설명하며, 2048, 1024, 512, 256 차원의 Matryoshka 임베딩을 사용합니다. Matryoshka 임베딩이란 동일한 벡터를 더 짧은 차원으로 잘라내도 여전히 사용할 수 있다는 뜻이며, 이를 통해 코퍼스를 다시 임베딩하지 않고도 저장 공간과 검색 속도를 검색 품질과 맞바꿀 수 있습니다. 이 모델에 대해 지원되는 것으로 나열된 요청 파라미터는 없습니다.

이러한 기능은 상당히 특정한 용도 집합을 가리킵니다. 코드 검색이 가장 명백한 용도입니다. 저장소를 인덱싱하여 검색 쿼리나 자연어 질문이 가장 관련성 높은 파일, 함수 또는 스니펫을 반환하도록 하는 것입니다. 코딩 에이전트는 동일한 임베딩을 사용하여 코드베이스의 어느 부분을 작업 컨텍스트로 가져올지 결정할 수 있으며, 이는 저장소가 단일 프롬프트보다 훨씬 클 때 중요합니다. 벡터를 짧게 만들 수 있기 때문에, 동일한 인덱스가 256 차원에서 빠른 1차 검색을 수행하고 2048 차원에서 더 정밀한 재순위를 수행하는 데 사용될 수 있습니다. 문서 검색, 중복 또는 거의 중복된 코드 탐지, 유사 파일 클러스터링도 자연스럽게 적합합니다. 이들 모두가 벡터 비교로 귀결되기 때문입니다.

모델 id "voyageai/voyage-code-4"를 사용하여 api14의 OpenAI 호환 API를 통해 호출합니다. 인터페이스가 OpenAI 임베딩 형태를 따르므로, 이미 OpenAI 호환 base URL을 가리키고 있는 기존 클라이언트와 SDK는 모델 id만 바꾸면 작동해야 합니다. 이 모델은 텍스트 입력을 지원하고 임베딩을 반환하며, 컨텍스트 길이는 32000 토큰이고 최대 출력은 28800입니다. 지원되는 파라미터 목록이 비어 있으므로, dimensions, truncation 또는 input type 같은 옵션을 전달할 수 있다고 기대해서는 안 됩니다. 텍스트를 보내고 벡터를 다시 읽으십시오.

확정하기 전에 확인할 만한 두 가지가 있습니다. 첫째, 이것은 임베딩 모델이므로 질문에 답하거나 코드를 생성하지 않습니다. 검색과 응답을 모두 수행하는 에이전트가 필요하다면 생성 모델과 함께 사용하십시오. 둘째, 파라미터 목록이 비어 있다는 것은 차원 선택이 요청 옵션으로 노출되지 않는다는 뜻이므로, 호출 시점에 출력 크기를 명시적으로 제어해야 한다면 이를 기준으로 설계하기 전에 그것이 어떻게 처리되는지 확인하십시오.