API 키
API 키는 VocalLab API에 대한 요청을 인증합니다. API 액세스에는 Studio 플랜이 필요합니다.
키 생성
- 개발자 설정으로 이동합니다.
- 이름(예: "Production" 또는 "Zapier")을 입력하고 Create key를 클릭합니다.
- 키를 즉시 복사하세요. 키는
vl_live_로 시작하며 한 번만 표시됩니다. 저희는 해시된 버전만 저장하므로 다시 보여드릴 수 없습니다.
키 사용
모든 요청에 Bearer 토큰으로 전송하세요:
curl https://api.vocallab.ai/api/v1/ping \
-H "Authorization: Bearer vl_live_..."
키 폐기
개발자 설정에서 키 옆의 Revoke를 클릭하세요. 즉시 작동을 멈춥니다. 키가 유출되었다면 폐기하고 새 키를 생성하세요.
권장 사항
- 키는 환경 변수나 시크릿 관리자에 저장하세요. 코드나 git에는 절대 두지 마세요.
- 앱이나 통합마다 별도의 키를 사용하면 다른 키에 영향을 주지 않고 하나만 폐기할 수 있습니다.
- Studio 플랜이 종료되면 다시 Studio로 돌아올 때까지 키가 작동을 멈춥니다(삭제되지는 않습니다).
제한
- 계정당 최대 활성 키 5개.
- 키당 분당 60회 요청.