API 키
aicon API 호출에 필요한 Secret Key를 설명합니다.
API 키 확인하기
콘솔에 접속하여 API 키를 확인하세요.
키 종류
aicon에서는 환경별로 두 종류의 키를 발급합니다.
- 라이브 Secret Key (
live_sk_) — 프로덕션 환경. 실제 벤더 호출, 과금 발생 - 테스트 Secret Key (
test_sk_) — 테스트 환경. 실제 벤더 호출 없음, 과금 없음
live_sk_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 (총 40자)
test_sk_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 (총 40자)
- 접두사 —
test_sk_또는live_sk_(8자) - 랜덤 부분 — 32자 (hex)
- 총 길이 — 40자
키 관리
발급
aicon 콘솔에서 환경을 선택하여 Secret Key를 발급합니다. 발급 시점에만 전체 키가 노출되며, 이후 콘솔에서는 마스킹 처리됩니다.
시크릿 키: live_sk_••••••••••••••••••••••••••b2c3d4
전체 키를 다시 확인하려면 콘솔에서 재인증이 필요합니다.
재발급
기존 키를 폐기하고 새 키를 발급합니다. 기존 키는 즉시 차단되므로, 새 키로 교체한 후 재발급하세요.
폐기
키를 폐기하면 해당 키로의 모든 API 요청이 즉시 401로 거부됩니다. 이미 접수된 비동기 작업(발송 등)은 정상 완료됩니다.
Secret Key 보안
- Secret Key는 서버 사이드에서만 사용하세요
- 클라이언트(브라우저, 모바일 앱)에 절대 노출하지 마세요
- 소스 코드에 직접 포함하지 말고 환경 변수로 관리하세요
- 키가 노출된 경우 즉시 재발급하세요