텍스트
임베딩 생성
입력 텍스트를 나타내는 임베딩 벡터를 생성합니다
현재 임베딩 모델 목록을 확인하려면 GET /v1/models?recommended_for=embedding을 사용하세요. 세부 정보에 embedding 또는 text-embedding 작업이 나열된 모델을 사용하세요. multimodal-embedding이 나열된 모델은 여기서 400 unsupported_endpoint를 반환하므로 멀티모달 임베딩 생성으로 전송하세요.
요청 본문
이 엔드포인트는 벡터가 준비된 후 반환됩니다. 대량 배치의 경우 HTTP 클라이언트 타임아웃을 최소 120s로 설정하세요.
사용할 임베딩 모델의 ID입니다 (예: text-embedding-3-small).
임베딩할 텍스트입니다. 문자열 또는 문자열 배열입니다. 토큰 입력을 지원하는 모델은 단일 토큰 시퀀스에 대해 number[], 여러 시퀀스에 대해 number[][]도 허용합니다. 항목 수, 항목당 토큰 수 및 요청당 토큰 수는 모델에 따라 다르며, GET /v1/models/{model}에서 확인할 수 있습니다.
float임베딩 형식입니다: float 또는 base64.
반환되는 각 벡터의 차원 수이며, 양의 정수입니다. 모델 세부 정보에 dimensions가 나열된 경우에만 전송하세요. 최댓값은 모델에 따라 다릅니다.
악용 모니터링을 위해 최종 사용자를 나타내는 고유 식별자입니다.
응답
항상 list입니다.
임베딩 객체의 배열입니다.
각 객체에는 다음이 포함됩니다:
object(string):embeddingindex(integer): 입력 배열 내의 인덱스embedding(array | string):float의 경우 숫자 벡터,base64의 경우 Base64 문자열입니다.
사용된 모델입니다.
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"
}'예시 벡터는 가독성을 위해 축약되었습니다.
응답
{
"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")오류
| 상태 | 코드 | 원인 |
|---|---|---|
400 | invalid_request | 필드가 누락되었거나 유형이 잘못되었습니다. param에 해당 필드가 명시됩니다 |
400 | unsupported_endpoint | 모델이 이 엔드포인트에 지원되지 않습니다 |
413 | 요청 본문이 너무 큽니다 |
기타 상태 처리는 API 오류 처리를 참조하세요.
관련 인터페이스
multimodal-embedding이 나열된 모델의 경우 멀티모달 임베딩 생성을 사용하세요.
인증
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