---
title: "Send long audio to transcribe"
method: POST
path: "/stt/v1/async/transcripts"
tags: ["STT", "Async"]
---

# Send long audio to transcribe

`POST /stt/v1/async/transcripts`

## Request

- Base URL: `https://apis.daglo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://apis.daglo.ai/stt/v1/async/transcripts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/daglo/apis/cloud-api/docs/stt/v1/async/transcripts/post.ts> (a function with typed inputs; its response is checked against the schema)

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

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

## Request body

- object
  - `audio` object, required: 음성 파일에 대한 설정입니다. 파일 크기가 2GB를 넘지 않아야 하고, 파일 재생 시간이 4시간 이내여야 합니다. 다음과 같은 형식의 파일을 업로드하여 받아쓰기 하실 수 있습니다. • 오디오 : `.3gp`, `.3gpp`, `.ac3`, `.aac`, `.aiff`, `.amr`, `.au`, `.flac`, `.m4a`, `.mp3`, `.mxf`, `.opus`, `.ra`, `.wav`, `.weba` • 비디오 : `.asx`, `.avi`, `.ogm`, `.ogv`, `.m4v`, `.mov`, `.mp4`, `.mpeg`, `.mpg`, `.wmv` 확장자(형식)가 같더라도 실제 내용(인코딩)이 다를 경우 받아쓰기가 진행되지 않을 수 있습니다.
    - `source` object, required
      - `url` string, required: 받아쓰기를 요청할 파일의 URL 입니다. 해당 URL에 접근이 가능해야 합니다.
  - `sttConfig` object: 비동기 방식의 STT 요청을 위한 설정입니다.
    - `model` 'general': 받아쓰기에 사용할 모델 이름입니다. 명시하지 않을 경우 `general` 이 사용됩니다. 사용 가능한 모델은 다음과 같습니다. |**모델**|**설명**| |:---:|:---:| |`general`|일반적인 경우에 사용되는 모델입니다.|
    - `language` 'ko-KR' | 'en-US' | 'mixed' | 'ja-JP' | 'cmn-Hans-CN' | 'de-DE' | 'fr-FR' | 'es-ES' | 'it-IT' | 'nl-NL' | 'sv-SE' | 'hi-IN' | 'ru-RU' | 'vi-VN' | 'th-TH' | 'id-ID' | 'fa-IR' | 'cs-CZ': 받아쓰기 할 컨텐츠의 언어입니다. 사용 가능한 값은 `ko-KR`, `en-US`, `mixed`, `ja-JP` 이며, 기본값은 `ko-KR` 입니다. (대소문자를 구분합니다) 한국어와 영어가 섞여있는 컨텐츠의 경우, `mixed`를 사용하면 받아쓰기를 할 때 두 언어를 구분하여 받아쓰기를 시도합니다.
    - `keywordBoost` object: 키워드 부스트를 위한 설정입니다. 키워드 부스트를 활성화 하면 받아쓰기 결과에서 명시된 키워드들의 인식 확률이 향상됩니다.
      - `enable` boolean: 키워드 부스트를 활성화 하기 위해서는 반드시 `true`로 설정해야 합니다.
      - `keywords` string[]: 강조할 키워드를 명시합니다. string의 배열 형태입니다. 명시하지 않을 경우 키워드 부스트가 비활성화 됩니다.
      - `boost` integer: 키워드 부스트 정도를 설정합니다. 높을 수록 더 높은 확률로 키워드를 인식합니다. 1 ~ 15 사이의 정수값입니다. 명시하지 않으면 5 입니다.
    - `multiChannel` object: 멀티 채널 오디오에 대한 설정입니다. 오디오의 채널이 여러개인 경우 각 채널의 음성을 따로 받아쓰기 합니다. 2 개의 채널까지만 지원합니다. 명시되지 않을 경우 비활성화 됩니다.
      - `channelCount` integer: 오디오의 채널 수 입니다. 1 보다 큰 값이 명시 되면 각 채널의 음성을 각각 받아쓰기 합니다.
    - `speakerDiarization` object: 화자 분리를 위한 설정입니다. 오디오에 나타나는 화자들을 구분하여 받아쓰기를 합니다. 명시하지 않을 경우 비활성화 됩니다.
      - `enable` boolean: 화자 분리를 활성화 하기 위해서는 반드시 `true`로 설정해야 합니다.
      - `speakerCountHint` integer: 화자가 몇 명인지에 대한 힌트를 설정합니다. 화자 분리 성능이 개선될 수 있습니다.
  - `nlpConfig` object: 자연어 처리 설정을 위한 객체 입니다.
    - `keywordExtraction` object: 키워드 추출 설정을 위한 객체입니다. 이 설정을 사용하면 텍스트에서 키워드를 추룰합니다.
      - `enable` boolean: 키워드 추출을 활성화 하기 위해서는 반드시 `true`로 설정해야 합니다.
      - `maxCount` integer: 추출 할 키워드의 최대 개수 입니다. 값이 클 경우 속도에 영향을 줄 수 있습니다. 키워드가 많지 않을 경우 명시된 수 보다 적은 수의 키워드를 추출 할 수 있습니다.
    - `sentimentAnalysis` object: 텍스트 감정분석 설정을 위한 객체입니다. 이 설정을 사용하면 텍스트를 분석하여 전반적인 감정을 반환합니다.
      - `enable` boolean: 텍스트 감정 분석을 활성화 하기 위해서는 반드시 `true`로 설정해야 합니다.
  - `callback` object: 비동기 요청의 진행 상태 및 결과를 콜백으로 전달 받고 싶을 때 사용합니다.
    - `url` string: 콜백을 전송받을 http(s) 를 포함한 URL 입니다. 처리 중에는 진행상태를, 처리가 완료 된 뒤에는 결과 혹은 오류 상태를 `POST` 방식으로 해당 URL에 전송합니다.
    - `headers` object: 콜백 URL로 전송할 때, 헤더에 포함시켜야 하는 값이 있다면 명시해줍니다.
  - `callbackUrl` string: **[🚫 DEPRECATED]** 콜백을 사용하기 위해서는 `callback` 필드를 참조하여 주시기 바랍니다. 받아쓰기 진행상태 및 결과를 전송받을 http(s) 를 포함한 URL 입니다. 받아쓰기가 진행 중에는 진행상태를, 받아쓰기가 완료 된 뒤에는 받아쓰기 결과를 POST 방식으로 해당 URL에 전송합니다. CallbackUrl로 요청되는 request body는 SttAsyncInitResponse와 동일합니다.
  - `custom` object: 응답에 포함하여 받고 싶은 사용자 객체를 명시합니다. 사용자가 요청에 custom 객체를 명시한 경우 동일한 값이 응답에 명시되어 반환됩니다. 요청을 자동화 하여 보낼 때 유용합니다.

## Response `200`

Example response

- object
  - `rid` string: 요청 ID 입니다.
  - `fileName` string: 파일 이름입니다.
  - `custom` object: 응답에 포함하여 받고 싶은 사용자 객체를 명시합니다. 사용자가 요청에 custom 객체를 명시한 경우 동일한 값이 응답에 명시되어 반환됩니다. 요청을 자동화 하여 보낼 때 유용합니다.

## Other responses

- `204`: No Content. 요청은 성공하였으나 반환한 결과가 없습니다. 받아쓰기의 경우 받아쓰기는 완료되었으나 결과가 비어있습니다.
- `400`: Bad Request. 요청 형식이 잘못 되었습니다.
- `401`: Unauthorized.
- `403`: Forbidden. 허용되지 않은 접근입니다.
- `413`: Payload Too Large. 요청이 너무 큽니다.
- `415`: Unsupported Media Type.
- `429`: Too Many Requests.
- `500`: Internal Server Error. 서버 오류입니다.
- `503`: 너무 많은 요청을 처리하고 있어 일시적으로 응답이 불가능한 상태입니다. 잠시 후 다시 시도해주세요.

---

[API](https://skmtc.dev/daglo/apis/cloud-api.md) - [All operations](https://skmtc.dev/daglo/apis/cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/daglo/apis/cloud-api/revisions/cf504ab299ce?raw)