Errores

`internal_error`

500. Algo falló por parte de Filmo, o el almacén que cuenta el límite de peticiones no estaba disponible (la API no deja pasar la petición sin medirla). Con una Idempotency-Key, un 500 puede ocurrir después de confirmarse la escritura (no se pudo construir la respuesta); ese error se guarda entonces y se reproduce con Idempotent-Replay: true durante 24 horas, así que reenviar no escribe dos veces y tampoco se recupera. HTTP 500.

Estado HTTP: 500
Tipo del problema: https://docs.filmo.io/errors/internal_error

{
  "type": "https://docs.filmo.io/errors/internal_error",
  "title": "Internal error",
  "status": 500,
  "code": "internal_error",
  "detail": "Internal error",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

Cuándo ocurre

500. Algo falló por parte de Filmo, o el almacén que cuenta el límite de peticiones no estaba disponible (la API no deja pasar la petición sin medirla). Con una Idempotency-Key, un 500 puede ocurrir después de confirmarse la escritura (no se pudo construir la respuesta); ese error se guarda entonces y se reproduce con Idempotent-Replay: true durante 24 horas, así que reenviar no escribe dos veces y tampoco se recupera.

Qué hacer

Anota el requestId (es también la cabecera X-Request-Id). Si la petición era una escritura, lee el recurso para ver en qué estado está antes de hacer nada más. Si la misma petición sigue fallando, contacta con el soporte indicando el requestId.

Reintento

Parar500 internal_error · Idempotency-Key: Sí · Idempotent-Replay: true
Para. El fallo ocurrió después del commit y se guarda y se repite durante 24 h con esa clave: lee el recurso para ver dónde quedó.
Reintentar con espera exponencial500 internal_error · Idempotency-Key: Sí
Reintenta con espera exponencial y la misma clave.
Leer antes el recurso500 internal_error · Idempotency-Key: No
Lee antes de reintentar una escritura: sin clave nada te protege de un duplicado.

Lo devuelven

internal_error 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

Cuándo ocurre

Qué hacer

Reintento

Lo devuelven

Por MCP