Referencia API
Errores
Todos los errores devuelven JSON con un mensaje y un código estable para manejarlos en tu código.
Forma del error
{
"error": "API key inválida o revocada",
"code": "invalid_key"
}Programá contra code (estable), no contra error (texto, puede cambiar).
Códigos
| HTTP | code | Cuándo |
|---|---|---|
| 400 | no_text | Falta el campo text o está vacío. |
| 400 | text_too_long | El texto supera los 5000 caracteres. |
| 400 | bad_json | El body no es JSON válido. |
| 400 | consent_required | Clonación sin "consent": true. |
| 401 | no_key | No mandaste API key. |
| 401 | invalid_key | La key es inválida o fue revocada. |
| 403 | plan_required | Tu plan no es Pro. |
| 429 | rate_limited | Más de 30 requests/minuto por key. |
| 429 | credits_exhausted | Agotaste los caracteres del mes. |
| 500 | auth_error | Error validando la key (transitorio). |
| 500 | generation_error | Falló la generación del audio. |