Per impostazione predefinita, ogni generazione di contenuti su Fexa AI gira sull'infrastruttura IA della piattaforma e consuma i tuoi crediti. Ma se gestisci grandi volumi o hai già un account presso un fornitore di IA, puoi collegare la tua chiave API. È il principio del BYOK (Bring Your Own Key — «porta la tua chiave»).
BYOK in una frase: con il piano Agency inserisci la tua chiave API Gemini o OpenAI e la generazione viene eseguita sul tuo account IA — quindi non intacca i crediti Fexa AI.
A cosa serve il BYOK?
Il BYOK risponde a un'esigenza precisa: scollegare il costo dell'IA dal tuo abbonamento Fexa AI.
- Non consumi più i crediti della piattaforma. Quando la tua chiave è attiva, ogni ottimizzazione viene fatturata direttamente dal tuo fornitore (Google o OpenAI), non da Fexa AI.
- Mantieni il controllo del tuo fornitore. Scegli il modello esatto da utilizzare tra quelli offerti dal tuo fornitore.
- Ideale per cataloghi molto ampi. Se ottimizzi migliaia di pagine, usare la tua quota IA può risultare più conveniente di una quantità equivalente di crediti.
Il resto di Fexa AI non cambia: lo stesso motore di ancoraggio al catalogo, gli stessi prompt alimentati dai tuoi dati reali di PrestaShop (caratteristiche, varianti, marca, parole chiave di Search Console), la stessa qualità in uscita, il tutto nella voce del tuo marchio. Il BYOK cambia solo quale chiave esegue la chiamata e come viene fatturata.
Quali piani sbloccano il BYOK?
Il BYOK è una funzione riservata al piano Agency (Enterprise).
| Piano | Crediti / mese | BYOK (chiave IA dedicata) |
|---|---|---|
| Starter — 39 €/mese | 1500 | No |
| Growth — 99 €/mese | 5000 | No |
| Agency — 299 €/mese | 20 000 | Sì |
Sui piani Starter e Growth la sezione BYOK appare ma resta bloccata: un riquadro ti invita a passare ad Agency. La restrizione è applicata anche lato server: salvare una chiave senza il piano Agency restituisce un errore. E se passi a un piano inferiore, la chiave smette automaticamente di applicarsi — la generazione torna allora all'IA della piattaforma e consuma di nuovo crediti.
Nota: la fatturazione annuale riduce il prezzo (lo sconto dipende dal piano). Il BYOK resta legato al piano Agency, indipendentemente dalla cadenza di fatturazione.
Quali fornitori sono compatibili?
In BYOK sono proposti due fornitori:
- Google Gemini — la tua chiave Google AI;
- OpenAI — la tua chiave OpenAI (modelli GPT).
Anthropic (Claude) non è proposto in BYOK. Il selettore del fornitore elenca solo Gemini e OpenAI. Se desideri la qualità di Gemini senza gestire una chiave, ricorda che è inclusa nel tuo abbonamento (nessuna chiave richiesta) — vedi Configurazione iniziale.
Configura la tua chiave API passo dopo passo
Tutto avviene nelle preferenze del tuo negozio.
- Apri Settings dal menu laterale.
- Vai alla sezione Preferenze (scelta del modello IA e chiave personale).
- Individua il blocco «Chiave API personale (BYOK)».
- Scegli il fornitore nel menu a discesa: Google Gemini o OpenAI.
- Seleziona il modello da utilizzare per quel fornitore.
- Incolla la tua chiave API nel campo previsto (il campo è mascherato, come una password).
- Fai clic su «Salva la mia chiave».
Una volta salvata la chiave, un banner verde conferma che è attiva e indica il fornitore. La chiave non viene mai più mostrata in chiaro: appare solo una versione mascherata (••••••••). Il modello attivo può essere modificato in qualsiasi momento tramite il menu a discesa appena sotto.
Selezionare un modello che richiede una chiave
Nel selettore dei modelli, i modelli di un fornitore diverso da Gemini mostrano un badge BYOK. Se provi a selezionare uno di questi modelli senza aver salvato la chiave corrispondente, Fexa AI te lo segnala e ti rimanda al modulo BYOK. È normale: un modello OpenAI può girare solo con una chiave OpenAI valida.
Dove e come viene archiviata la tua chiave?
La sicurezza della tua chiave è trattata come quella di un segreto sensibile.
- Cifrata a riposo. La tua chiave viene cifrata prima di essere salvata nel database (cifratura simmetrica AES-256-GCM). Non viene mai memorizzata in chiaro.
- Mai restituita al browser. L'API non restituisce mai la chiave (nemmeno cifrata) al client. L'interfaccia mostra solo una maschera.
- Decifrata solo al momento della chiamata. La chiave viene decifrata solo lato server, appena prima di essere passata al fornitore per eseguire la generazione.
Puoi eliminare la tua chiave in qualsiasi momento tramite il pulsante Elimina del banner «Chiave attiva». Se il modello attivo dipendeva da quella chiave, il negozio torna automaticamente al modello Gemini predefinito della piattaforma.
Cosa succede se la chiave fallisce?
Fexa AI è progettato affinché la generazione si concluda comunque, senza che tu debba monitorare il tuo account fornitore.
- Limite di frequenza (429). Se il tuo fornitore restituisce un errore di frequenza, il gateway IA riprova automaticamente con un ritardo crescente prima di arrendersi.
- Modello non disponibile. Se il modello scelto non esiste più o è stato rinominato dal fornitore, il gateway ricorre una volta al modello Gemini stabile della piattaforma invece di far fallire l'intera generazione.
- Chiave non valida o assente. Gli errori di autenticazione vengono mostrati così come sono: se la tua chiave non è valida, correggila nelle preferenze.
In breve: il BYOK è una leva di costo, non un punto di fragilità. La piattaforma resta in grado di portare a termine il lavoro.
BYOK e crediti: chi paga cosa?
È il cuore del vantaggio del BYOK. Il comportamento dipende dallo stato della tua chiave:
| Situazione | Chi esegue la chiamata IA | Crediti Fexa AI addebitati |
|---|---|---|
| Chiave BYOK attiva (Agency, fornitore coerente) | Il tuo account IA | Nessuno |
| Nessuna chiave / piano senza BYOK | IA della piattaforma | Sì (1 credito / pagina) |
| Chiave presente ma piano declassato | IA della piattaforma | Sì (la chiave non si applica più) |
Come promemoria, 1 credito = un'ottimizzazione completa (titolo + meta + descrizioni breve/lunga + ALT + FAQ + dati strutturati). Per capire bene cosa copre un credito e come funzionano le quote e i pacchetti booster, consulta il sistema di crediti. E per capire come l'IA costruisce ogni pagina a partire dal tuo catalogo, vedi la generazione IA.
Domande frequenti
Il BYOK è incluso in tutti i piani?
No. Il BYOK è riservato al piano Agency. Su Starter e Growth la sezione resta bloccata e invita a passare ad Agency.
Posso usare la mia chiave Claude (Anthropic)?
No. Il BYOK accetta solo Google Gemini e OpenAI. Anthropic non è proposto per il BYOK.
Consumo ancora crediti Fexa AI con il BYOK?
No, finché la tua chiave è attiva e il suo fornitore coincide con il fornitore di generazione. In tal caso l'ottimizzazione è fatturata dal tuo fornitore di IA, non in crediti Fexa AI.
La mia chiave è al sicuro?
Sì. È cifrata a riposo (AES-256-GCM), non viene mai restituita al browser e viene decifrata sul server solo durante l'esecuzione di una chiamata. Puoi eliminarla in qualsiasi momento.
Cosa succede se la mia chiave fallisce a metà di un lotto?
Il gateway IA riprova in caso di limiti di frequenza e ricorre al modello Gemini stabile della piattaforma se il modello richiesto non è disponibile, così che la generazione possa comunque concludersi.