VoyageAI by MongoDB: voyage-multimodal-3.5

Voyage AI voyage-multimodal-3.5는 텍스트, 이미지, 비디오 프레임을 공통 검색 공간에 임베딩합니다. 문서 스크린샷, 표, 장면처럼 섞여 있는 콘텐츠를 처리하며, 32,000토큰 입력과 기본 1024차원 표현을 제공합니다.

Ailoot Ultra · 임베딩 POST /v1/embeddings voyageai/voyage-multimodal-3.5

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

voyage-multimodal-3.5는 텍스트, 이미지, 비디오를 아우르는 검색을 위한 Voyage AI의 임베딩 모델입니다. 텍스트와 시각 콘텐츠가 섞인 입력을 단일 트랜스포머 인코더로 처리해, 완전한 멀티모달 입력을 공통 벡터 공간에 표현합니다. 3.5 에디션은 명시적인 비디오 프레임 지원과 유연한 임베딩 차원을 추가합니다.

텍스트와 시각 자료의 관계 보존하기

문서 페이지나 섹션은 유용한 시각 정보를 보존하는 형태로 준비하세요. 차트와 짧은 설명을 담은 슬라이드는 슬라이드 이미지와 첨부 텍스트를 같은 순서 있는 입력에 넣어 표현할 수 있습니다. PDF 기반 컬렉션에서 문서화된 시각 입력은 페이지 스크린샷 또는 문서를 이미지로 표현한 자료입니다.

보고서 차트에서는 제목, 축 레이블, 범례를 이미지에 보존하세요. 시각 자료를 해석하는 데 필요한 맥락을 제공한다면 설명 텍스트를 첨부하세요. 검색 후보가 문서 이름만 반환하는 대신 관련 페이지를 열 수 있도록, 결과 벡터 옆에 페이지 번호와 원본 식별자를 저장하세요.

제조사의 입력 형식은 텍스트, 이미지, 비디오의 시퀀스를 지원합니다. 공개된 이미지 형식은 PNG, JPEG, WebP, GIF이며 비디오는 MP4입니다. 문서화된 방식에서 시각 콘텐츠는 URL 또는 Base64 데이터로 표현할 수 있습니다. 한 요청 안에서는 표현 방식을 일관되게 유지하세요.

긴 비디오 전체 대신 장면 검색하기

모델은 비디오를 순서 있는 프레임 시퀀스로 표현합니다. 제조사는 긴 비디오를 관련 장면으로 나누고, 사용 가능한 전사문 타임스탬프에 장면 경계를 맞추며, 해당 전사문 텍스트를 유지할 것을 권장합니다. 해상도나 프레임률을 낮추면 의미적으로 연속된 장면을 컨텍스트 예산 안에 넣는 데 도움이 됩니다.

교육 비디오 컬렉션에서는 특정 조작부 조정법을 시연하는 장면을 찾는 질의를 사용할 수 있습니다. 색인한 각 장면에 시간 범위를 연결하세요. 일치하는 장면을 반환하고 프레임이나 원본 클립에서 실제 동작을 살펴보세요. 검색된 벡터를 녹화 내용 전체에 대한 글로 된 설명처럼 취급하지 마세요.

전사문 텍스트를 멀티모달 입력의 일부로 준비하면 검색에 기여할 수 있습니다. 비디오 프레임 임베딩 자체가 발화 전사문을 제공하는 것은 아닙니다.

컨텍스트와 준비 제한

명시된 컨텍스트 길이는 입력당 32,000토큰입니다. Voyage의 공개 계산은 이미지 560픽셀마다, 비디오 1120픽셀마다 1토큰을 계산하므로 시각 콘텐츠가 텍스트와 예산을 공유합니다. 문서화된 제한에는 이미지당 1,600만 픽셀과 20 MB, 비디오당 20 MB도 포함됩니다. 목록에는 최대 1000개 입력과 합계 320,000토큰을 넣을 수 있습니다.

기본 잘림 설정은 너무 긴 입력을 자릅니다. 경계가 이미지 중간에 있으면 이미지 전체를 버립니다. 따라서 예산 안에서 완전한 페이지나 장면을 준비하면 입력 내용을 더 예측 가능하게 유지할 수 있습니다. 문서에 제시된 다른 설정은 너무 긴 입력을 자르지 않고 거부합니다.

벡터 차원과 검색 역할

기본 출력 차원은 1024이며, 이 에디션에는 256, 512, 2048차원도 문서화되어 있습니다. 발표 자료는 Matryoshka 임베딩과 부동소수점, 부호 있는 또는 없는 8비트, 바이너리 표현을 설명합니다. 선택한 차원과 표현을 색인과 함께 보관하세요.

Voyage의 검색 방식은 query와 document 입력을 구분합니다. 질의는 텍스트 또는 이미지일 수 있고, 색인 문서는 텍스트와 시각 자료를 결합할 수 있습니다. 완전한 입력 시퀀스마다 벡터 하나가 생성됩니다. 순위 결과를 살펴볼 수 있도록 원본 페이지, 이미지, 장면과의 연결을 저장하세요.

