인증 - Supertone API Documentation

이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.

Supertone API는 커스텀 헤더 기반의 API 키 인증 방식을 사용합니다.

헤더

x-sup-api-key: <YOUR_API_KEY>

모든 요청에 이 헤더를 포함해 주십시오. 키가 누락되거나 유효하지 않으면 401 Unauthorized가 반환되며, 해당 리소스에 대한 권한이 없는 키는 403 Forbidden을 반환합니다.

개발자 콘솔에 로그인한 뒤 새 키를 생성해 주십시오. 계정당 최대 3개의 활성 키를 보유할 수 있으며, 콘솔에서 언제든 폐기하고 재발급할 수 있습니다.

curl https://supertoneapi.com/v1/voices \
  -H "x-sup-api-key: $SUPERTONE_API_KEY"

Status	Cause
`401 Unauthorized`	API 키가 누락되었거나, 형식이 올바르지 않거나, 폐기되었습니다.
`403 Forbidden`	유효한 키이지만 해당 리소스에 대한 권한이 없습니다(예: 다른 계정 소유의 커스텀 보이스 호출).

전체 오류 목록과 권장 대응 방법은 오류 처리를 참고해 주십시오.

설정 가이드, 환경 변수 규칙, 보안 체크리스트입니다.

키를 설정하고 5분 안에 첫 호출을 완료합니다.

⌘I