Collega un provider AI e aggiungi la tua chiave API

Cos'è

AI SEO & GEO Assistant genera i tuoi titoli SEO, meta description, focus keyphrase, contesto di ricerca AI e testo alternativo delle immagini chiamando un provider di modelli linguistici di grandi dimensioni. In modalità "porta la tua chiave" (BYOK) colleghi tu stesso il provider incollando una chiave API che crei sul sito web del provider. Il plugin parla quindi direttamente con il provider dal tuo sito e paghi il provider per i token che utilizzi (tipicamente centesimi per centinaia di pagine).

Puoi collegare più di un provider contemporaneamente. AISA sceglie quale utilizzare in base alla tua impostazione Provider predefinito (o "Auto"), e puoi persino dedicare un provider separato solo per le immagini.

Dove si trova

In wp-admin, vai al menu AISA → Impostazioni → scheda Chiavi API. Ogni provider supportato ha la propria scheda con un campo per la chiave, un interruttore di attivazione, un selettore di modello e un pulsante Test connessione. Il provider predefinito corrente viene scelto dal menu a tendina nella parte superiore della stessa scheda.

Requisiti e piano

Funziona sui piani Gratuito e Premium (Solo/Pro/Agency/Studio), che utilizzano entrambi la tua chiave e contano i token.
Un account con almeno un provider supportato: DeepSeek, OpenAI (ChatGPT), Google Gemini, Anthropic Claude, Mistral, xAI Grok o Perplexity.
Alcuni provider richiedono un piccolo saldo prepagato (ad esempio OpenAI necessita di qualche dollaro di credito prima che la chiave funzioni).
Una descrizione aziendale del Brand Context deve essere compilata (Impostazioni → Brand Context & Style) prima che la generazione sia consentita — questo è ciò che rende l'output personalizzato per te.
Se sei su AISA Cloud non aggiungi alcuna chiave: la generazione avviene tramite il nostro server e viene conteggiata in crediti. Vedi l'articolo correlato BYOK vs Cloud.

Come si usa

Crea un account su un provider e apri la sua pagina delle chiavi API (ogni scheda in AISA collega direttamente ad essa).
Clicca "Crea chiave API" sul provider e copia immediatamente la chiave — la maggior parte dei provider la mostra solo una volta.
In AISA → Impostazioni → Chiavi API, incolla la chiave nel campo di quel provider.
Scegli un modello dal menu a tendina del provider (quello predefinito consigliato è preselezionato) e assicurati che l'interruttore di attivazione del provider sia acceso.
Clicca Test connessione. Un risultato verde significa che la chiave funziona; un errore ti dice cosa non va (chiave errata, saldo insufficiente, provider bloccato).
Salva. Opzionalmente imposta questo provider come Provider predefinito in alto, o lascialo su "Auto".
Apri qualsiasi articolo e usa il pannello AISA fluttuante, o esegui 1-Click SEO, per generare con il provider collegato.

Domande frequenti

Dove sono memorizzate le mie chiavi? Solo nel database del tuo sito. AISA non le invia mai da nessuna parte tranne che al provider che hai scelto, e sono escluse per impostazione predefinita dall'esportazione/importazione delle impostazioni.
Ho bisogno di una chiave per ogni provider? No. Un provider funzionante è sufficiente. Aggiungine altri solo se vuoi scelta, un provider dedicato per le immagini o capacità parallela extra.
Il pulsante Test connessione fallisce — perché? Le cause più comuni sono una chiave scritta male/scaduta, nessun saldo prepagato (OpenAI) o l'interruttore del provider spento. Il messaggio di errore indica la causa.
Posso usarlo su un sito locale o di staging? Sì. Con la tua chiave, AISA funziona perfettamente su localhost/staging — puoi ottimizzare l'intero sito prima che vada online, cosa che i plugin AI cloud non possono fare.
Quale provider dovrei scegliere per primo? Per il costo più basso su testo in blocco, DeepSeek. Per la migliore qualità di scrittura, Claude. Vedi l'articolo "Provider AI supportati e quale scegliere".
Aggiungere una chiave sostituirà il mio plugin SEO? No. AISA scrive nei campi di Yoast/Rank Math/SEOPress/AIOSEO (o emette meta da solo se nessuno è installato). La chiave alimenta solo la generazione AI.

Risoluzione problemi

Se la generazione è bloccata, controlla prima di aver compilato la descrizione aziendale del Brand Context — senza di essa la generazione è intenzionalmente disabilitata. Se Test connessione restituisce "Errore API", ricopia la chiave (attenzione agli spazi iniziali/finali) e conferma che l'account del provider abbia fatturazione/saldo abilitato. Se un campo chiave salvato è vuoto dopo il salvataggio, il provider viene automaticamente disabilitato — incolla di nuovo la chiave. Una risposta 429/503/529 significa che il provider ti ha limitato la velocità; riduci la velocità di AISA Turbo o aggiungi più chiavi al pool multi-chiave. Se hai rimosso una chiave intenzionalmente, l'interruttore del provider si spegne per progettazione.

Correlati

Provider AI supportati e quale scegliere
Scegliere il modello e comprendere i costi
L'opzione provider "Auto"
Porta la tua chiave (BYOK) vs crediti AISA Cloud