> ## 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.

# Exportar transcrição do projeto

> Recupere uma transcrição de projeto original ou traduzida como JSON, SRT ou VTT

# Exportar transcrição do projeto

Recupere uma transcrição de um projeto VoiceCheap existente sem usar endpoints internos da aplicação web. O endpoint suporta a transcrição de origem e todas as transcrições de idioma de destino disponíveis.
Solicitações bem-sucedidas retornam HTTP `200`.

## Solicitação

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

Sua chave de API VoiceCheap.

**projectId** `string` *required*

Identificador de projeto retornado por [Criar projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/create-project.md) ou [Iniciar tradução](https://api-docs.voicecheap.ai/docs/pt/api-reference/translate.md).

**source** `string` *required*

`original` ou `translated`.

**targetLanguage** `string`

Obrigatório quando `source` é `translated`. Use o nome do idioma de destino armazenado no projeto, como `french`.

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

`json`, `srt` ou `vtt`.

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

Inclua rótulos de orador visíveis em SRT ou VTT. O JSON sempre inclui números de orador.

## Exemplos

```bash cURL — Original JSON theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "original",
    "outputFormat": "json"
  }'
```

```bash cURL — Translated SRT theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "translated",
    "targetLanguage": "french",
    "outputFormat": "srt",
    "includeSpeakerLabels": true
  }' \
  --output project_123-fr.srt
```

A resposta JSON usa a mesma estrutura de transcrição normalizada documentada em [Transcrever mídia](https://api-docs.voicecheap.ai/docs/pt/api-reference/transcribe.md). As transcrições de projeto armazenadas incluem carimbos de data/hora de segmento, oradores, idioma, dados de confiança quando disponíveis e um `workId` para saída traduzida.

## Ritmo dos segmentos traduzidos

**segments\[].finalSpeedFactor** `number`

Apenas transcrições traduzidas, depois que uma voz foi gerada para o segmento. Razão entre a duração da fala gerada e a janela do segmento, medida antes do ajuste final de tempo e arredondada a três casas decimais. `1` significa que a fala cabe naturalmente; valores acima de cerca de `1.3` indicam que o áudio precisou ser acelerado de forma perceptível, e valores abaixo de `0.9` que foi desacelerado.

Use-o para ajustar uma [execução só de dublagem](https://api-docs.voicecheap.ai/docs/pt/api-reference/translate.md#dub-only-mode-bring-your-own-translation): exporte a transcrição traduzida como JSON, encurte os cues cujo `finalSpeedFactor` esteja alto demais e envie o SRT revisado para [Dublar o projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/dub-project.md). O valor reflete a última voz gerada para o segmento e é atualizado a cada execução.

## Erros

| Status | Código | Descrição |
| - | - | - |
| 400 | `TARGET_LANGUAGE_REQUIRED` | A saída traduzida foi solicitada sem um idioma |
| 401 | `INVALID_API_KEY` | A chave de API está ausente ou inválida |
| 403 | `FORBIDDEN` | A chave de API não pode acessar este projeto |
| 404 | `PROJECT_NOT_FOUND` | O projeto não existe |
| 404 | `TRANSCRIPT_NOT_FOUND` | A transcrição de origem ou traduzida solicitada está ausente |
| 409 | `TRANSCRIPT_NOT_READY` | A transcrição solicitada ainda está sendo processada |


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