Genera una clave de API
Crea una clave para que otro programa lea o cambie tus datos de Filmo, elige qué puede hacer y guárdala a salvo.
Administradores de la cuenta: los roles «Superadministrador», «Administrador» y «Propietario». El resto de personas no ven «API y MCP» en Configuración.
Una clave de API es un código secreto largo que permite a otro programa, o a una herramienta como Make, n8n o Zapier, leer y cambiar tus datos de Filmo sin que nadie inicie sesión. Cada clave lleva permisos que dicen con exactitud qué puede hacer.
Antes de empezar
- Decide para qué sirve la clave y da una clave a cada herramienta, así podrás apagar una sin afectar a las demás.
- Averigua qué datos necesita. Elegirás sus permisos al crearla y no podrás cambiarlos después.
- La API está incluida en cualquier plan de pago; no es un módulo aparte. También puedes probarla durante la prueba gratuita.
- Ten a mano un gestor de contraseñas para guardarla: Filmo la muestra una sola vez.
Crea la clave
- Abre «API y MCP» en Configuración. Desde el menú de tu usuario en la barra lateral entra en Configuración y elige «API y MCP», en «Configuración de la plataforma». Abre la pestaña «Claves de API».
- Elige «Crear clave de API».
- Escribe un «Nombre». Que diga qué usará la clave, por ejemplo “Sincronización con contabilidad”. Admite hasta 80 caracteres.
- Marca sus «Permisos (scopes)». Ninguno viene marcado: marca solo los que necesite la integración, y al menos uno. Añade «account:read» para que la clave pueda identificarse. Consulta Permisos de la API (scopes).
- Si quieres, pon una «Fecha de expiración». La clave deja de servir al final de ese día, en tu zona horaria. Sin fecha, funciona hasta que la revoques.
- Elige «Crear».
- Copia la clave y guárdala a salvo. Usa «Copiar» y guárdala en un gestor de contraseñas. Filmo la muestra solo esta vez. Después elige «He guardado la clave».
Trata la clave como una contraseña
Quien tenga la clave puede leer y cambiar tus datos con sus permisos. No la envíes nunca por correo ni por chat, y no la pegues en un documento que pueda abrir otra gente. Si crees que se ha filtrado, revócala enseguida.
Entrégala a quien construye la integración
La integración envía la clave en la cabecera Authorization de cada petición. Una buena primera prueba, que solo lee los ajustes básicos de la cuenta, es:
curl https://app.filmo.io/api/v1/account \ -H "Authorization: Bearer $FILMO_API_KEY"
La guía paso a paso para desarrolladores, con ejemplos en muchos lenguajes, es el inicio rápido; antes de usar datos reales, lee la lista de salida a producción.
Gestiona tus claves
La pestaña «Claves de API» lista todas las credenciales de la cuenta: las claves que creas y los asistentes de IA conectados, de la más reciente a la más antigua. Cada fila muestra el nombre, el estado («Activa», «Expirada» o «Revocada»), el principio de la clave (fk_live_…), cuándo se usó por última vez, cuándo expira y sus permisos. Elige una fila para ver los detalles.
Sustituye una clave
Una clave no se puede editar ni renovar. Para cambiar sus permisos, o para sustituir una clave que se ha filtrado, crea una nueva, dásela a la herramienta, comprueba que funciona y revoca después la antigua.
Revoca una clave
- Abre el menú «⋯» de la clave y elige «Revocar». El mismo botón está en los detalles de la clave, en «Zona de peligro».
- Confirma. Todo lo que use la clave deja de funcionar al instante, y no se puede deshacer. La clave sigue en la lista, marcada como «Revocada».
Una clave sigue al administrador que la creó
La clave actúa con la identidad del administrador que la creó, y los cambios que hace se guardan a su nombre. El historial de actividad indica además que llegaron por la API, con el nombre de la clave. Si esa persona deja la cuenta, se desactiva o deja de ser administradora, la clave deja de funcionar y la herramienta recibe un error de “propietario de la clave”. Crea una clave nueva desde una cuenta que siga siendo administradora. Consulta Roles y permisos.
Los cambios por la API pueden lanzar tus workflows
Un cambio hecho por la API se trata como uno hecho en la aplicación: puede lanzar los workflows de tu cuenta que escuchen ese evento. No se puede desactivar para una sola petición. Antes de conectar una herramienta que escribe, revisa qué workflows están activos.
Si la primera llamada falla
| Qué indica la herramienta | Qué significa | Qué hacer |
|---|---|---|
| La clave no es válida, ha sido revocada o ha expirado | La clave se copió incompleta, o se revocó o pasó su fecha de expiración | Mira el estado de la clave en la lista; crea una nueva si hace falta |
| El usuario que creó la clave ya no está activo, o ya no es administrador | Ha cambiado el propietario de la clave | Crea una clave nueva desde un administrador |
| La clave no tiene el scope requerido | A la clave le falta un permiso que necesita la llamada | Crea una clave nueva que lo incluya |
| Tu plan no incluye el add-on | La llamada necesita un módulo que tu plan no tiene | Añade el módulo a tu plan |
| Límite de peticiones alcanzado | La clave ha hecho demasiadas peticiones en un minuto | Espera y vuelve a intentarlo |
Recursos relacionados
- Elige qué puede hacer una clave: Permisos de la API (scopes).
- Cuántas peticiones puede hacer una clave: Cómo funcionan los límites de uso.
- Módulos que necesitan algunas llamadas: La página Plan y facturación.
- Mantén otro sistema al día: Reaccionar a cambios sin webhooks.
Preguntas frecuentes
No. Filmo guarda solo una huella de la clave, así que no puede mostrarla otra vez. Si la pierdes, crea una nueva y revoca la antigua.
Hasta 50 que no estén revocadas, contando las expiradas y los asistentes de IA conectados.
Todos los administradores de la cuenta ven todas sus claves, también las creadas por otros, y pueden revocarlas.
No. Esos asistentes se conectan con un enlace y tu aprobación. Consulta Conecta un asistente de IA.