TokenLab

텍스트

임베딩 생성

입력 텍스트를 나타내는 임베딩 벡터를 생성합니다

POST
/v1/embeddings

현재 임베딩 모델 목록을 확인하려면 GET /v1/models?recommended_for=embedding을 사용하세요. 세부 정보에 embedding 또는 text-embedding 작업이 나열된 모델을 사용하세요. multimodal-embedding이 나열된 모델은 여기서 400 unsupported_endpoint를 반환하므로 멀티모달 임베딩 생성으로 전송하세요.

요청 본문

이 엔드포인트는 벡터가 준비된 후 반환됩니다. 대량 배치의 경우 HTTP 클라이언트 타임아웃을 최소 120s로 설정하세요.

modelstring필수

사용할 임베딩 모델의 ID입니다 (예: text-embedding-3-small).

inputstring | array필수

임베딩할 텍스트입니다. 문자열 또는 문자열 배열입니다. 토큰 입력을 지원하는 모델은 단일 토큰 시퀀스에 대해 number[], 여러 시퀀스에 대해 number[][]도 허용합니다. 항목 수, 항목당 토큰 수 및 요청당 토큰 수는 모델에 따라 다르며, GET /v1/models/{model}에서 확인할 수 있습니다.

encoding_formatstring기본값: float

임베딩 형식입니다: float 또는 base64.

dimensionsinteger

반환되는 각 벡터의 차원 수이며, 양의 정수입니다. 모델 세부 정보에 dimensions가 나열된 경우에만 전송하세요. 최댓값은 모델에 따라 다릅니다.

userstring

악용 모니터링을 위해 최종 사용자를 나타내는 고유 식별자입니다.

응답

objectstring

항상 list입니다.

dataarray

임베딩 객체의 배열입니다.

각 객체에는 다음이 포함됩니다:

  • object (string): embedding
  • index (integer): 입력 배열 내의 인덱스
  • embedding (array | string): float의 경우 숫자 벡터, base64의 경우 Base64 문자열입니다.
modelstring

사용된 모델입니다.

usageobject

prompt_tokens 및 total_tokens가 포함된 토큰 사용량입니다.

요청

curl -X POST "https://api.tokenlab.sh/v1/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

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

응답

Response
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0194, 0.0081]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9
  }
}

배치 임베딩

# Embed multiple texts at once
response = client.embeddings.create(
    model="text-embedding-3-small",
    input=[
        "First document text",
        "Second document text",
        "Third document text"
    ]
)

for i, data in enumerate(response.data):
    print(f"Document {i}: {len(data.embedding)} dimensions")

오류

상태코드원인
400invalid_request필드가 누락되었거나 유형이 잘못되었습니다. param에 해당 필드가 명시됩니다
400unsupported_endpoint모델이 이 엔드포인트에 지원되지 않습니다
413요청 본문이 너무 큽니다

기타 상태 처리는 API 오류 처리를 참조하세요.

관련 인터페이스

multimodal-embedding이 나열된 모델의 경우 멀티모달 임베딩 생성을 사용하세요.

인증

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