---
title: "Get long audio transcription"
method: GET
path: "/stt/v1/async/transcripts/{rid}"
tags: ["STT", "Async"]
---

# Get long audio transcription

`GET /stt/v1/async/transcripts/{rid}`

## 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/{rid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/daglo/apis/cloud-api/docs/stt/v1/async/transcripts/:rid/get.ts> (a function with typed inputs; its response is checked against the schema)

비동기화 방식으로 요청한 받아쓰기의 진행상황 및 결과를 확인합니다.

## Response `200`

Example response

- object
  - `rid` string: 요청 ID 입니다.
  - `status` 'ai_requested' | 'uploaded' | 'file_processing' | 'transcribing' | 'post_processing' | 'transcribed' | 'input_error' | 'transcript_error' | 'file_error': 받아쓰기 요청의 상태값 입니다. `ai_requested`: 요청이 시작되었습니다. `uploaded`: 파일 업로드가 완료되었습니다. `file_processing`: 파일을 전처리 중 입니다. `transcribing`: 받아쓰기 중 입니다. `post_processing`: 후처리 중 입니다. `transcribed`: 받아쓰기가 완료되었습니다. `input_error`: 사용자 요청 값에 오류가 있습니다. 확인 후 다시 요청해 주세요. `transcript_error`: 받아쓰기 중 오류가 발생하였습니다. 잠시 기다렸다가 다시 요청해 주세요. `file_error`: 파일에 오류가 있습니다. 파일 확인 후 다시 요청해 주세요.
  - `progress` integer: 받아쓰기 처리중인 경우 현재 진행률을 나타냅니다.
  - `sttResults` object[]
    - `transcript` string, required: 받아쓰기 결과의 전체 텍스트 입니다.
    - `words` object[]: 각 단어별 받아쓰기 결과를 나타냅니다.
      - `word` string: 받아쓰기 한 단어 입니다.
      - `startTime` object: 해당 단어가 음성파일에서 시작한 시간입니다.
        - `seconds` string: 초.
        - `nanos` integer: 나노초.
      - `endTime` object: 해당 단어가 음성파일에서 끝난 시간입니다.
        - `seconds` string: 초.
        - `nanos` integer: 나노초.
      - `hasKeyword` boolean: 해당 단어가 키워드 추출에 의해 선택 된 키워드 인지를 나타냅니다.
      - `speaker` string: 화자 ID 입니다.
    - `keywords` string[]: (Optional) 음성 내용을 바탕으로 추출된 주요 키워드의 목록입니다. **STT 요청시, 키워드 추출을 기능을 활성화한 경우에만 응답 본문에 포함됩니다.** 키워드 추출을 활성화했지만 키워드가 추출되지 않을 경우 빈 리스트를 반환합니다.
  - `message` string: 오류 메시지 등의 추가정보를 표시합니다.
  - `custom` object: 응답에 포함하여 받고 싶은 사용자 객체를 명시합니다. 사용자가 요청에 custom 객체를 명시한 경우 동일한 값이 응답에 명시되어 반환됩니다. 요청을 자동화 하여 보낼 때 유용합니다.

## Other responses

- `204`: No Content. 요청은 성공하였으나 반환한 결과가 없습니다. 받아쓰기의 경우 받아쓰기는 완료되었으나 결과가 비어있습니다.
- `401`: Unauthorized.
- `403`: Forbidden. 허용되지 않은 접근입니다.
- `404`: Not Found.
- `429`: Too Many Requests.
- `500`: Internal Server Error. 서버 오류입니다.

---

[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)