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

# Esporta trascrizione del progetto

> Recupera una trascrizione del progetto originale o tradotta come JSON, SRT o VTT

# Esporta trascrizione del progetto

Recupera una trascrizione da un progetto VoiceCheap esistente senza utilizzare endpoint dell'applicazione web interna. L'endpoint supporta la trascrizione sorgente e ogni trascrizione in lingua di destinazione disponibile.
Le richieste riuscite restituiscono HTTP `200`.

## Richiesta

<ParamField header="x-api-key" type="string" required>
  La tua chiave API VoiceCheap.
</ParamField>

<ParamField path="projectId" type="string" required>
  Identificatore del progetto restituito da [Crea progetto](/docs/it/api-reference/create-project) o [Avvia traduzione](/docs/it/api-reference/translate).
</ParamField>

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

<ParamField body="targetLanguage" type="string">
  Obbligatorio quando `source` è `translated`. Utilizza il nome della lingua di destinazione memorizzato nel progetto, come `french`.
</ParamField>

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

<ParamField body="includeSpeakerLabels" type="boolean" default="false">
  Includi etichette visibili del parlante in SRT o VTT. Il formato JSON include sempre i numeri dei parlanti.
</ParamField>

## Esempi

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

La risposta JSON utilizza la stessa struttura di trascrizione normalizzata documentata in [Trascrivi file multimediale](/docs/it/api-reference/transcribe). Le trascrizioni del progetto memorizzate includono timestamp dei segmenti, parlanti, lingua, dati di confidenza quando disponibili e un `workId` per l'output tradotto.

## Errori

| Stato | Codice                     | Descrizione                                                |
| ----- | -------------------------- | ---------------------------------------------------------- |
| 400   | `TARGET_LANGUAGE_REQUIRED` | È stato richiesto l'output tradotto senza una lingua       |
| 401   | `INVALID_API_KEY`          | La chiave API manca o non è valida                         |
| 403   | `FORBIDDEN`                | La chiave API non può accedere a questo progetto           |
| 404   | `PROJECT_NOT_FOUND`        | Il progetto non esiste                                     |
| 404   | `TRANSCRIPT_NOT_FOUND`     | La trascrizione sorgente o tradotta richiesta è assente    |
| 409   | `TRANSCRIPT_NOT_READY`     | La trascrizione richiesta è ancora in fase di elaborazione |