---
title: "Criar transcrição de um áudio ou vídeo"
method: POST
path: "/conversify/api/v1/speech/diarization"
---

# Criar transcrição de um áudio ou vídeo

`POST /conversify/api/v1/speech/diarization`

## Request

- Base URL: `https://apigw.nuvidio.com`
- URL: `https://apigw.nuvidio.com/conversify/api/v1/speech/diarization`
- Auth: OAuth 2

Além da transcrição, também é realizado o processo de diarização, que é um termo específico em processamento de áudio e refere-se ao processo de identificar e separar as vozes de diferentes pessoas em um áudio ou vídeo. Atualmente a separação ocorre entre atendente (attendant) ou cliente (customer).

## Headers

- `content-type` string, required

## Request body

- object
  - `file_url` string: URL para download do vídeo ou áudio que deseja gerar a diarização. Escolha entre file_url ou media_file.
  - `on_success` string, required: URL que irá receber o diálogo.
  - `on_error` string, required: URL que receberá as informações de erro caso ocorra algum problema no processamento da diarização.
  - `media_file` string, binary: Arquivo de vídeo ou áudio. Escolha entre file_url ou media_file.
  - `callback_token` string: Caso os endpoints de retorno (on_succes e on_error) precisem de autenticação, informe nesse campo o prefixo (Bearer, Basic, etc) se houver e token . O valor informado será preenchido na key "Authorization" nos headers da requisição.
  - `monologue` boolean: Se for passado como true, o retorno da transcrição será mais rápido, pois não será realizado o processo de diarização, tendo em vista que só existe um falante na mídia.
  - `disable_audio_segmentation` boolean: Por padrão, o sistema tentará realizar a separação dos áudios para, posteriormente, efetuar a transcrição. Esse processo torna o retorno mais lento, porém mais preciso.

## Response `201`

201

- object
  - `diarizationId` string

## Other responses

- `400`: 400
- `403`: 403
- `413`: 413
- `500`: 500

---

[API](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2.md) - [All operations](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2/revisions/c488e657f07b?raw)