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

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

La tua chiave API VoiceCheap.

**projectId** `string` *required*

Identificatore del progetto restituito da [Crea progetto](https://api-docs.voicecheap.ai/docs/it/api-reference/create-project.md) o [Avvia traduzione](https://api-docs.voicecheap.ai/docs/it/api-reference/translate.md).

**source** `string` *required*

`original` o `translated`.

**targetLanguage** `string`

Obbligatorio quando `source` è `translated`. Utilizza il nome della lingua di destinazione memorizzato nel progetto, come `french`.

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

`json`, `srt` o `vtt`.

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

Includi etichette visibili del parlante in SRT o VTT. Il formato JSON include sempre i numeri dei parlanti.

## 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](https://api-docs.voicecheap.ai/docs/it/api-reference/transcribe.md). Le trascrizioni del progetto memorizzate includono timestamp dei segmenti, parlanti, lingua, dati di confidenza quando disponibili e un `workId` per l'output tradotto.

## Ritmo dei segmenti tradotti

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

Solo trascrizioni tradotte, dopo che è stata generata una voce per il segmento. Rapporto tra la durata del parlato generato e la finestra del segmento, misurato prima dell'adattamento finale del tempo e arrotondato a tre decimali. `1` significa che il parlato entra in modo naturale; valori sopra circa `1.3` indicano che l'audio ha dovuto essere accelerato in modo evidente, valori sotto `0.9` che è stato rallentato.

Usalo per regolare un'[esecuzione solo doppiaggio](https://api-docs.voicecheap.ai/docs/it/api-reference/translate.md#dub-only-mode-bring-your-own-translation): esporta la trascrizione tradotta in JSON, accorcia i cue il cui `finalSpeedFactor` è troppo alto e invia l'SRT rivisto a [Doppiaggio del progetto](https://api-docs.voicecheap.ai/docs/it/api-reference/dub-project.md). Il valore riflette l'ultima voce generata per il segmento e viene quindi aggiornato a ogni esecuzione.

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


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