소개
text-embedding-ada-002는 해당 모델을 사용하는 기존 검색 컬렉션을 위해 고정 1,536차원 벡터를 반환합니다. 문서와 질의가 이미 ada-002 표현을 사용하는 경우에 고정 길이가 의미를 갖습니다. 새 컬렉션을 구축할 때는 기존 ada-002 인덱스가 요구 사항을 충족한다고 가정하기 전에 직접 비교 평가를 진행합니다.
핵심 기능 및 하이라이트
ada-002는 출력 길이를 조정하지 못합니다. 차원 수가 같아도 의미 공간은 다를 수 있으므로 다른 모델이 만든 1,536차원 벡터를 그대로 대체해 사용할 수 없습니다. 저장한 문서와 질의에서 모델 버전과 텍스트 전처리 방식을 일치시킵니다.
ada-002 배치는 입력별로 독립적인 표현을 생성합니다. 이 엔드포인트는 텍스트 또는 지원되는 토큰 ID 배열을 최대 128개 처리합니다. 반환된 index로 결과를 입력에 연결하고 문서 식별자와 권한은 벡터 외부에서 관리합니다. 과금에는 실제로 측정한 입력 토큰 수를 사용합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
embedding_input | 예 | ada-002에서는 기존 문서 분할 기준을 유지하고, 검색 질의에도 저장 문서와 같은 모델을 사용합니다. |
요금
$0.00002 / 1,000 토큰
활용 사례
ada-002 기반 지식 검색을 운영 중이라면 기존 표현을 유지하면서 새 문서 구간을 추가할 수 있습니다. 오래되거나 접근이 막힌 문서가 검색되지 않도록 문서 개정과 열람 권한을 별도로 보관합니다.
ada-002에서 다른 모델로 옮길 때는 원본 텍스트로 후보 모델의 인덱스를 따로 만들고 대표 질문으로 양쪽을 비교합니다. 서로 다른 모델의 좌표값 대신 출처 ID로 문서를 대응시킵니다. 검색된 구간을 검토한 다음 실제 검색 대상을 새 인덱스로 전환합니다.
프롬프트 가이드 및 실전 팁
ada-002에 보낼 본문에는 기존 인덱스와 같은 정규화와 구간 경계를 적용합니다. 요약을 지시하지 말고 표현하려는 문장 자체를 전달합니다. 글쓰기를 요청해도 설명문 대신 벡터가 반환됩니다. 입력은 각각 8,192토큰, 전체 300,000토큰 이내이며 토큰 ID 배열은 2,048개 요소까지 허용합니다.
ada-002에는 dimensions를 보내지 않습니다. 출력은 1,536차원으로 고정됩니다. 실측 토큰 사용량과 결과 index의 입력 대응 관계를 기록합니다. 다른 임베딩 모델로 전환하면 저장한 문서 벡터를 다시 생성하고 새 인덱스를 검색하는 질의에도 같은 새 모델을 사용합니다.
{
"model": "openai/text-embedding-ada-002/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-ada-002/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 레퍼런스에서 확인하세요.


