“Risposta vuota dal provider” / errori di connessione

Sintomo

La generazione fallisce con "Errore di connessione", "Errore API (codice)" o "Risposta vuota dal provider" e non viene prodotto alcun SEO.

Causa

I chiamanti API di AISA restituiscono un risultato più un errore e presentano tre casi distinti: un errore di trasporto (WordPress is_wp_error) viene visualizzato come "Errore di connessione"; uno stato HTTP diverso da 200 viene visualizzato come "Errore API (codice)"; e una chiamata riuscita che non restituisce testo viene visualizzata come "Risposta vuota dal provider". Le cause comuni sono una chiave API errata o non configurata, nessuna connessione internet in uscita dal server, il provider non funzionante o con limitazione di velocità, o un modello che non ha restituito nulla (in particolare alcuni modelli Gemini Flash che spendono tutto il budget per il ragionamento nascosto).

Soluzione

• Errore di connessione — verifica che il server abbia connessione internet in uscita verso il provider e che la chiave sia impostata in Impostazioni → Chiavi API; usa il pulsante Test del provider.
• Errore API (codice) — leggi il codice: 401/403 significa chiave errata, 429 significa limite di velocità (riduci Turbo o aggiungi chiavi), 5xx significa che il provider è giù — riprova più tardi.
• Risposta vuota — prova un altro provider; se è Gemini, aggiorna alla versione 1.99.826+ (che imposta thinkingBudget a 0 e usa gemini-2.5-flash) in modo che il modello restituisca testo effettivo.

Il log di debug in wp-content/debug.log registra l'errore esatto.

Domande frequenti

Risposta vuota specificamente su Gemini — cosa fare? Aggiorna alla versione 1.99.826+; il caso di output vuoto è un problema di thinkingBudget di Gemini risolto lì.

Funziona in locale ma fallisce in generazione — la chiave è sbagliata? Usa il pulsante Test nella pagina delle chiavi API; 401/403 conferma un problema di chiave, 429 un limite di velocità.

Correlati

• Errori Gemini (modello deprecato / output vuoto)
• Errori di limite di velocità / 429
• Funziona su localhost e staging