소개
text-embedding-3-large는 다국어 문서 검색에 사용할 텍스트를 기본 3,072차원 벡터로 변환합니다. 더 작은 인덱스를 위해 출력 길이를 줄일 수도 있습니다. 컬렉션의 언어와 문서 형식에 따라 검색 결과를 평가하고, 큰 표현이 추가 저장 공간을 사용할 만큼 도움이 되는지 판단할 수 있는 경우에 검토합니다.
핵심 기능 및 하이라이트
3-large의 다국어 표현은 질문과 출처 문서의 언어가 다를 때 활용할 수 있습니다. 모든 번역과 전문 용어의 검색 품질이 같다고 가정하지 말고 실제 문서로 확인합니다. 벡터는 의미 관계를 나타내는 숫자이며 인용문, 정확성 보증, 완성된 답변을 포함하지 않습니다.
3-large의 dimensions로 출력을 1,024차원처럼 줄일 수 있습니다. 이번 연결에서는 이 길이로 두 문장을 처리하고 다른 입력으로 기본 출력 길이도 확인했습니다. 벡터 길이는 공간과 검색 품질 사이의 선택이며, 배치 비용은 계속 실측 입력 토큰 수를 따릅니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
dimensions | 아니요 | 3-large는 1~3,072차원을 지원하며, 문서 2건의 배치에서 1,024차원 출력을 확인했습니다. |
embedding_input | 예 | 3-large에는 답변 지시문 대신 문서 본문을 전달하며, 각 배치 결과의 index로 입력 순서를 확인합니다. |
요금
$0.000026 / 1,000 토큰
활용 사례
다국어 제품 지식 기반에서 3-large를 사용하면 고객 언어로 작성된 질문에 맞는 출처 후보를 선택할 수 있습니다. 언어, 제품 버전, 문서 개정 정보를 별도 메타데이터로 저장해 겉보기에는 관련성이 높은 예전 절차가 최신 안내보다 앞서지 않도록 합니다.
연구 문서를 3-large로 인덱싱할 때는 관련 기술 구간의 순위를 정하고 원본 출처와 함께 후속 분석 모델에 전달할 수 있습니다. 문서 경계와 참조 ID를 유지하면 최종 설명을 실제로 검색한 근거와 대조할 수 있습니다.
프롬프트 가이드 및 실전 팁
3-large 평가는 사용자 언어로 된 질문과 찾아야 할 문서 구간으로 구성합니다. 기본 길이와 축소 출력을 비교하면서 올바른 검색 결과, 잘못 연결된 구간, 저장 공간, 검색 지연을 살펴봅니다. 서로 다른 벡터 길이를 한 인덱스에 섞지 않고 문서와 질의에 같은 모델을 사용합니다.
3-large 요청은 입력 128개, 입력당 8,192토큰, 합계 300,000토큰 이내로 구성합니다. 토큰 ID 배열의 요소는 최대 2,048개입니다. 글쓰기 모델에 전달하기 전에 접근 권한이 없는 후보를 제외하고 결과에 출처 ID를 남깁니다. 원본 문서를 갱신하거나 삭제할 때 관련 벡터도 함께 처리합니다.
{
"model": "openai/text-embedding-3-large/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-large/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 레퍼런스에서 확인하세요.


