POST
/
v1
/
text
/
embeddings
curl --request POST \
--url https://api.clovastudio.go.kr/v1/text/embeddings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": [
"문서 검색을 위한 임베딩 생성",
"벡터 유사도 계산 및 분석",
"의미적 검색 시스템 구현",
"자연어 처리 및 기계학습"
],
"model": "bge-m3",
"encoding_format": "float"
}'
{
"object": "list",
"data": [
{
"object": "embedding",
"embedding": [
0.0123,
-0.0234,
0.0345,
-0.0456,
0.0567
],
"index": 0
},
{
"object": "embedding",
"embedding": [
0.0678,
-0.0789,
0.089,
-0.0901,
0.1012
],
"index": 1
},
{
"object": "embedding",
"embedding": [
0.0234,
-0.0345,
0.0456,
-0.0567,
0.0678
],
"index": 2
},
{
"object": "embedding",
"embedding": [
0.0789,
-0.089,
0.0901,
-0.1012,
0.1123
],
"index": 3
}
],
"model": "bge-m3",
"usage": {
"prompt_tokens": 45,
"total_tokens": 45
}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
input
required

임베딩할 텍스트

model
enum<string> | null
default:bge-m3

사용할 임베딩 모델 지원되는 임베딩 모델

Available options:
rag42-embed-v1,
bge-m3
encoding_format
enum<string> | null
default:float

인코딩 형식 (float 또는 base64) 임베딩 인코딩 형식

Available options:
float,
base64
dimensions
integer | null

임베딩 차원 수

Response

성공 - 임베딩 벡터 반환

data
EmbeddingData · object[]
required

임베딩 데이터

model
string
required

사용된 모델

usage
object
required

토큰 사용량

object
string
default:list

객체 타입