Clova Studio Gov API를 호출할 때 사용하는 HTTP 헤더에 대해 설명합니다.
Content-Type
Content-Type: application/json
X-CSG-TENANT-ID
X-CSG-TENANT-ID: YOUR_TENANT_ID
필요한 API
RAG42 API에서는 이 헤더가 필수입니다:
/v1/rag42/search - 문서 검색/v1/rag42/collections - 컬렉션 관리/v1/rag42/collections/{id}/documents - 문서 관리- 기타 모든 RAG42 엔드포인트
RAG42에서 Tenant ID가 필요한 이유RAG42 API는 컬렉션, 문서, 청크 등 테넌트별 데이터를 저장하고 관리합니다. 여러 테넌트의 데이터가 동일한 시스템에 저장되므로, 데이터 격리와 멀티테넌시를 위해 Tenant ID가 필수입니다.
불필요한 API
다음 API들에서는 이 헤더가 불필요합니다:
- Chat Completions API
- 도구 API (문서 파싱, PII 마스킹, 임베딩, 재순위, TTS/STT)
Chat Completions와 도구 API에서 불필요한 이유문서 파싱, 임베딩 생성, TTS/STT, PII 마스킹 등은 영구 데이터를 저장하지 않는 순수 변환/연산 작업입니다. 각 요청이 독립적이며 API 키만으로 인증, 과금, 권한 관리가 가능하므로 별도의 Tenant ID가 필요하지 않습니다.
RAG42 API 호출
curl -X POST "https://api.clovastudio.go.kr/v1/rag42/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-CSG-TENANT-ID: YOUR_TENANT_ID" \
-H "Content-Type: application/json" \
-d '{
"query": "검색어",
"collection_id": "your-collection-id"
}'
도구 API 호출
curl -X POST "https://api.clovastudio.go.kr/v1/text/embeddings" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": "텍스트 임베딩을 생성합니다"
}'
다음 단계
