Clova Studio Gov API는 Bearer Token을 사용한 인증 방식을 지원합니다. API를 호출하려면 발급받은 API 키를 요청 헤더에 포함해야 합니다.
API 키 발급 방법은 시작하기 가이드를 참조하세요.
인증 헤더
모든 API 요청에는 다음 인증 헤더가 필요합니다:
Authorization: Bearer YOUR_API_KEY
발급받은 API 키를 Bearer 토큰 형식으로 전달합니다.
Bearer 인증은 Bearer <token> 형식의 인증 헤더를 사용합니다. 여기서 <token>은 발급받은 API 키입니다.
다음은 Bearer Token을 사용하여 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": "텍스트 임베딩을 생성합니다"
}'
API에 따라 추가 헤더가 필요할 수 있습니다. 자세한 내용은 요청 헤더 문서를 참조하세요.
보안 고려사항
API 키는 민감 정보입니다. 클라이언트 사이드 코드(브라우저, 모바일 앱)에 노출하지 말고, 서버에서 환경 변수나 키 관리 서비스를 통해 안전하게 로드하세요. 공개 저장소에 커밋하지 마세요.
인증 관련 에러 처리 방법은 에러 처리 문서를 참조하세요.