Qwen: Qwen3 Embedding 8B
Qwen3-Embedding-8B는 다국어 검색, 코드 검색, 분류, 군집화를 위해 텍스트를 의미 벡터로 변환합니다. 32K토큰 시퀀스 길이와 32부터 4,096까지의 사용자 지정 임베딩 차원을 지원합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Qwen3-Embedding-8B는 밀집 Qwen3 기반 모델에서 구축한 Qwen의 8B 텍스트 임베딩 모델입니다. 대화형 답변을 생성하는 대신 텍스트를 수치 벡터로 표현합니다. Qwen은 텍스트 검색, 코드 검색, 분류, 군집화, 이중언어 병렬 문장 발굴을 지원 활용 분야로 제시합니다. 검색 시스템은 벡터로 질문과 관련 지문을 비교하고, 문서 컬렉션은 의미적으로 관련된 자료를 찾거나 레코드를 그룹으로 정리할 수 있습니다.
이 정확한 모델은 32K토큰 시퀀스 길이와 최대 4,096차원 임베딩을 지원합니다. Matryoshka Representation Learning으로 32부터 4,096까지 사용자 정의 출력 차원도 지원합니다. 따라서 벡터 길이는 의도적인 설계 선택입니다. 더 짧은 벡터는 표현 크기를 바꾸고, 전체 출력은 모델의 최대 차원을 보존합니다. 한 색인에서 비교하는 문서와 질의에는 선택한 차원을 일관되게 유지하세요. Qwen3-Embedding-4B는 최대 차원이 다른 별도 에디션이며, 기존 8B 컬렉션에 서로 바꿔 쓸 수 있는 벡터를 제공하는 모델이 아닙니다.
제공자는 프로그래밍 언어를 포함한 100개가 넘는 언어와 다국어, 언어 간, 코드 검색 지원을 설명합니다. 실제 컬렉션은 여러 언어 문서를 담고 질의로 관련 의미를 찾거나, 자연어 질문을 위해 소스 코드 지문을 색인할 수 있습니다. 중요한 식별자, 제목, 도메인 용어를 입력에 보존하세요. 코드에서는 함수나 모듈 주변 설명이 질문의 일부라면 발췌와 함께 유지하세요. 출력은 계속 벡터 표현이며, 일치한 문서 텍스트를 반환하는 것은 검색 애플리케이션의 다음 단계입니다.
모델은 지시를 고려합니다. Qwen은 검색 작업에 맞춘 한 문장 지시를 권장하며, 다국어 사용에서는 그 지시를 영어로 작성할 것을 권장합니다. 직접 사용 예제는 Instruct: 다음에 작업 설명을, Query: 다음에 질문을 배치해 질의 형식을 지정합니다. 해당 예제에서 검색 문서에는 같은 지시 접두사가 필요하지 않습니다. 적합한 독자적 지시는 사용자 오류를 설명하는 기술 지문 찾기를 설명한 뒤, 질의에 특정 오류 설명을 넣을 수 있습니다. 지시는 검색이 어떤 의미 관계를 우선해야 하는지 설명합니다.
Qwen의 예제는 질의와 문서를 따로 인코딩하고 코사인 유사도로 벡터를 비교합니다. 마지막 토큰의 은닉 상태를 풀링하고 임베딩을 정규화한 뒤 내적으로 비교하는 하위 수준 절차도 보여줍니다. 유용한 워크플로는 각 지문 벡터를 원본 식별자에 연결하고, 준비한 질의를 저장된 벡터와 비교해 해당 지문을 유사도 순서로 반환합니다. 예제의 8,192토큰 잘림 설정은 선택한 입력 처리 설정이며, 모델의 문서화된 32K 시퀀스 길이와 구분됩니다. 긴 입력을 준비할 때 무엇이 보존되는지 검토하세요.
Qwen 릴리스에서 임베딩 모델과 리랭킹 모델은 다른 구성 요소입니다. 임베딩 모델은 텍스트 구간 하나를 표현해 초기 유사도 검색을 가능하게 합니다. 별도 리랭커가 질의와 후보 지문 사이의 관계를 평가하고 순서를 정교하게 조정할 수 있습니다. Qwen은 두 모듈의 결합을 설명하지만, Qwen3-Embedding-8B 자체는 리랭커의 관련성 판단이나 글로 된 답변이 아니라 임베딩을 반환합니다. 검색 후 답변을 작성할 때에는 일치한 원문을 유지하고 그 근거를 답변 단계에 전달하세요. 검색 대상 컬렉션에서 모델, 차원, 질의 지시를 선택하고 일관되게 유지하세요.
Ailoot Ultra · 임베딩 POST /v1/embeddings qwen/qwen3-embedding-8b
qwen/qwen3-embedding-8b시작하기
Qwen3-Embedding-8B는 다국어 검색, 코드 검색, 분류, 군집화를 위해 텍스트를 의미 벡터로 변환합니다. 32K토큰 시퀀스 길이와 32부터 4,096까지의 사용자 지정 임베딩 차원을 지원합니다.
- 허용 입력
- 텍스트 · token_ids
- 결과
- embedding
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 임베딩 POST /v1/embeddings
- 입력
text,token_ids- 출력
embedding- 컨텍스트
- 32,768 tokens
- 출력 형식
- json
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 qwen/qwen3-embedding-8b | 기본값— |
필드input | 유형string|string[]|integer[]|integer[][] | 요건필수 | 값과 한도 최소 항목 수: 1 조건: 비어 있지 않은 동일 형식의 배치입니다. 토큰 ID는 0 이상의 정수입니다. 입력 허용량: 최댓값: 32,768 · 텍스트 단위: UTF8 바이트 · 토큰 단위: 토큰 배열 요소 | 기본값— |
필드encoding_format | 유형string | 요건선택 사항 | 값과 한도 float | 기본값float |
필드dimensions | 유형integer | 요건지원되지 않음 | 값과 한도 최솟값: 1 | 기본값— |
필드user | 유형json_value | 요건선택 사항 | 값과 한도 조건: 원본에서 이 JSON 메타데이터 필드를 허용하며, 정확한 업스트림 동작은 모델별로 다릅니다. | 기본값— |
필드session_id | 유형json_value | 요건선택 사항 | 값과 한도 조건: 원본에서 이 JSON 메타데이터 필드를 허용하며, 정확한 업스트림 동작은 모델별로 다릅니다. | 기본값— |
필드trace | 유형json_value | 요건선택 사항 | 값과 한도 조건: 원본에서 이 JSON 메타데이터 필드를 허용하며, 정확한 업스트림 동작은 모델별로 다릅니다. | 기본값— |
필드provider | 유형object | 요건선택 사항 | 값과 한도 조건: provider.options가 거부됨 | 기본값— |
입력 자료 조합
text_to_embedding
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input |
매개변수input_shapes | 명세string, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
매개변수encoding_format | 명세float |
매개변수dimensions_override | 명세false |
매개변수max_input_budget_units | 명세32768 |
매개변수multimodal_objects | 명세false |
매개변수material_types | 명세text, token_ids |
수명 주기: synchronous_json
모든 벡터의 인덱스와 차원을 보관하세요.
모델 이름이 멀티모달이어도 이 특정 경로에서 이미지 객체를 사용할 수 있는 것은 아닙니다.
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 표준 요금 빠른 모드를 선택한 경우
- Flex 모드
- 표준 요금 flex 모드를 선택한 경우
- 최대 추론 수준
- 표준 요금 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
| 설정 | 요금표 | 요금 |
|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 요금 입력 · 입력 토큰 $0.00002 / 1K 토큰 출력 · 출력 토큰 $0 / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 임베딩
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "qwen/qwen3-embedding-8b", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='qwen/qwen3-embedding-8b',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
결과 수신 및 저장
Ailoot Ultra · 임베딩
json
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
모든 벡터를 인덱스와 함께 보관하세요. 벡터 수는 입력 수와 같아야 하며 차원은 일관되어야 합니다.
원래 응답을 확인해야 할 경우
임베딩 작업 엔드포인트는 추가되지 않습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드object | 유형string |
필드model | 유형string |
필드data[].index | 유형integer |
필드data[].embedding | 유형finite float[] |
필드usage | 유형object |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
별칭
모델 별칭
Ailoot Ultra qwen/qwen3-embedding-8b
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Qwen: Qwen3 Embedding 8B
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/embeddings·qwen/qwen3-embedding-8b:text,token_ids→embedding- 요청은 어떤 필드를 사용하나요?
POST /v1/embeddings·qwen/qwen3-embedding-8b:model,input,encoding_format,provider- 어떤 제한이 적용되나요?
POST /v1/embeddings·qwen/qwen3-embedding-8b:ctx:32768;input.budget.maximum:32768(UTF8 바이트);input.min_items:1