docs: guía de autoservicio TTS para Inma/Mixbot (#222) #223

Merged
rafa merged 4 commits from docs/tts-audio-inma-222 into main 2026-08-31 11:39:04 +00:00
Showing only changes of commit 2f207a5515 - Show all commits
@@ -168,6 +168,22 @@ Un HTTP 200 **no significa que haya audio** — hay que mirar siempre el `base_r
cuerpo. Ante cualquiera de estos dos códigos: **parad y reintentad más tarde**, no
machaquéis la API en bucle esperando que cambie.
**Cómo comprobar la cuota disponible antes de lanzar una tanda** (importante si vais a
procesar el backlog histórico del #188 además de la carta semanal, para repartir bien las
ventanas de 5h):
```bash
curl -s https://api.minimax.io/v1/token_plan/remains \
-H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json"
```
Buscad en `model_remains` la entrada cuyo `model_name` sea el modelo que vayáis a usar
(`speech-2.8-hd`/`speech-2.8-turbo`). Cada entrada trae
`current_interval_remaining_percent` (lo que queda de la ventana de 5h, y `end_time` de
cuándo se resetea) y `current_weekly_remaining_percent`/`weekly_end_time` (la ventana
semanal). Con eso podéis calcular cuántos audios caben antes de la próxima ventana y
programar el resto para la siguiente, en vez de descubrirlo con un `2056` a mitad de tanda.
## 5. Acabado del audio (opcional pero es lo que suena en producción)
El pipeline actual aplica dos retoques más al mp3 antes de darlo por bueno — no son