> ## 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 transcripción del proyecto

> Recupere una transcripción de proyecto original o traducida como JSON, SRT o VTT

# Exportar transcripción del proyecto

Recupere una transcripción de un proyecto VoiceCheap existente sin utilizar puntos finales de aplicaciones web internas. El punto final admite la transcripción de origen y cada transcripción de idioma de destino disponible.
Las solicitudes exitosas devuelven HTTP `200`.

## Solicitud

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

Su clave API de VoiceCheap.

**projectId** `string` *required*

Identificador de proyecto devuelto por [Crear proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/create-project.md) o [Iniciar traducción](https://api-docs.voicecheap.ai/docs/es/api-reference/translate.md).

**source** `string` *required*

`original` o `translated`.

**targetLanguage** `string`

Requerido cuando `source` es `translated`. Utilice el nombre del idioma de destino almacenado en el proyecto, como `french`.

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

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

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

Incluya etiquetas de hablante visibles en SRT o VTT. JSON siempre incluye números de hablante.

## Ejemplos

```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 respuesta JSON utiliza la misma estructura de transcripción normalizada documentada en [Transcribir medios](https://api-docs.voicecheap.ai/docs/es/api-reference/transcribe.md). Las transcripciones de proyectos almacenadas incluyen marcas de tiempo de segmento, hablantes, idioma, datos de confianza cuando están disponibles y un `workId` para la salida traducida.

## Ritmo de los segmentos traducidos

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

Solo transcripciones traducidas, una vez generada una voz para el segmento. Relación entre la duración del habla generada y la ventana del segmento, medida antes del ajuste final de tempo y redondeada a tres decimales. `1` significa que el habla encaja de forma natural; los valores por encima de aproximadamente `1.3` indican que el audio tuvo que acelerarse de forma notable, y los valores por debajo de `0.9` que se ralentizó.

Úselo para ajustar una [ejecución de solo doblaje](https://api-docs.voicecheap.ai/docs/es/api-reference/translate.md#dub-only-mode-bring-your-own-translation): exporte la transcripción traducida como JSON, acorte los cues cuyo `finalSpeedFactor` sea demasiado alto y envíe el SRT revisado a [Doblar el proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/dub-project.md). El valor refleja la última voz generada para el segmento, así que se actualiza en cada ejecución.

## Errores

| Estado | Código | Descripción |
| - | - | - |
| 400 | `TARGET_LANGUAGE_REQUIRED` | Se solicitó la salida traducida sin un idioma |
| 401 | `INVALID_API_KEY` | La clave API falta o no es válida |
| 403 | `FORBIDDEN` | La clave API no puede acceder a este proyecto |
| 404 | `PROJECT_NOT_FOUND` | El proyecto no existe |
| 404 | `TRANSCRIPT_NOT_FOUND` | La transcripción original o traducida solicitada no está presente |
| 409 | `TRANSCRIPT_NOT_READY` | La transcripción solicitada aún se está procesando |


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