# Transcribir

`POST /transcribe` envía un trabajo de audio o video centrado solo en transcripción.

Requiere `X-Fast-Api-Key` de una cuenta con acceso Pro. Las claves gratuitas y otras claves que no sean Pro devuelven `403 api_key.pro_required` antes de crear el trabajo.

Usa `/transcribe` cuando la transcripción sea la salida principal. Usa `/extract` con `media.transcript` cuando quieras transcripción junto con audio extraído, fotogramas, subtítulos o metadatos en el mismo ZIP.

## Petición

```bash
curl https://api.tools.fast/extract/transcribe \
  -H "X-Fast-Api-Key: $API_KEY" \
  -F "file=@meeting.mp4" \
  -F 'options={
    "transcription": {
      "mode": "quality",
      "language": "auto",
      "includeTxt": true,
      "includePdf": true,
      "includeDocx": true,
      "includeSrt": true,
      "includeVtt": true
    }
  }'
```

## Modos

| Modo | Úsalo cuando | Precio |
| --- | --- | --- |
| `fast` | Necesitas una transcripción rápida. | Menor coste por minuto. |
| `quality` | La precisión importa más que la velocidad. | Mayor coste por minuto. |
| `meeting-intelligence` | Necesitas notas de reunión con identificación de hablantes. | Coste por minuto más alto y disponibilidad del proveedor requerida. |

## Formatos de salida

Los trabajos solo de transcripción pueden incluir texto plano, JSON, PDF, DOCX, Markdown, EPUB, SRT y VTT según las opciones seleccionadas.

## Disponibilidad del proveedor

Si un modo de transcripción seleccionado no está disponible temporalmente, la API devuelve `extract.audio_transcription.provider_not_configured` o un código de fallo específico del proveedor. Intenta de nuevo más tarde o envía el trabajo con otro modo.