Embeddings API: OpenAI 호환 텍스트 임베딩

텍스트를 벡터로 변환하는 OpenAI 호환 엔드포인트입니다. 검색, 추천, 분류, 클러스터링의 기반으로 씁니다. 요금은 토큰 사용량 기준이며 최신 단가는 Tokuse 요금 페이지에서 확인하세요.

엔드포인트와 인증

항목	값
메서드	POST
엔드포인트	/v1/embeddings
인증	Authorization: Bearer sk-your-tokuse-key
입력	문자열 하나 또는 문자열 배열

지원 모델

텍스트 임베딩 모델을 Tokuse 콘솔에서 먼저 개통해야 합니다. 요청의 model에는 개통한 모델 ID를 넣으세요. 아래 예시의 your-embedding-model은 실제 모델 ID로 바꿔야 합니다.

요청 예시

curl https://tokuse.com/v1/embeddings \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model",
    "input": ["첫 번째 문장", "두 번째 문장"]
  }'

응답 예시

{
  "object": "list",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0123, -0.0456, 0.0789]},
    {"object": "embedding", "index": 1, "embedding": [-0.0321, 0.0654, 0.0210]}
  ],
  "model": "your-embedding-model",
  "usage": {"prompt_tokens": 12, "total_tokens": 12}
}

주의 사항과 제한

• 표준 /v1/embeddings는 텍스트 임베딩용입니다.
• 화산 멀티모달 임베딩은 업스트림의 /api/v3/embeddings/multimodal 경로를 사용하며, 이 표준 엔드포인트와 호환되지 않습니다.
• 텍스트 임베딩 모델은 개통이 필요합니다. 개통하지 않은 모델을 지정하면 호출이 실패합니다.
• 모델마다 벡터 차원이 다를 수 있으므로 저장 스키마를 정하기 전에 차원을 확인하세요.

요금

과금은 임베딩에 사용된 토큰 수를 기준으로 계산됩니다. 배치 크기를 키우면 호출 횟수는 줄지만 토큰 사용량은 그대로 늘어납니다. 실제 단가는 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인하세요.