--- url: 'https://dxpr.com/pt-pt/hc/documentation/learn-dxpr-builder/ai/image-alt-text' title: 'Deixar a IA escrever o texto alternativo | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T11:45:44+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: '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.' tags: - 'Write and design with AI' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T11:45:44+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 'Deixar a IA escrever o texto alternativo' description: '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.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T11:45:44+0000' dateModified: '2026-10-24T11:45:44+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/pt-pt/hc/documentation/learn-dxpr-builder/ai/image-alt-text' articleSection: 'Escrever e desenhar com IA' - '@type': WebPage '@id': 'https://dxpr.com/pt-pt/hc/documentation/learn-dxpr-builder/ai/image-alt-text' description: '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.' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Início item: 'https://dxpr.com/pt-pt' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: pt-pt --- [Centro de ajuda](/pt-pt/node/75)/[Documentação](/pt-pt/hc/documentation) /[Aprender DXPR Builder](/pt-pt/hc/documentation/learn-dxpr-builder) /[Criar páginas](/pt-pt/hc/documentation/learn-dxpr-builder/build) /[Escrever e desenhar com IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai) # Deixar a IA escrever o texto alternativo. Aprender DXPR BuilderCriar páginasEscrever e desenhar com IA ## Neste guia Guias relacionados - [Gerar uma imagem com IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai/image-generation) - [Tornar as páginas acessíveis](/pt-pt/hc/documentation/learn-dxpr-builder/advanced/accessibility) - [Modelos e fornecedores de IA](/pt-pt/hc/documentation/learn-dxpr-builder/ai/models-and-providers) 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](/hc/documentation/learn-dxpr-builder/ai/setup). - 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. ## 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](/hc/documentation/learn-dxpr-builder/ai/setup). - **"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? - [Gerar uma imagem com IA](/hc/documentation/learn-dxpr-builder/ai/image-generation): crie uma foto e depois descreva-a. - [Acessibilidade](/hc/documentation/learn-dxpr-builder/advanced/accessibility): mais formas de fazer as páginas funcionar para todos. - [Modelos e fornecedores](/hc/documentation/learn-dxpr-builder/ai/models-and-providers): que modelo descreve as fotos.