POST
/
v1
/
rag42
/
search
curl --request POST \
--url https://api.clovastudio.go.kr/v1/rag42/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"collection_id": [
"ef7483af16d84818a59dcbcf8b587b93"
],
"query": "예산 편성 지침",
"top_k": 5
}'
{
"status": {
"code": "20000",
"message": "OK"
},
"result": {
"chunks": [
{
"chunk_id": "c1d2e3f4a5b6789012345678901234cd",
"title": "예산 편성 개요",
"content": "예산 편성은 각 부처의 사업 계획에 따라 재원을 배분하는 핵심 절차입니다.",
"score": 0.95,
"collection": {
"id": "ef7483af16d84818a59dcbcf8b587b93",
"name": "행정문서_2024"
},
"document": {
"id": "a5b6c7d8e9f01234567890123456abc",
"name": "budget_guideline_2024.pdf",
"page_range": "3",
"author": "기획재정부",
"department": "예산총괄과",
"document_type": "지침"
}
},
{
"chunk_id": "d2e3f4a5b6c789012345678901234def",
"title": "예산 편성 법적 근거",
"content": "예산 편성 지침은 국가재정법에 따라 매년 수립되며, 중장기 재정 계획과 연계됩니다.",
"score": 0.87,
"collection": {
"id": "ef7483af16d84818a59dcbcf8b587b93",
"name": "행정문서_2024"
},
"document": {
"id": "a5b6c7d8e9f01234567890123456abc",
"name": "budget_guideline_2024.pdf",
"page_range": "7",
"author": "기획재정부",
"department": "예산총괄과",
"document_type": "지침"
}
}
],
"total_cnt": 2,
"query": "예산 편성 지침"
},
"usage": {
"total_tokens": 145,
"embedding_tokens": 15,
"rerank_tokens": 130
}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

CSG-TENANT-ID
string | null

Clova Studio Gov 테넌트 ID

X-CSG-TENANT-ID
string | null

Clova Studio Gov 테넌트 ID (레거시)

Body

application/json
collection_id
string[]
required

검색할 컬렉션 ID 리스트 (단일 또는 멀티 컬렉션). 최대 개수: 8

Minimum length: 1
query
string
required

검색 쿼리 (필수)

Required string length: 1 - 1000
top_k
integer | null
default:10

반환할 결과 수

Required range: 1 <= x <= 100
collection_weights
number[] | null

멀티 컬렉션 검색 시 각 컬렉션의 상대적 가중치 (collection_id 순서와 동일, 자동으로 정규화됨, 미지정 시 자동 균등 분배). 예: [1, 1.5, 3] 또는 [7, 3]

rerank
object | null

Rerank 옵션 (멀티 컬렉션 시 기본 enabled=true, 단일 컬렉션 시 기본 enabled=true)

search_params
Search Params · array

각 컬렉션의 검색 파라미터 override (collection_id 순서와 동일). null이면 해당 컬렉션은 기본 설정 사용

verbose
boolean
default:false

상세 정보 포함 여부 (디버깅용, 점수 상세 정보 포함)

keyword_extraction
boolean
default:false

자연어 쿼리에서 키워드 자동 추출 (Nori 형태소 분석 사용). 키워드 검색 모드에서 권장

Response

문서 검색 성공

status
object
required

응답 상태

result
any

응답 결과 데이터

usage
object | null

API 사용량 정보 (파서, 검색, 업로드 API에서만 제공) API 사용량 정보 - 공통 베이스

Examples:
{
"embedding_tokens": 15,
"rerank_tokens": 130,
"total_tokens": 145
}
{
"embedding_tokens": 15,
"total_tokens": 15
}
{ "pages": 3 }