Skip to main content

Translation API

STT API와 Translation API를 합친 번역 API에 대한 문서입니다. 현재 영어에서 일본어로 번역만 지원합니다.

노트

데모용으로 한국 지역 서버에서 배포 중이기 때문에 사용하는 위치에 따라 약간의 지연이 발생할 수 있습니다.

시작하기​

Endpoint​

주의

API를 사용할 때는 빔포밍 SDK를 통과한 오디오 파일과 듀얼 마이크의 원본 데이터를 모두 전송해야 제대로 사용할 수 있습니다.


POST https://api.translate.beam.deephearing.com/files/<FILE_TYPE>

Access Key​

정보

Access Key(X-API-KEY)을 요청 헤더에 작성해야 합니다.

PCM 데이터로 보내기​


POST https://api.translate.beam.deephearing.com/files/pcm

  • files : 원본 PCM 오디오 파일과 빔포밍 SDK를 통과한 PCM 오디오 파일

필수사항​

원본 오디오

  • 2채널 스테레오
  • 16,000Hz
  • Linear 16bit PCM Data

빔포밍 SDK에서 처리한 오디오

  • 1채널 모노
  • 16,000Hz
  • Linear 16bit PCM Data
주의

파일명은 반드시 bypass (원본 오디오)와 beamformer (빔포밍 SDK에서 처리한 오디오)로 설정되어 있어야 합니다.

curl --location 'https://api.translate.beam.deephearing.com/files/pcm' \
    --header 'X-API-KEY: <ACCESS_TOKEN>' \
    --form 'files=@"bypass"' \
    --form 'files=@"beamformer"'

WAV 데이터로 보내기​


POST https://api.translate.beam.deephearing.com/files/wav

  • files : 원본 Wav 오디오 파일과 빔포밍 SDK를 통과한 Wav 오디오 파일

필수사항​

듀얼마이크에서 받아온 원본 오디오

  • 2채널 스테레오
  • 16,000Hz
  • Wav Data

빔포밍 SDK에서 처리한 오디오

  • 1채널 모노
  • 16,000Hz
  • Wav Data
주의

.wav 확장자를 필수적으로 작성해주세요.

주의

파일명은 반드시 bypass.wav (원본 오디오)와 beamformer.wav (빔포밍 SDK에서 처리한 오디오)로 설정되어 있어야 합니다.

curl --location 'https://api.translate.beam.deephearing.com/files/wav' \
    --header 'X-API-KEY: <ACCESS_TOKEN>' \
    --form 'files=@"bypass.wav"' \
    --form 'files=@"beamformer.wav"'

응답받기​

Success ✅​

{
 result: <TRANSLATED_TEXT>
}
  • result : String

Error 🔴​

{
 detail: <ERROR_MESSAGE>
}
  • detail : String
최근 업데이트 on