*API REST › Errores*

# `api_key_invalid`

> 401. La clave de la petición no es una que la API reconozca: su prefijo, su longitud o su hash no coincide con ninguna clave. Sin propietario de la clave al que preguntar, el cuerpo llega en español salvo que envíes `Accept-Language`. HTTP 401.

Estado HTTP: `401` · Tipo del problema: `https://docs.filmo.io/errors/api_key_invalid`

## Cuándo ocurre

401. La clave de la petición no es una que la API reconozca: su prefijo, su longitud o su hash no coincide con ninguna clave. Sin propietario de la clave al que preguntar, el cuerpo llega en español salvo que envíes `Accept-Language`.

## Qué hacer

Vuelve a copiar la clave desde donde la guardaste; una clave se muestra una sola vez, al crearla. Si ya no la tienes, un administrador crea una clave nueva en los ajustes de API y MCP de la app (Ajustes → API y MCP).

## Reintento

| Condición | Qué hacer | Nota |
| --- | --- | --- |
| 401 · 402 · 403 (clave, propietario o plan) | Parar | No reintentes: reenviar la misma petición vuelve a fallar. Actúa sobre la clave, su propietario o el plan: usa una clave válida con el permiso adecuado, pide a un administrador el permiso que falta o contrata el add-on. |

## Ejemplo

*api_key_invalid*

```json
{
  "type": "https://docs.filmo.io/errors/api_key_invalid",
  "title": "Invalid API key",
  "status": 401,
  "code": "api_key_invalid",
  "detail": "The API key is not valid",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}
```

## Lo devuelven

`api_key_invalid` 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`.

---

URL canónica: https://docs.filmo.io/es/rest-api/errors/api_key_invalid  
Última actualización: 2026-10-25