---
title: Archivo de Voz API
emoji: 🎙️
colorFrom: purple
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

API FastAPI para Archivo de Voz. Configura los secretos `HF_TOKEN` y `APP_KEY`, y las variables `HF_DATASET_REPO` y `ALLOWED_ORIGINS`, en los ajustes del Space.

`HF_TOKEN` necesita acceso de escritura al dataset indicado. El cliente recibe solo `APP_KEY`; no recibe el token HF. Los endpoints de biblioteca y escritura requieren la cabecera `X-App-Key`.

- `GET /health`: modo de almacenamiento y estado de configuración.
- `GET /library`: catálogo y progreso.
- `POST /collections`: nueva carpeta.
- `POST /items/import`: lista completa o cuento por fragmentos.
- `POST /catalogs/dictionary`: catálogo español de Hunspell.
- `POST /catalogs/syllables`: catálogo inicial de sílabas.
- `POST /migration/legacy`: recuperar manifiestos de la versión anterior, una sola vez.
- `POST /recordings`: WAV multipart; cuatro tomas globales e idempotencia.

Se preservan las carpetas antiguas del dataset. Los datos nuevos usan `v1/`. Sin ambas variables de Hugging Face el servidor funciona en modo local, que es solo para desarrollo: el disco del Space no sustituye al dataset.

- `POST /test-recordings/clear`: borra únicamente audios de prueba; admite `collection` y opcionalmente `item`.
- `GET /library?collection=<id>`: progreso de producción o de prueba según la carpeta.