​
API 키 관련

API 키 발급 방법:
  1. Clova Studio Gov 플랫폼에 로그인
  2. API 키 발급 메뉴 선택
  3. API 키 생성 및 저장
발급받은 API 키는 안전한 곳에 보관하세요. 키가 유출되면 즉시 재발급받아야 합니다.
시범 서비스 기간 동안 API 키 발급은 무료입니다.단, 사용량에 따른 과금 정책은 추후 적용될 수 있습니다.
네, 여러 개의 API 키를 발급받아 사용할 수 있습니다.용도별 API 키 분리 권장:
  • 개발 환경용
  • 테스트 환경용
  • 프로덕션 환경용
이렇게 분리하면 보안과 관리가 용이합니다.
즉시 다음 조치를 취하세요:
  1. 키 비활성화: 유출된 API 키를 즉시 비활성화
  2. 새 키 발급: 새로운 API 키 발급
  3. 코드 업데이트: 애플리케이션에서 새 키로 교체
  4. 보안 점검: 유출 경로 파악 및 차단
  5. 로그 확인: 비정상적인 사용 이력 확인
API 키는 절대 코드에 직접 작성하지 말고, 환경 변수나 시크릿 관리 도구를 사용하세요.
기본적으로 API 키는 만료 기간이 없습니다.단, 다음 경우에는 키를 재발급해야 할 수 있습니다:
  • 보안 정책 변경 시
  • 장기간 미사용 시
  • 비정상 활동 감지 시
정기적인 키 로테이션을 권장합니다.

​
인증 방법

Bearer Token 방식을 사용합니다:
curl https://api.clovastudio.go.kr/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{...}'
Python 예제:
import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.clovastudio.go.kr/v1/chat/completions",
    headers=headers,
    json={...}
)
자세한 내용은 인증 가이드를 참고하세요.
현재는 Bearer Token 방식만 지원합니다.OAuth 2.0 지원 계획은 추후 공지될 예정입니다.
현재는 IP 화이트리스트 기능을 제공하지 않습니다.보안을 위해 다음 방법을 권장합니다:
  • API 키를 안전하게 보관
  • 서버 사이드에서만 API 호출
  • Rate Limiting 설정
  • 로그 모니터링
권장하지 않습니다.API 키가 클라이언트 코드에 노출되면 보안 위험이 있습니다.권장 아키텍처:
클라이언트 → 백엔드 서버 → Clova Studio API
백엔드 서버에서 API 키를 관리하고 호출하세요.
Python 예제:
# .env 파일
CLOVA_API_KEY=your_api_key_here

import os
from dotenv import load_dotenv

load_dotenv()
api_key = os.getenv("CLOVA_API_KEY")
Node.js 예제:
# .env 파일
CLOVA_API_KEY=your_api_key_here

require('dotenv').config();
const apiKey = process.env.CLOVA_API_KEY;
.env 파일은 절대 Git에 커밋하지 마세요! .gitignore에 추가하세요.

​
권한 및 접근 제어

권장하지 않습니다.각 팀원에게 개별 API 키를 발급하고:
  • 사용 추적이 가능
  • 퇴사 시 키만 비활성화
Clova Studio 플랫폼의 대시보드에서 확인할 수 있습니다:
  • API 호출 횟수
  • 사용량 통계
  • 에러 발생 현황
  • 비용 정보 (향후 제공 예정)
자세한 로그는 자체 애플리케이션에서 기록하는 것을 권장합니다.

​
문제 해결

다음을 확인하세요:
  1. API 키 확인
    • 올바른 키를 사용하고 있나요?
    • 복사 시 공백이 포함되지 않았나요?
  2. 헤더 형식 확인 
    Authorization: Bearer YOUR_API_KEY
    • “Bearer ” 접두사가 있나요?
    • 키와 Bearer 사이에 공백이 있나요?
  3. 키 상태 확인
    • API 키가 비활성화되지 않았나요?
    • 만료되지 않았나요?
  4. 권한 확인
    • 해당 API를 호출할 권한이 있나요?
권한 문제일 수 있습니다:
  • API 키에 해당 기능 사용 권한이 없음
  • 계정이 일시 중지됨
  • 사용량 제한 초과
대시보드에서 계정 상태를 확인하세요.
체크리스트:
  • API 키를 정확히 복사했나요?
  • 올바른 엔드포인트를 사용하고 있나요?
  • 헤더 형식이 올바른가요?
  • 네트워크 연결이 정상인가요?
  • 방화벽이 차단하고 있나요?
여전히 문제가 있다면 이슈를 등록해주세요.

​
관련 문서

인증 가이드

인증 설정 상세 가이드

에러 처리

에러 코드 및 해결 방법

빠른 시작

API 사용 시작하기

문제 해결

일반적인 문제 해결