본문으로 건너뛰기

openai/text-embedding-3-small/embedding

text-embedding-3-small은 메모와 문서 구절을 검색 벡터로 변환하며, 기본 1,536차원보다 짧게 출력할 수 있습니다.

최저가 $0.000004/1,000 토큰공식 가격보다 80% 저렴

플레이그라운드

입력

임베딩
3-small의 dimensions는 1~1,536이며, 저장 문서와 검색 질의의 차원 수를 맞춰야 합니다. 1 이상 · 1536 이하
3-small에는 문자열, 문자열 배열, 토큰 ID 배열 또는 토큰 배열 묶음을 전달합니다.
안전 검사꺼짐

SpicyAPI는 이 모델에 안전 검사를 적용하지 않습니다. 프롬프트와 소재는 작성한 그대로 모델에 전달되며, 결과는 모델 자체가 결정합니다.

제출과 가격 계산을 열기 전에 계정을 확인하고 있습니다.

출력

실행 대기
샘플 결과
{"data":[{"embedding":[0.52685546875,0.419189453125,0.6533203125,-0.0018758773803710938,-0.25048828125,-0.0029315948486328125,0.2252197265625,-0.07879638671875],"index":0},{"embedding":[-0.0767822265625,0.150146484375,0.52099609375,0.15771484375,-0.184814453125,0.0173492431640625,-0.5791015625,-0.55224609375],"index":1}],"inputTokens":12}

찾는 모델이 없나요?

3-small로 새 메모 색인을 만들 때는 256차원의 검색 품질을 평가한 뒤 저장 크기를 결정하는 것이 좋습니다.

핵심 수치

차원 수
1536

토큰 예산

입력 윈도우
300,000
요청당 토큰

결제하기 전에

임베딩

text-embedding-3-small의 플랫폼 요청은 최대 128건이며 각 입력은 8,192토큰, 합계는 300,000토큰 이내여야 합니다. text-embedding-3-small에 전달하는 토큰 ID 배열은 최대 2,048개입니다.

할 수 있는 일

길이를 조정하는 소형 벡터

3-small의 출력 길이를 조정하면 메모 앱에서 256차원 인덱스와 기본 표현을 비교할 수 있습니다. 짧은 벡터는 공간을 덜 차지하지만 실제 사용자가 묻는 질문에서 검색 품질을 확인해야 합니다. 같은 컬렉션의 문서와 검색어에는 동일한 차원 수를 사용합니다.

문서 구간별 독립 벡터

3-small 배치 요청은 입력 구간마다 개별 벡터를 반환합니다. 결과의 index를 원본 입력과 연결한 뒤 앱의 문서 ID, 출처 위치, 열람 권한을 별도 메타데이터로 관리할 수 있습니다. 이 엔드포인트는 요청당 최대 128개 입력을 받으며, 배치 전체에서 측정한 입력 토큰 수를 기준으로 과금합니다.

이럴 때 씁니다

  • 개인 메모 검색

    개인 메모를 3-small로 검색할 때는 짧은 구간과 메모 ID를 함께 저장합니다. 검색어와 본문의 표현이 달라도 관련 후보를 찾는 데 사용할 수 있습니다. 독자가 의미와 작성 시점을 확인하도록 결과에 원본 구간과 날짜를 함께 표시합니다.

  • 승인된 도움말 문서 검색

    지원 문서를 3-small로 검색할 때는 고객 질문과 관련된 승인된 도움말을 고르고, 해당 출처를 별도의 글쓰기 모델에 전달할 수 있습니다. 벡터의 유사도는 검색 후보를 고르는 신호입니다. 고객에게 공개할 수 있는 문서인지는 애플리케이션이 계속 판단해야 합니다.

모델 레퍼런스

text-embedding-3-small API 레퍼런스

text-embedding-3-small API 사양

차원 수
1536

text-embedding-3-small API 호출 방법

  1. 프롬프트 가이드와 실전 팁

    3-small에 보낼 긴 문서는 의미가 유지되는 절 경계에서 나눕니다. 단독으로 읽으면 모호한 구간에는 앞뒤 문맥을 조금 겹쳐 넣습니다. 답변을 만들어 달라는 지시 대신 표현하려는 본문 자체를 전송합니다. 빈 문자열은 거절되며 입력당 8,192토큰, 요청 전체 300,000토큰 이내여야 합니다. 미리 토큰화한 배열은 2,048개 요소로 제한합니다. 3-small 인덱스를 운영에 적용하기 전에 정답 구간을 아는 질문으로 기본 차원 수와 한 가지 이상의 축소 설정을 비교합니다. 인덱스에 모델 ID, 차원 수, 문서 분할 버전을 저장하고 설정이 바뀐 범위의 벡터를 다시 생성합니다. 후보를 고를 때 계정과 프로젝트 권한을 적용하고, 원본 메모가 삭제되면 인덱스 항목도 제거합니다.

text-embedding-3-small API 자주 묻는 질문

text-embedding 전체 모델3