POST
/
v1
/
rag42
/
collections
curl --request POST \
  --url https://api.clovastudio.go.kr/v1/rag42/collections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "collection_name": "법규집_2024"
}'
{
  "status": {
    "code": "20000",
    "message": "OK"
  },
  "result": {
    "collection_id": "ef7483af16d84818a59dcbcf8b587b93",
    "collection_name": "법규집_2024",
    "visibility": "private",
    "is_owner": true,
    "created_at": "2024-10-18T10:30:00Z",
    "updated_at": "2024-10-18T10:30:00Z",
    "operation": "create_collection"
  }
}

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_name
string
required

생성할 컬렉션 이름

Required string length: 1 - 255
​
description
string | null

컬렉션 설명 (사용자 설명용)

​
visibility
enum<string> | null
default:private

컬렉션 공개 여부 (public/private, 기본값: private)

Available options:
public,
private
​
search_config
object | null

검색 설정 (미지정 시 기본값 사용: hybrid, alpha=0.5) 컬렉션의 검색 설정

Examples:
{
  "alpha": 0.5,
  "fusion": "linear",
  "mode": "hybrid"
}
{ "fusion": "rrf", "mode": "hybrid" }
{
  "alpha": 1,
  "default_filters": { "category": "law" },
  "mode": "vector"
}
​
ingest_config
object | null

인제스트 설정 (미지정 시 기본값 사용: by_length, chunk_size=2000, overlap=200, bge-m3) 컬렉션의 인제스트 설정

Examples:
{
  "chunking_strategy": "by_title",
  "embedding_dimension": 1024,
  "embedding_model": "bge-m3",
  "external_id_field": "document_number",
  "parser_model": "rag42-chunk-v1",
  "pii_mask": true
}
{
  "chunk_overlap": 50,
  "chunk_size": 512,
  "chunking_strategy": "by_length",
  "embedding_dimension": 1024,
  "embedding_model": "bge-m3",
  "external_id_field": "external_id",
  "parser_model": "rag42-chunk-v1",
  "pii_mask": true
}
{
  "chunking_strategy": "by_title",
  "embedding_dimension": 1024,
  "embedding_model": "rag42-embed-v1",
  "parser_model": "lomin-layout-v1",
  "pii_mask": false
}

Response

컬렉션 생성 성공

​
status
object
required

응답 상태

​
result
object
required

컬렉션 생성 결과