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

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

<ParamField path="projectId" type="string" required>
  Identificador de proyecto devuelto por [Crear proyecto](/docs/es/api-reference/create-project) o [Iniciar traducción](/docs/es/api-reference/translate).
</ParamField>

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

<ParamField body="targetLanguage" type="string">
  Requerido cuando `source` es `translated`. Utilice el nombre del idioma de destino almacenado en el proyecto, como `french`.
</ParamField>

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

<ParamField body="includeSpeakerLabels" type="boolean" default="false">
  Incluya etiquetas de hablante visibles en SRT o VTT. JSON siempre incluye números de hablante.
</ParamField>

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

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