소개
text-embedding-3-small은 메모, 도움말 문서, 문서의 짧은 구간을 유사도 검색용 숫자 벡터로 변환합니다. 기본 출력은 1,536차원이며 필요에 따라 길이를 줄일 수 있습니다. 새 검색 컬렉션에서는 저장 공간과 검색 품질을 함께 측정해 적합성을 판단합니다. 반환값은 입력 텍스트의 표현이며, 질문에 대한 서술형 답변은 아닙니다.
핵심 기능 및 하이라이트
3-small의 출력 길이를 조정하면 메모 앱에서 256차원 인덱스와 기본 표현을 비교할 수 있습니다. 짧은 벡터는 공간을 덜 차지하지만 실제 사용자가 묻는 질문에서 검색 품질을 확인해야 합니다. 같은 컬렉션의 문서와 검색어에는 동일한 차원 수를 사용합니다.
3-small 배치 요청은 입력 구간마다 개별 벡터를 반환합니다. 결과의 index를 원본 입력과 연결한 뒤 앱의 문서 ID, 출처 위치, 열람 권한을 별도 메타데이터로 관리할 수 있습니다. 이 엔드포인트는 요청당 최대 128개 입력을 받으며, 배치 전체에서 측정한 입력 토큰 수를 기준으로 과금합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
dimensions | 아니요 | 3-small의 dimensions는 1~1,536이며, 저장 문서와 검색 질의의 차원 수를 맞춰야 합니다. |
embedding_input | 예 | 3-small에는 문자열, 문자열 배열, 토큰 ID 배열 또는 토큰 배열 묶음을 전달합니다. |
요금
$0.000004 / 1,000 토큰
활용 사례
개인 메모를 3-small로 검색할 때는 짧은 구간과 메모 ID를 함께 저장합니다. 검색어와 본문의 표현이 달라도 관련 후보를 찾는 데 사용할 수 있습니다. 독자가 의미와 작성 시점을 확인하도록 결과에 원본 구간과 날짜를 함께 표시합니다.
지원 문서를 3-small로 검색할 때는 고객 질문과 관련된 승인된 도움말을 고르고, 해당 출처를 별도의 글쓰기 모델에 전달할 수 있습니다. 벡터의 유사도는 검색 후보를 고르는 신호입니다. 고객에게 공개할 수 있는 문서인지는 애플리케이션이 계속 판단해야 합니다.
프롬프트 가이드 및 실전 팁
3-small에 보낼 긴 문서는 의미가 유지되는 절 경계에서 나눕니다. 단독으로 읽으면 모호한 구간에는 앞뒤 문맥을 조금 겹쳐 넣습니다. 답변을 만들어 달라는 지시 대신 표현하려는 본문 자체를 전송합니다. 빈 문자열은 거절되며 입력당 8,192토큰, 요청 전체 300,000토큰 이내여야 합니다. 미리 토큰화한 배열은 2,048개 요소로 제한합니다.
3-small 인덱스를 운영에 적용하기 전에 정답 구간을 아는 질문으로 기본 차원 수와 한 가지 이상의 축소 설정을 비교합니다. 인덱스에 모델 ID, 차원 수, 문서 분할 버전을 저장하고 설정이 바뀐 범위의 벡터를 다시 생성합니다. 후보를 고를 때 계정과 프로젝트 권한을 적용하고, 원본 메모가 삭제되면 인덱스 항목도 제거합니다.
{
"model": "openai/text-embedding-3-small/embedding",
"input": [
"A notebook about coastal birds.",
"An index of harbor observations."
]
}
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/text-embedding-3-small/embedding",
"input": {
"embedding_input": "The customer asks for a refund after being billed twice."
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.


