# Generated alt text, reviewed: three rules before the prompt

Generated alt text describes what the model sees, not what the image is for. Review it, keep it under 125 characters, and empty it when decorative.

> Page: https://ui.eneawork.it/blog/ai-generazione-alt-text
> Markdown: https://ui.eneawork.it/blog/ai-generazione-alt-text.md

*2026-11-01*

Un alt text generato è una bozza: descrive quello che il modello vede, non lo scopo dell'immagine nella pagina. Va revisionato, accorciato e a volte cancellato.

Il catalogo pubblica 12.808 icone da 1.472 librerie, letti da /api/stats il 1 novembre 2026. Le copertine italiane in public/blog-covers/it sono 1.156 file per 41.599.334 byte, con una media di 35.986 byte e un massimo di 79.633 byte, misurati lo stesso giorno con uno script Node. La pagina prezzi di OpenAI, letta il 1 novembre 2026, quota gpt-6-luna a 0,10 $ per milione di token in ingresso e 0,50 $ in uscita; la pagina Anthropic, letta lo stesso giorno, quota Haiku 5.5 agli stessi 0,10 $ e 0,50 $. Il criterio 1.1.1 delle WCAG 2.2 chiede un'alternativa testuale per ogni contenuto non testuale.

## Tre regole che valgono più del prompt

grep -o ']*>' dist/index.html | grep -vc 'alt='

Il comando conta le immagini senza attributo alt in un file HTML costruito: è il primo controllo, non l'ultimo. Un alt vuoto e un alt assente si vedono uguali in pagina e sono due cose diverse nel DOM.

## Il giro di revisione

Genera, poi confronta con la pagina: ogni alt che nomina un colore o una forma senza dire a cosa serve l'immagine va riscritto. La revisione costa più della generazione, ed è l'unica parte che migliora il risultato.

import { generateText } from 'ai'; const alt = await generateText({ model: 'openai/gpt-6-luna', messages: [ { role: 'user', content: [ { type: 'text', text: 'Write alt text under 125 characters. State the purpose, not the pixels. If the image is decorative, answer exactly: decorative.', }, { type: 'image', image: new URL(imageUrl) }, ], }, ], maxOutputTokens: 60, }); console.log(alt.text);

## Cosa non delegare

## La limitazione

Il modello non vede la pagina: senza il testo che sta accanto produce didascalie generiche. E nessuna metrica pubblica misura la qualità di un alt, quindi il controllo resta una lettura umana pagina per pagina.

## Dove continuare

Il giro completo di verifica è in audit di accessibilità, gli errori ricorrenti in errori comuni WCAG, il confronto fra librerie headless in Radix, Base UI e React Aria. I record: 12.808 icone, 111.985 componenti, 1.556 blocchi.

## FAQ

### Posso pubblicare un alt text generato senza rileggerlo?

No. Il modello descrive ciò che vede e non sa a cosa serve l'immagine in quella pagina, quindi sbaglia proprio la parte che conta. Rileggi sempre e riscrivi quando l'alt non spiega lo scopo.

### Quanto deve essere lungo un alt text?

Sotto i 125 caratteri nella maggior parte dei casi: una frase che dice cosa fa l'immagine. Le immagini con dati, come un grafico, hanno bisogno di una descrizione più lunga e di una tabella equivalente nel testo.

### Quando l'alt deve restare vuoto?

Quando l'immagine è decorativa o ripete il testo che sta accanto. Un alt vuoto è esplicito per il lettore di schermo; un alt assente è un errore di markup.

### Quanto costa generare l'alt di un catalogo di immagini?

Dipende dai token dell'immagine e del prompt. Con gpt-6-luna a 0,10 $ per milione di token in ingresso e 0,50 $ in uscita, il costo per immagine resta basso, ma trenta caratteri di risposta non valgono il risparmio di una revisione saltata.

### L'alt text migliora la SEO?

Aiuta la comprensione dell'immagine e l'accessibilità, non la posizione. Un alt pieno di parole chiave viene ignorato dai motori e letto ad alta voce agli utenti, che è peggio.