Skip to main content

인증

VoiceCheap API는 인증을 위해 API 키를 사용합니다. 모든 API 요청에는 x-api-key 헤더에 API 키가 포함되어야 합니다.

API 키 발급받기

1

VoiceCheap에 로그인

app.voicecheap.ai에 접속하여 계정에 로그인하세요.
2

API 페이지로 이동

app.voicecheap.ai/page-apiAPI 페이지로 이동하세요.
3

API 키 생성

새 키 생성을 클릭하고 키 이름을 지정하세요. 전체 API 키는 한 번만 표시되므로 즉시 복사하여 안전하게 보관하세요.
중요: 키를 즉시 저장하세요전체 API 키는 생성 시 한 번만 표시됩니다. 모달을 닫으면 마스킹된 버전(vc_abc...xyz)만 볼 수 있습니다. 키를 분실하면 삭제 후 새로 생성해야 합니다.

API 키 제한

  • 계정당 최대 5개의 API 키를 생성할 수 있습니다
  • 각 키는 쉽게 식별할 수 있도록 이름을 지정할 수 있습니다(예: “운영”, “개발”)
  • 키는 API 페이지에서 언제든지 삭제할 수 있습니다

API 키 사용

모든 요청 시 x-api-key 헤더에 API 키를 포함하세요:

요구 사항

유료 구독 필요API를 사용하려면 활성화된 유료 구독이 필요합니다. 무료 계정은 API를 사용할 수 없습니다. 유효한 구독 없이 API를 사용하려고 하면 403 Forbidden 오류가 발생합니다.

API 키 보안

비밀 유지

API 키를 클라이언트 측 코드, 공개 저장소 또는 공개적으로 접근 가능한 위치에 절대 노출하지 마세요.

환경 변수 사용

API 키를 환경 변수나 안전한 보안 관리자에 저장하세요.

정기적인 교체

API 키가 유출되었을 가능성이 있는 경우, 주기적으로 키를 교체하세요.

사용량 모니터링

API 사용량을 추적하여 무단 액세스를 감지하세요.

오류 응답

인증에 실패하면 다음 오류 중 하나가 발생합니다:

오류 응답 예시