임베딩 API
OpenAI 호환 Embeddings API. 텍스트를 벡터로 변환해 의미 검색, RAG, 분류/클러스터링에 사용합니다. 입력 토큰만 과금됩니다.
엔드포인트
POST
/api/v1/embeddings공통 요청 파라미터
| 이름 | 타입 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
model* | string | * 필수 | 사용할 임베딩 모델 ID | - |
input* | string | array | * 필수 | 임베딩할 텍스트. 문자열 하나 또는 문자열 배열(배치)을 보낼 수 있으며, 배열 순서대로 결과가 반환됩니다. | - |
응답 필드
| 이름 | 타입 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
object* | string | * 필수 | "list" 고정값 | - |
data* | array | * 필수 | 임베딩 결과 배열. 각 항목은 object("embedding"), embedding(숫자 벡터 배열), index(입력 순서)를 포함합니다. | - |
model* | string | * 필수 | 요청한 모델 ID를 그대로 반환합니다. | - |
usage* | object | * 필수 | 토큰 사용량. prompt_tokens(입력 토큰)와 total_tokens를 포함하며, 임베딩은 입력 토큰만 과금됩니다. | - |
코드 예제
curl -X POST https://billing-ai.doublezero.kr/api/v1/embeddings \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-embedding",
"input": "빌링AI는 원화 결제와 세금계산서를 지원하는 AI 게이트웨이입니다."
}'