Errores

`rate_limited`

HTTP HTTP 429.

Estado HTTP: 429
Tipo del problema: https://docs.filmo.io/errors/rate_limited

{
  "type": "https://docs.filmo.io/errors/rate_limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limit exceeded: retry in 30 seconds",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "retryAfter": 30
}

Cuándo ocurre

429. La clave envió más de 120 peticiones en el minuto actual o, en las tres consultas de disponibilidad, más de 30 en el minuto actual. La respuesta lleva Retry-After, en segundos (el cuerpo del problema lo repite en retryAfter), y las cabeceras RateLimit-* indican qué cuota se agotó. Un 401 y un insufficient_scope no consumen cuota; cualquier otra respuesta de una clave autenticada sí. Decide ante cualquier 429 por Retry-After, no por el cuerpo.

Qué hacer

Espera el número de segundos indicado en Retry-After y vuelve a enviar. Para mantenerte por debajo del límite, reparte las peticiones a lo largo del minuto, pagina con el limit más grande que puedas usar y no consultes una lista más a menudo de lo necesario.

Reintento

Esperar `Retry-After` y reintentar429 rate_limited
Espera los segundos de Retry-After y reintenta con la misma clave.

Campos de errors[]

retryAfterinteger

En rate_limited: segundos que hay que esperar antes de reintentar, el mismo valor que la cabecera Retry-After.

Lo devuelven

rate_limited los puede devolver cualquier operación.

Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

¿Te ha resultado útil esta página?

Ejemplo