Deixar a IA escrever o texto alternativo.

Aprender DXPR BuilderCriar páginasEscrever e desenhar com IA

O texto alternativo descreve uma foto para leitores de ecrã e motores de pesquisa. Ao carregar uma foto através de um elemento Image, a IA pode escrevê-lo: um clique enquanto a foto ainda está no formulário de carregamento. O DXPR Builder copia depois o texto para o Alt attribute da imagem. O vídeo carrega uma foto do campus e deixa a IA descrevê-la.

Antes de começar

  • A IA está ligada como descrito em Ativar a IA no DXPR Builder.
  • O módulo AI Image Alt Text está ativo. O DXPR CMS ativa-o.
  • A função tem a permissão Generate AI Alt Tags. O DXPR CMS dá-a a editores de conteúdos, administradores de conteúdos e construtores de sites.

Configuração

  1. Adicione um elemento Image à página. O diálogo de definições abre.
  2. Clique em Select Image.
  3. Em Add file, clique em Choose File e escolha a foto.
  4. Clique em Generate with AI abaixo do campo Alternative text.
  5. Clique em Save para adicionar a foto à biblioteca de multimédia.
  6. Clique em Insert selected.
  7. Abra SEO: o Alt attribute guarda a descrição da IA.
  8. Clique em Save no diálogo.

Para uma imagem que já está na página, abra as definições com More > Settings e comece no passo 2. Se o site pergunta "Transfer image and meta data to chosen AI service?", aceite: a foto é enviada para o serviço de IA para ser descrita.

O que vê

Enquanto a IA vê a foto, "Generating alt text..." aparece abaixo do campo. Depois Alternative text preenche-se com uma descrição de uma frase. Fica guardada com a foto na biblioteca de multimédia, por isso cada página que usa a foto recebe-a. No elemento Image, Alt attribute em SEO mostra o mesmo texto; mude-o aí apenas para esta página.

Painel SEO de elemento Image cujo Alt attribute indica Five laptops and a teapot on a table, junto a essa foto de secretária

De onde vem o texto alternativo

Source What ends up in Alt attribute
Uma foto escolhida na biblioteca de multimédia O texto alternativo da foto na biblioteca, se tem um
Uma imagem gerada ou editada com IA A descrição ou instrução; encurte-a para uma descrição simples
Escrito à mão O que escrever em SEO > Alt attribute

O elemento Image carousel tem os mesmos campos SEO. O Alt attribute descreve o tema de todo o carrossel.

Quando Alt attribute está vazio, a imagem não tem texto alternativo nenhum, e os leitores de ecrã podem ler o nome do ficheiro. Para uma imagem puramente decorativa, use antes uma imagem de fundo de secção ou coluna: fundos não precisam de texto alternativo.

Definições

As definições de AI Image Alt Text estão em Configuration > AI > AI Image Alt Text settings (/admin/config/ai/ai_image_alt_text).

Setting What it does Default
Alt text generation prompt A instrução que a IA segue Uma prompt com regras para bom texto alternativo
Image style Reduz a foto antes de a enviar, o que custa menos créditos O estilo próprio do módulo
AI provider/model O modelo que descreve a foto Use Default Image Vision Model: DXPR, quando guardou primeiro o fornecedor DXPR
Autogenerate on upload Escreve o texto alternativo assim que uma foto é carregada, sem clique Off
Hide button Esconde Generate with AI quando o texto alternativo é escrito no carregamento Off

Escrever bom texto alternativo

  • Descreva o que a foto mostra numa ou duas frases.
  • Inclua o detalhe que importa nesta página.
  • Não comece com "image of" ou "picture of".
  • Seja específico em vez de genérico.
Photo Poor alt text Good alt text
Foto de equipa "Image" "Cinco membros da equipa no átrio do escritório"
Dia aberto "Event" "Estudantes a visitar a nova biblioteca no dia aberto"
Gráfico "Graph" "Gráfico de barras a mostrar mais 40% de candidaturas em 2026"

Se o texto alternativo não aparece

  • There is no Generate with AI button below Alternative text. A foto ainda não foi carregada, a função não tem Generate AI Alt Tags, ou nenhum modelo de IA lê imagens. Carregue primeiro a foto, verifique a permissão em /admin/people/permissions e guarde o formulário do fornecedor DXPR como descrito em Ativar a IA no DXPR Builder.
  • "We could not create an Alt Text, please try again later." appears. O serviço de IA não respondeu. Aguarde um momento e clique outra vez em Generate with AI.
  • Alt attribute stays empty after Insert selected. A foto foi inserida antes de o texto alternativo ser guardado com ela. Escreva o texto em SEO > Alt attribute, ou remova a foto e escolha-a outra vez na biblioteca.

O que se segue?