README.md

metadata

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.