STT
Async

Send long audio to transcribe

오디오 파일을 텍스트로 변환합니다. 비동기화 방식이 사용됩니다. POST 요청으로 rid를 발급받은 후 GET 요청으로 진행상황 및 결과를 확인할 수 있습니다.

multipart/form-data 방식의 요청으로 파일을 직접 보낼 수 있고, application/json 방식의 요청으로 파일이 저장된 공개 URL을 넘길 수 있습니다.

post/stt/v1/async/transcripts

Request

Request body

callbackUrlstring

[🚫 DEPRECATED] 콜백을 사용하기 위해서는 callback 필드를 참조하여 주시기 바랍니다.

받아쓰기 진행상태 및 결과를 전송받을 http(s) 를 포함한 URL 입니다.

받아쓰기가 진행 중에는 진행상태를, 받아쓰기가 완료 된 뒤에는 받아쓰기 결과를 POST 방식으로 해당 URL에 전송합니다.

CallbackUrl로 요청되는 request body는 SttAsyncInitResponse와 동일합니다.

customobject

응답에 포함하여 받고 싶은 사용자 객체를 명시합니다.

사용자가 요청에 custom 객체를 명시한 경우 동일한 값이 응답에 명시되어 반환됩니다.

요청을 자동화 하여 보낼 때 유용합니다.

Example request

{
  "sttConfig": {
    "keywordBoost": {
      "keywords": [
        "다글로"
      ]
    }
  },
  "nlpConfig": {
    "keywordExtraction": {
      "maxCount": 10
    }
  },
  "custom": {
    "app_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}

Response

Example response

ridstring

요청 ID 입니다.

fileNamestring

파일 이름입니다.

customobject

응답에 포함하여 받고 싶은 사용자 객체를 명시합니다.

사용자가 요청에 custom 객체를 명시한 경우 동일한 값이 응답에 명시되어 반환됩니다.

요청을 자동화 하여 보낼 때 유용합니다.

Example response

{
  "rid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "custom": {
    "app_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.