텍스트
멀티모달 임베딩 생성
멀티모달 임베딩 모델을 사용하여 임베딩 벡터를 생성합니다
개요
모델 상세 정보에 multimodal-embedding 작업이 나열된 모델에 이 엔드포인트를 사용하세요. 요청을 보내기 전에 GET /v1/models/{model}의 supported_operations를 확인하세요. 텍스트 전용 임베딩 모델은 임베딩 생성을 사용하며, 해당 모델의 경우 이 엔드포인트는 400 unsupported_endpoint를 반환합니다.
현재 텍스트 입력만 지원됩니다. image_url 또는 image_base64가 포함된 요청은 400 image_input_deferred를 반환합니다.
요청 본문
qwen3-vl-embedding과 같이 multimodal-embedding이 나열된 모델의 ID입니다.
단일 입력 항목 또는 항목의 배열입니다. 각 항목에는 아래 필드 중 하나 이상이 필요하며, 응답에는 항목당 하나의 엔트리가 포함됩니다.
text(string): 임베딩할 텍스트입니다.image_url(string): 공개 이미지 URL입니다. 아직 지원되지 않습니다.image_base64(string) 및image_mime_type(string): Base64 이미지 데이터 및 해당 MIME 타입입니다. 아직 지원되지 않습니다.
반환되는 각 벡터의 차원 수(양의 정수)입니다. 최댓값은 모델에 따라 다릅니다.
응답
항상 list입니다.
입력 항목당 하나의 엔트리입니다.
각 엔트리에는 다음이 포함됩니다:
object(string):embeddingindex(integer): 입력 항목의 인덱스text_embedding(array): 텍스트 항목의 벡터입니다. 엔트리에는 해당 모달리티에 따라 이름이 지정된 하나의 벡터 필드(text_embedding,image_embedding,video_embedding또는audio_embedding)가 포함됩니다.
사용된 모델입니다.
모델에서 보고하는 경우 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"}
]
}'예시 벡터는 가독성을 위해 축약되었습니다.
응답
{
"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 }
}오류
| 상태 | 코드 | 원인 |
|---|---|---|
400 | invalid_request | input이 누락되었거나 비어 있음, 또는 항목에 text, image_url, image_base64 중 어느 것도 포함되지 않음 |
400 | unsupported_endpoint | 모델에 multimodal-embedding이 나열되어 있지 않음 |
400 | image_input_deferred | 항목에 이미지가 포함되어 있음 |
다른 상태 코드는 API 오류 처리를 참조하여 처리하세요.
인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. 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