TokenLab

텍스트

멀티모달 임베딩 생성

멀티모달 임베딩 모델을 사용하여 임베딩 벡터를 생성합니다

POST
/v1/multimodal/embeddings

개요

모델 상세 정보에 multimodal-embedding 작업이 나열된 모델에 이 엔드포인트를 사용하세요. 요청을 보내기 전에 GET /v1/models/{model}의 supported_operations를 확인하세요. 텍스트 전용 임베딩 모델은 임베딩 생성을 사용하며, 해당 모델의 경우 이 엔드포인트는 400 unsupported_endpoint를 반환합니다.

현재 텍스트 입력만 지원됩니다. image_url 또는 image_base64가 포함된 요청은 400 image_input_deferred를 반환합니다.

요청 본문

modelstring필수

qwen3-vl-embedding과 같이 multimodal-embedding이 나열된 모델의 ID입니다.

inputobject | array필수

단일 입력 항목 또는 항목의 배열입니다. 각 항목에는 아래 필드 중 하나 이상이 필요하며, 응답에는 항목당 하나의 엔트리가 포함됩니다.

  • text (string): 임베딩할 텍스트입니다.
  • image_url (string): 공개 이미지 URL입니다. 아직 지원되지 않습니다.
  • image_base64 (string) 및 image_mime_type (string): Base64 이미지 데이터 및 해당 MIME 타입입니다. 아직 지원되지 않습니다.
dimensionsinteger

반환되는 각 벡터의 차원 수(양의 정수)입니다. 최댓값은 모델에 따라 다릅니다.

응답

objectstring

항상 list입니다.

dataarray

입력 항목당 하나의 엔트리입니다.

각 엔트리에는 다음이 포함됩니다:

  • object (string): embedding
  • index (integer): 입력 항목의 인덱스
  • text_embedding (array): 텍스트 항목의 벡터입니다. 엔트리에는 해당 모달리티에 따라 이름이 지정된 하나의 벡터 필드(text_embedding, image_embedding, video_embedding 또는 audio_embedding)가 포함됩니다.
modelstring

사용된 모델입니다.

usageobject

모델에서 보고하는 경우 prompt_tokens 및 total_tokens가 포함된 토큰 사용량입니다.

요청

curl -X POST "https://api.tokenlab.sh/v1/multimodal/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-embedding",
    "input": [
      {"text": "A red bicycle leaning against a brick wall"},
      {"text": "A city street at night"}
    ]
  }'

예시 벡터는 가독성을 위해 축약되었습니다.

응답

Response
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "text_embedding": [0.0123, -0.0456, 0.0789] },
    { "object": "embedding", "index": 1, "text_embedding": [0.0211, 0.0334, -0.0102] }
  ],
  "model": "qwen3-vl-embedding",
  "usage": { "prompt_tokens": 18, "total_tokens": 18 }
}

오류

상태코드원인
400invalid_requestinput이 누락되었거나 비어 있음, 또는 항목에 text, image_url, image_base64 중 어느 것도 포함되지 않음
400unsupported_endpoint모델에 multimodal-embedding이 나열되어 있지 않음
400image_input_deferred항목에 이미지가 포함되어 있음

다른 상태 코드는 API 오류 처리를 참조하여 처리하세요.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

  • "auto"
  • "verified"
  • "official"

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json