반환된 시각 원본 활용하기

검색 단계는 질의에 관련된 보고서 페이지, 표, 슬라이드, 장면을 찾을 수 있습니다. 답변 작성이나 분석 단계는 이후 해당 원본 자료를 읽습니다. 표라면 결과를 사용하기 전에 실제 머리글과 값을 살펴보고, 장면이라면 관련 프레임과 연결된 텍스트를 살펴보세요.

voyage-multimodal-3와의 실질적인 차이는 3.5 에디션의 명시적인 비디오 지원과 추가 표현 선택지입니다. 이는 원본 자료를 찾는 임베딩 기능이며, 출력은 생성된 이미지, 비디오, 서술형 답변이 아니라 수치 벡터입니다.

Ailoot Ultra · 임베딩 POST /v1/embeddings voyageai/voyage-multimodal-3.5

voyageai/voyage-multimodal-3.5

VoyageAI by MongoDB /voyageai/voyage-multimodal-3.5

시작하기

허용 입력: 텍스트 · token_ids
결과: embedding

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 임베딩 POST /v1/embeddings

입력: text, token_ids
출력: embedding
컨텍스트: 32,000 tokens
출력 형식: json

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 voyageai/voyage-multimodal-3.5	기본값—
필드`input`	유형`string\|string[]\|integer[]\|integer[][]`	요건필수	값과 한도 최소 항목 수: 1 조건: 비어 있지 않은 동일 형식의 배치입니다. 토큰 ID는 0 이상의 정수입니다. 입력 허용량: 최댓값: 32,000 · 텍스트 단위: UTF8 바이트 · 토큰 단위: 토큰 배열 요소	기본값—
필드`encoding_format`	유형`string`	요건선택 사항	값과 한도 float	기본값float
필드`dimensions`	유형`integer`	요건지원되지 않음	값과 한도 최솟값: 1	기본값—
필드`user`	유형`json_value`	요건선택 사항	값과 한도 조건: 원본에서 이 JSON 메타데이터 필드를 허용하며, 정확한 업스트림 동작은 모델별로 다릅니다.	기본값—
필드`session_id`	유형`json_value`	요건선택 사항	값과 한도 조건: 원본에서 이 JSON 메타데이터 필드를 허용하며, 정확한 업스트림 동작은 모델별로 다릅니다.	기본값—
필드`trace`	유형`json_value`	요건선택 사항	값과 한도 조건: 원본에서 이 JSON 메타데이터 필드를 허용하며, 정확한 업스트림 동작은 모델별로 다릅니다.	기본값—
필드`provider`	유형`object`	요건선택 사항	값과 한도 조건: provider.options가 거부됨	기본값—

입력 자료 조합

text_to_embedding

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`content_type`	명세application/json
매개변수`required`	명세model, input
매개변수`input_shapes`	명세string, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
매개변수`encoding_format`	명세float
매개변수`dimensions_override`	명세false
매개변수`max_input_budget_units`	명세32000
매개변수`multimodal_objects`	명세false
매개변수`material_types`	명세text, token_ids

수명 주기: synchronous_json

모든 벡터의 인덱스와 차원을 보관하세요.

모델 이름이 멀티모달이어도 이 특정 경로에서 이미지 객체를 사용할 수 있는 것은 아닙니다.

요금

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드: 표준 요금 빠른 모드를 선택한 경우
Flex 모드: 표준 요금 flex 모드를 선택한 경우
최대 추론 수준: 표준 요금 최대 추론 수준에 default 조정값을 적용하는 경우

Ailoot 요금

설정별 가격

설정	요금표	요금
설정토큰의 기본 단가	요금표기본 요금	요금 입력 · 입력 토큰 $0.00024 / 1K 토큰 출력 · 출력 토큰 $0 / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 임베딩

curlPython SDK

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "voyageai/voyage-multimodal-3.5", "input": ["First document", "Second document"]}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT

from openai import OpenAI
import os

client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='voyageai/voyage-multimodal-3.5',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)

결과 수신 및 저장

Ailoot Ultra · 임베딩

json

완료된 결과 모두 보관

반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.

모든 벡터를 인덱스와 함께 보관하세요. 벡터 수는 입력 수와 같아야 하며 차원은 일관되어야 합니다.

원래 응답을 확인해야 할 경우

임베딩 작업 엔드포인트는 추가되지 않습니다.

응답 필드

필드	유형
필드`object`	유형string
필드`model`	유형string
필드`data[].index`	유형integer
필드`data[].embedding`	유형finite float[]
필드`usage`	유형object

오류와 다음 단계

응답	조건	다음 단계
응답400 · `invalid_request_error`	조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음	다음 단계새 생성 요청 전에 표시된 필드를 수정하세요.

별칭

모델 별칭

Ailoot Ultra voyageai/voyage-multimodal-3.5

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

VoyageAI by MongoDB: voyage-multimodal-3.5