---
title: "Transcribe short audio"
method: POST
path: "/stt/v1/sync/transcripts"
tags: ["STT", "Sync"]
---

# Transcribe short audio

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

짧은 오디오를 텍스트로 변환합니다. 동기화 방식이 사용됩니다.

## Request body

- object
  - `file` string, binary, required: 받아쓰기를 요청할 파일입니다. 파일의 재생 시간이 30초를 초과할 수 없습니다.
  - `sttConfig` object: 동기 방식의 STT 요청에 대한 설정입니다.
    - `model` 'general': 받아쓰기에 사용할 모델 이름입니다. 명시하지 않을 경우 general 이 사용됩니다. 사용 가능한 모델은 다음과 같습니다. |**모델**|**설명**| |:---:|:---:| |`general`|일반적인 경우에 사용되는 모델입니다.|
    - `keywordBoost` object: 키워드 부스트를 위한 설정입니다. 키워드 부스트를 활성화 하면 받아쓰기 결과에서 명시된 키워드들의 인식 확률이 향상됩니다.
      - `enable` boolean: 키워드 부스트를 활성화 하기 위해서는 반드시 `true`로 설정해야 합니다.
      - `keywords` string[]: 강조할 키워드를 명시합니다. string의 배열 형태입니다. 명시하지 않을 경우 키워드 부스트가 비활성화 됩니다.
      - `boost` integer: 키워드 부스트 정도를 설정합니다. 높을 수록 더 높은 확률로 키워드를 인식합니다. 1 ~ 15 사이의 정수값입니다. 명시하지 않으면 5 입니다.
  - `custom` object: 응답에 포함하여 받고 싶은 사용자 객체를 명시합니다. 사용자가 요청에 custom 객체를 명시한 경우 동일한 값이 응답에 명시되어 반환됩니다. 요청을 자동화 하여 보낼 때 유용합니다.
  - `fileName` string: 파일 이름입니다.

## Response `200`

Example response

- object
  - `sttResult` object
    - `transcript` string: 받아쓰기 결과 전체 Text.
  - `audioDuration` number, float: 초.
  - `elapsedTime` integer: 밀리초.
  - `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`: Service Unavailable.

---

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