임베딩

임베딩 생성

텍스트(또는 지원 모델의 경우 멀티모달 콘텐츠)를 벡터 임베딩으로 변환합니다. 요청/응답 형식이 OpenAI embeddings API와 일치하므로 client.embeddings.create()와 바로 호환됩니다. input은 단일 문자열 또는 문자열 배열을 받습니다.

POST/api/v1/embeddings

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

model필수

string

사용할 임베딩 모델. 공급자 접두사 형식, 예: "openai/text-embedding-3-small".

minLength: 1

Example: "openai/text-embedding-3-small"

input필수

string | string[]

임베딩할 텍스트. 단일 문자열 또는 한 번의 요청으로 여러 입력을 임베딩할 문자열 배열을 받습니다. 일부 모델은 구조화된 멀티모달 콘텐츠 항목도 받아 업스트림으로 그대로 전달합니다. 실제 지원 여부는 모델마다 다릅니다.

Example: "The quick brown fox"

encoding_format

string

인코딩 형식. 로컬 검증 없이 업스트림으로 그대로 전달됩니다. 지원되는 값은 업스트림에 따라 다릅니다.

Example: "float"

dimensions

integer

출력 벡터의 차원 수. 로컬 검증 없이 업스트림으로 그대로 전달됩니다. 일부 모델만 사용자 지정 차원을 지원하며, 지원하지 않을 때의 동작(보통 무시 또는 오류)은 업스트림이 결정합니다.

provider

object

공급자 라우팅 설정(order, only, ignore, allow_fallbacks, sort 등). 일부 모델 라우트에서만 전달·적용됩니다. 지원하지 않는 라우트는 조용히 무시하고 업스트림으로 보내지 않습니다.

POST /api/v1/embeddings

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/embeddings \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "The quick brown fox"
  }'

응답 예시

성공. OpenAI 호환 형태를 반환합니다. data[]는 input 순서대로 대응하며, usage.cost는 이 요청에 실제로 청구된 금액입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0023064255,
        -0.009327292,
        0.015797347
      ]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5,
    "cost": 1e-7
  }
}