Por defecto, cada generación de contenido en Fexa AI se ejecuta sobre la infraestructura de IA de la plataforma y consume tus créditos. Pero si gestionas grandes volúmenes o ya tienes una cuenta con un proveedor de IA, puedes conectar tu propia clave API. Ese es el principio del BYOK (Bring Your Own Key — «trae tu propia clave»).
BYOK en una frase: con el plan Agency, introduces tu clave API de Gemini u OpenAI y la generación se ejecuta en tu cuenta de IA — por lo que no descuenta créditos de Fexa AI.
¿Para qué sirve el BYOK?
El BYOK responde a una necesidad concreta: desacoplar el coste de la IA de tu suscripción a Fexa AI.
- Dejas de consumir los créditos de la plataforma. Cuando tu clave está activa, cada optimización la factura directamente tu proveedor (Google u OpenAI), no Fexa AI.
- Mantienes el control de tu proveedor. Eliges el modelo exacto a utilizar entre los que ofrece tu proveedor.
- Ideal para catálogos muy grandes. Si optimizas miles de páginas, usar tu propia cuota de IA puede resultar más económico que una cantidad equivalente de créditos.
El resto de Fexa AI no cambia: el mismo motor de anclaje al catálogo, los mismos prompts alimentados con tus datos reales de PrestaShop (características, variantes, marca, palabras clave de Search Console), la misma calidad de salida, todo con la voz de tu marca. El BYOK cambia solo qué clave ejecuta la llamada y cómo se factura.
¿Qué planes desbloquean el BYOK?
El BYOK es una función reservada al plan Agency (Empresa).
| Plan | Créditos / mes | BYOK (clave de IA dedicada) |
|---|---|---|
| Starter — 39 €/mes | 1500 | No |
| Growth — 99 €/mes | 5000 | No |
| Agency — 299 €/mes | 20 000 | Sí |
En los planes Starter y Growth, la sección BYOK aparece pero permanece bloqueada: un recuadro te invita a pasar a Agency. La restricción también se aplica del lado del servidor: guardar una clave sin el plan Agency devuelve un error. Y si bajas a un plan inferior, la clave deja de aplicarse automáticamente — la generación vuelve entonces a la IA de la plataforma y consume créditos de nuevo.
Nota: la facturación anual reduce el precio (el descuento depende del plan). El BYOK sigue ligado al plan Agency, sea cual sea la frecuencia de facturación.
¿Qué proveedores son compatibles?
Se ofrecen dos proveedores en BYOK:
- Google Gemini — tu clave de Google AI;
- OpenAI — tu clave de OpenAI (modelos GPT).
Anthropic (Claude) no se ofrece en BYOK. El selector de proveedor solo muestra Gemini y OpenAI. Si quieres la calidad de Gemini sin gestionar una clave, ten en cuenta que está incluida en tu suscripción (no necesitas clave) — consulta Configuración inicial.
Configura tu clave API paso a paso
Todo ocurre en las preferencias de tu tienda.
- Abre Settings desde el menú lateral.
- Ve a la sección Preferencias (elección del modelo de IA y clave personal).
- Localiza el bloque «Clave API personal (BYOK)».
- Elige el proveedor en el menú desplegable: Google Gemini u OpenAI.
- Selecciona el modelo a utilizar para ese proveedor.
- Pega tu clave API en el campo correspondiente (el campo está oculto, como una contraseña).
- Haz clic en «Guardar mi clave».
Una vez guardada la clave, un banner verde confirma que está activa e indica el proveedor. La clave nunca vuelve a mostrarse en texto claro: solo aparece una versión enmascarada (••••••••). El modelo activo se puede cambiar en cualquier momento desde el desplegable que hay justo debajo.
Seleccionar un modelo que requiere clave
En el selector de modelos, los modelos de un proveedor distinto de Gemini muestran una etiqueta BYOK. Si intentas seleccionar uno de esos modelos sin haber guardado la clave correspondiente, Fexa AI te lo advierte y te devuelve al formulario BYOK. Es normal: un modelo de OpenAI solo puede ejecutarse con una clave de OpenAI válida.
¿Dónde y cómo se almacena tu clave?
La seguridad de tu clave se trata como la de un secreto sensible.
- Cifrada en reposo. Tu clave se cifra antes de guardarse en la base de datos (cifrado simétrico AES-256-GCM). Nunca se almacena en texto claro.
- Nunca se devuelve al navegador. La API nunca devuelve la clave (ni siquiera cifrada) al cliente. La interfaz solo muestra una máscara.
- Se descifra solo en el momento de la llamada. La clave se descifra únicamente del lado del servidor, justo antes de pasarla al proveedor para ejecutar la generación.
Puedes eliminar tu clave en cualquier momento mediante el botón Eliminar del banner «Clave activa». Si el modelo activo dependía de esa clave, la tienda vuelve automáticamente al modelo Gemini predeterminado de la plataforma.
¿Qué ocurre si la clave falla?
Fexa AI está diseñado para que la generación se complete igualmente, sin que tengas que vigilar tu cuenta de proveedor.
- Límite de tasa (429). Si tu proveedor devuelve un error de tasa, la pasarela de IA reintenta automáticamente con un retardo creciente antes de rendirse.
- Modelo no disponible. Si el modelo elegido ya no existe o ha sido renombrado por el proveedor, la pasarela recurre una vez al modelo Gemini estable de la plataforma en lugar de hacer fallar toda la generación.
- Clave inválida o ausente. Los errores de autenticación se muestran tal cual: si tu clave no es válida, corrígela en las preferencias.
En resumen: el BYOK es una palanca de coste, no un punto de fragilidad. La plataforma sigue siendo capaz de terminar el trabajo.
BYOK y créditos: ¿quién paga qué?
Este es el núcleo del interés del BYOK. El comportamiento depende del estado de tu clave:
| Situación | Quién ejecuta la llamada de IA | Créditos de Fexa AI descontados |
|---|---|---|
| Clave BYOK activa (Agency, proveedor coherente) | Tu cuenta de IA | Ninguno |
| Sin clave / plan sin BYOK | IA de la plataforma | Sí (1 crédito / página) |
| Clave presente pero plan rebajado | IA de la plataforma | Sí (la clave ya no se aplica) |
Como recordatorio, 1 crédito = una optimización completa (título + metas + descripciones corta/larga + ALT + FAQ + datos estructurados). Para entender bien qué cubre un crédito y cómo funcionan las cuotas y los packs booster, consulta el sistema de créditos. Y para entender cómo construye la IA cada página a partir de tu catálogo, consulta la generación con IA.
Preguntas frecuentes
¿El BYOK está incluido en todos los planes?
No. El BYOK está reservado al plan Agency. En Starter y Growth, la sección permanece bloqueada e invita a pasar a Agency.
¿Puedo usar mi clave de Claude (Anthropic)?
No. El BYOK solo acepta Google Gemini y OpenAI. Anthropic no se ofrece para el BYOK.
¿Sigo consumiendo créditos de Fexa AI con el BYOK?
No, siempre que tu clave esté activa y su proveedor coincida con el proveedor de generación. En ese caso, la optimización la factura tu proveedor de IA, no en créditos de Fexa AI.
¿Está segura mi clave?
Sí. Está cifrada en reposo (AES-256-GCM), nunca se devuelve al navegador y se descifra en el servidor solo al ejecutar una llamada. Puedes eliminarla en cualquier momento.
¿Qué ocurre si mi clave falla en mitad de un lote?
La pasarela de IA reintenta ante los límites de tasa y recurre al modelo Gemini estable de la plataforma si el modelo solicitado no está disponible, de modo que la generación pueda completarse.