수퍼톤 API를 사용하여 고품질 AI 음성을 생성하는 방법을 단계별로 안내해드립니다.
이 페이지는 Supertone API를 처음 사용해보는 분들이
빠르게 음성 합성 흐름을 체험해볼 수 있도록 구성되어 있습니다.
아래 순서를 따라 직접 호출까지 완료해보세요.
수퍼톤 API는 API Key 기반 인증을 사용합니다.
콘솔에 가입하고, 새로운 서비스를 생성하면 바로 API Key를 발급받을 수 있습니다.
x-sup-api-key
헤더에 발급받은 키를 넣어주세요.보이스 ID는 텍스트를 어떤 목소리로 읽을지 결정하는 키입니다. 현재 계정에서 사용 가능한 보이스는 다음 세 가지 방법으로 확인할 수 있습니다
가장 손쉽게 보이스 ID를 확인하는 방법은 Supertone Play의 보이스 라이브러리에서 복사하는 것입니다.
아래 예시 이미지에서처럼, 각 보이스 내의 ‘Copy voice ID’ 버튼을 클릭하면 해당 보이스의 voice_id
가 클립보드에 복사됩니다.
클론드 보이스 역시 같은 방법으로 voice_id
를 복사할 수 있습니다.
복사한 ID는 콘솔이나 API에서 바로 사용할 수 있습니다.
GET /voices 엔드포인트를 사용하면, 조건 없이 사용 가능한 전체 보이스 목록을 받아올 수 있습니다.
GET /v1/voices/search에서는 언어, 스타일 등을 기준으로 보이스를 필터링할 수 있습니다.
각 보이스의 id 필드를 확인해 실제 호출에 사용할 수 있습니다.
보이스 ID를 확인했다면, 이제 실제로 텍스트를 음성으로 변환해볼 수 있습니다. 아래는 기본적인 호출 예시입니다:
응답은 오디오 파일 스트림 형식(WAV)으로 반환되며, 헤더의 X-Audio-Length 값을 통해 생성된 음성의 길이를 확인할 수 있습니다.
이제 수퍼톤 API를 연동할 준비가 완료되었습니다. 이제 다음 단계로 넘어가, 더 다양한 설정과 고급 사용법을 확인해보세요.