docs: añadir lectura de cuota MiniMax a la guía de audio

Rafa confirmó que el backlog historico del #188 se queda con Inma/Mixbot
(su equipo está 24/7, aprovecha mejor las ventanas de 5h de MiniMax) y
pidió documentarles cómo leer la cuota antes de lanzar tandas grandes.
This commit is contained in:
2026-08-31 07:38:52 -04:00
parent 8b016844d9
commit 2f207a5515
@@ -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 cuerpo. Ante cualquiera de estos dos códigos: **parad y reintentad más tarde**, no
machaquéis la API en bucle esperando que cambie. 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) ## 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 El pipeline actual aplica dos retoques más al mp3 antes de darlo por bueno — no son