> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcrever Mídia

> Transcreva um arquivo de áudio ou vídeo como JSON, SRT ou VTT completo

# Transcrever Mídia

Envie um arquivo de áudio ou vídeo e receba sua transcrição diretamente. Este endpoint independente não cria um projeto de dublagem.

O endpoint aceita arquivos de até **200 MB** e **2 horas**. Ele usa as mesmas regras de acesso de chave de API que a API de tradução.
Solicitações bem-sucedidas retornam HTTP `200`.

A transcrição avulsa também compartilha a cota diária de geração da ferramenta de transcrição autenticada. Chamadas mensais ilimitadas à API não concedem gerações de transcrição ilimitadas.

## Solicitação

Envie `multipart/form-data` com os seguintes campos.

**x-api-key** `string` *required*

Sua chave de API VoiceCheap.

**file** `file` *required*

O arquivo de áudio ou vídeo a ser transcrito. Os formatos suportados incluem MP4, MOV, MKV, WebM, MPEG, MP3, WAV, M4A, FLAC, OGG e AAC.

**outputFormat** `string` (default: json)

Formato de resposta: `json`, `srt` ou `vtt`.

**originalLanguage** `string` (default: auto-detect)

Código ISO do idioma de origem suportado. Deixe como `auto-detect` a menos que você saiba o idioma de origem. Idiomas explícitos não suportados
retornam um erro de validação antes do início do processamento.

**numberOfSpeakers** `string` (default: auto-detect)

`auto-detect` ou um número inteiro de `1` a `32`.

**brandVocabulary** `string`

Uma matriz de strings JSON de nomes, marcas, acrônimos ou termos de domínio a serem reconhecidos. Os termos da solicitação são mesclados com o glossário da conta ou da equipe salvo.

```json theme={null}
["VoiceCheap", "SmartSync", "ITC Global"]
```

**removeFillerWords** `boolean` (default: true)

Remova palavras de preenchimento comuns da transcrição.

**includeSpeakerLabels** `boolean` (default: false)

Prefixe as indicações de SRT com `Speaker N:` ou adicione tags de voz VTT. O JSON sempre inclui o locutor numérico em cada segmento e palavra.

## Resposta JSON

JSON é a saída mais completa. Ele contém o texto completo, confiança do idioma, duração da mídia, locutores, segmentos com carimbo de data/hora e palavras com carimbo de data/hora.

```json theme={null}
{
  "source": "standalone",
  "language": "en",
  "languageConfidence": 0.99,
  "duration": 12.4,
  "text": "Welcome to VoiceCheap.",
  "speakers": [{ "id": 0, "label": "Speaker 1" }],
  "segments": [
    {
      "index": 0,
      "text": "Welcome to VoiceCheap.",
      "begin": 0.18,
      "end": 1.74,
      "duration": 1.56,
      "speaker": 0,
      "language": "en",
      "confidence": 0.94,
      "words": [
        {
          "index": 0,
          "text": "Welcome",
          "speaker": 0,
          "confidence": 0.96,
          "begin": 0.18,
          "end": 0.62,
          "duration": 0.44
        }
      ]
    }
  ],
  "words": [
    {
      "index": 0,
      "text": "Welcome",
      "speaker": 0,
      "confidence": 0.96,
      "begin": 0.18,
      "end": 0.62,
      "duration": 0.44
    }
  ]
}
```

## Exemplos

```bash cURL — JSON theme={null}
curl -X POST "https://api.voicecheap.ai/v1/transcribe" \
  -H "x-api-key: vc_your-api-key" \
  -F "file=@interview.mp4" \
  -F "outputFormat=json" \
  -F "numberOfSpeakers=2" \
  -F 'brandVocabulary=["VoiceCheap","SmartSync"]'
```

```bash cURL — SRT theme={null}
curl -X POST "https://api.voicecheap.ai/v1/transcribe" \
  -H "x-api-key: vc_your-api-key" \
  -F "file=@interview.mp4" \
  -F "outputFormat=srt" \
  -F "includeSpeakerLabels=true" \
  --output interview.srt
```

```bash cURL — VTT theme={null}
curl -X POST "https://api.voicecheap.ai/v1/transcribe" \
  -H "x-api-key: vc_your-api-key" \
  -F "file=@interview.mp4" \
  -F "outputFormat=vtt" \
  --output interview.vtt
```

## Erros

| Status | Código | Descrição |
| - | - | - |
| 400 | `FILE_REQUIRED` | Nenhum arquivo foi enviado |
| 400 | `INVALID_FILE_TYPE` | O tipo de arquivo não é suportado |
| 400 | `INVALID_MEDIA_STREAM` | O arquivo não possui fluxo de áudio |
| 400 | `DURATION_DETECTION_FAILED` | A duração da mídia não pôde ser lida |
| 400 | `DURATION_TOO_LONG` | A mídia tem mais de duas horas |
| 400 | `INVALID_BRAND_VOCABULARY` | Uma ou mais entradas do glossário são inválidas |
| 400 | `INVALID_BOOLEAN_VALUE` | Um booleano multipart não é `true` ou `false` |
| 400 | `INVALID_JSON_FORMAT` | Um campo multipart codificado em JSON está malformado |
| 400 | `INVALID_MULTIPART_REQUEST` | Os dados do formulário multipart estão malformados ou são muito grandes |
| 413 | `FILE_TOO_LARGE` | O arquivo excede 200 MB |
| 502 | `TRANSCRIPTION_EMPTY` | A transcrição não retornou fala utilizável |
| 502 | `TRANSCRIPTION_FAILED` | O mecanismo de transcrição não pôde terminar |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.