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

<ParamField header="x-api-key" type="string" required>
  Sua chave de API VoiceCheap.
</ParamField>

<ParamField path="projectId" type="string" required>
  Identificador de projeto retornado por [Criar projeto](/docs/pt/api-reference/create-project) ou [Iniciar tradução](/docs/pt/api-reference/translate).
</ParamField>

<ParamField body="source" type="string" required>
  `original` ou `translated`.
</ParamField>

<ParamField body="targetLanguage" type="string">
  Obrigatório quando `source` é `translated`. Use o nome do idioma de destino armazenado no projeto, como `french`.
</ParamField>

<ParamField body="outputFormat" type="string" default="json">
  `json`, `srt` ou `vtt`.
</ParamField>

<ParamField body="includeSpeakerLabels" type="boolean" default="false">
  Inclua rótulos de orador visíveis em SRT ou VTT. O JSON sempre inclui números de orador.
</ParamField>

## 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](/docs/pt/api-reference/transcribe). 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.

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