API 키

API 키는 VocalLab API에 대한 요청을 인증합니다. API 액세스에는 Pro 또는 Max 플랜이 필요합니다.

키 생성

1. VocalLab Studio에서 사이드바의 API 및 MCP를 클릭합니다(vocallab.ai의 개발자 페이지에서도 가능합니다).
2. 키 이름(예: "Production" 또는 "Zapier")을 입력하고 키를 생성합니다.
3. 키를 즉시 복사하세요. 키는 vl_live_로 시작하며 한 번만 표시됩니다. 저희는 해시된 버전만 저장하므로 다시 보여드릴 수 없습니다.

키 사용

모든 요청에 Bearer 토큰으로 전송하세요:

curl https://api.vocallab.ai/api/v1/ping \
  -H "Authorization: Bearer vl_live_..."

키 폐기

API 및 MCP 페이지(또는 개발자)에서 키 옆의 Revoke를 클릭하세요. 즉시 작동을 멈춥니다. 키가 유출되었다면 폐기하고 새 키를 생성하세요.

권장 사항

• 키는 환경 변수나 시크릿 관리자에 저장하세요. 코드나 git에는 절대 두지 마세요.
• 앱이나 통합마다 별도의 키를 사용하면 다른 키에 영향을 주지 않고 하나만 폐기할 수 있습니다.
• Pro 또는 Max 플랜이 종료되면 다시 가입할 때까지 키가 작동을 멈춥니다(삭제되지는 않습니다).

제한

• 계정당 최대 활성 키 5개.
• 키당 분당 60회 요청(Max 플랜은 120회).