# API de Extract.FAST

Crea flujos de extracción de archivos con la misma forma de trabajo individual que usan las API de Tools.FAST: estima créditos, envía un archivo con sus opciones, consulta el estado del trabajo y descarga el resultado.

## URL base

`https://api.tools.fast/extract`

## Forma de la API pública

- `POST /estimate/{sourceFileExtension}` estima un archivo y un JSON de opciones sin subir el archivo.
- `POST /extract` envía un trabajo de extracción y puede incluir transcripción como complemento con coste para archivos de audio y video.
- `POST /transcribe` envía un trabajo solo de transcripción para audio o video.
- `GET /job/{id}` consulta el estado.
- `GET /job/{id}/download` descarga el ZIP terminado.
- `POST /job/{id}/cancel` cancela trabajos en cola o en ejecución cuando es posible.
- `DELETE /job/{id}` elimina el registro del trabajo y los artefactos guardados cuando está permitido.
- `GET /entitlements/me` devuelve los créditos utilizables y los límites del plan de quien llama.

## Qué devuelve Extract

Los resultados de extracción se descargan como un ZIP. Según el formato de origen y las opciones elegidas, el ZIP puede contener imágenes, texto, Markdown, páginas PDF, diapositivas renderizadas, hojas de cálculo, pistas de audio, fotogramas de video, subtítulos, metadatos, transcripciones y un resumen de archivos.

## Versionado

El contrato público actual se considera `v1` por convención. Pueden añadirse nuevos campos de respuesta sin cambiar de versión. Los campos existentes, los códigos de error estables y el significado de las rutas se tratan como compromisos de compatibilidad.