본문으로 건너뛰기

계정

Kitsch Labs 계정은 서비스 로그인과 API 사용 권한의 기준입니다. 계정을 만든 뒤 API 접근과 키 발급이 필요한 경우 지원팀에 요청하세요.

계정은 어디에서 만드나요?​

조직에서 사용할 계정이라면 개인 메일보다 관리 가능한 업무용 주소를 사용하고, 담당자가 바뀌어도 접근을 회수할 수 있는 절차를 마련하세요.

API 접근 권한은 어떻게 받나요?​

현재 공개 문서에서는 self-service API 키 관리 화면을 안내하지 않습니다. giopaik@kitschlabs.com으로 아래 정보를 보내 API 접근과 발급 절차를 확인해 주세요.

  • 회사 또는 팀 이름
  • 제품과 API 사용 목적
  • 예상 월간 생성량과 최대 동시 요청
  • 사용할 언어와 음성
  • 개발·production 키 분리 필요 여부

Enterprise 계약이나 제한 음성은 별도의 사용 범위와 한도가 적용될 수 있습니다.

API 키는 어떤 형식인가요?​

새 API 키는 sk-kitsch- prefix를 사용합니다.

sk-kitsch-<random-secret>

전체 키는 발급 시 한 번만 확인할 수 있으므로 즉시 비밀 관리 서비스에 저장하세요. 이후 화면에는 sk-kitsch-abcd...wxyz 같은 preview만 표시됩니다.

애플리케이션에는 어떻게 설정하나요?​

환경 변수에 저장하고 서버에서 읽으세요.

export KITSCH_API_KEY="<API_KEY>"

.env 파일을 사용한다면 저장소에 commit되지 않도록 .gitignore에 포함해야 합니다.

키가 노출되면 어떻게 하나요?​

  1. 노출된 키의 사용을 즉시 중단합니다.
  2. 지원팀에 revoke를 요청합니다.
  3. 새 키를 발급받아 서버의 secret을 교체합니다.
  4. 로그와 배포 이력에서 노출 범위와 비정상 사용을 확인합니다.

Revoke는 앞으로의 요청을 차단하지만 기존 사용 기록은 삭제하지 않습니다.

인증 오류는 어떻게 확인하나요?​

401 응답이 오면 다음 순서로 확인하세요.

  • header 이름이 xi-api-key인지 확인
  • 값 앞뒤의 따옴표, 공백, 줄바꿈 제거
  • 개발 키와 production 키가 바뀌지 않았는지 확인
  • 키가 revoke, 만료 또는 suspend되지 않았는지 확인
  • 계속 실패하면 응답의 x-kitsch-request-id와 발생 시각을 지원팀에 전달