让 AI 写替代文本.

Learn DXPR BuilderBuild pagesSchrijven en ontwerpen met AI

替代文本为屏幕阅读器和搜索引擎描述照片。通过 Image 元素上传照片时，AI 可以为您代写：照片还在上传表单中时点一下即可。然后 DXPR Builder 将文本复制到图片的 Alt attribute 中。该视频上传了一张校园照片，并让 AI 描述它。

开始之前

  • AI 已按 在 DXPR Builder 中开启 AI 所述开启。
  • 该 AI Image Alt Text 模块已启用。DXPR CMS 会为您启用。
  • 您的角色拥有 Generate AI Alt Tags 权限。DXPR CMS 将其授予内容编辑人员、内容管理员和网站搭建人员。

设置

  1. 向页面添加 Image 元素。其设置对话框随即打开。
  2. 点击 Select Image。
  3. 在 Add file 下点击 Choose File 并挑选照片。
  4. 点击 Generate with AI（Alternative text 字段下方）。
  5. 点击 Save，将照片加入媒体库。
  6. 点击 Insert selected。
  7. 打开 SEO：Alt attribute 中是 AI 的描述。
  8. 点击对话框中的 Save。

对于页面上已有的图片，用 More > Settings 打开其设置，从第 2 步开始。如果网站询问“Transfer image and meta data to chosen AI service?”，请接受：照片会被发送到 AI 服务进行描述。

您会看到的内容

AI 查看照片时，字段下方显示“Generating alt text...”。然后 Alternative text 填入一句描述。它随照片存放在媒体库中，因此使用该照片的每个页面都能得到。在 Image 元素中，Alt attribute（SEO 下）显示同样的文本；只改本页的话请在那里改。

Image 元素的 SEO 面板，Alt attribute 为 Five laptops and a teapot on a table，旁边是那张书桌照片

替代文本的来源

来源 进入 Alt attribute 的内容
从媒体库挑选的照片 库中该照片的替代文本（如果有）
用 AI 生成或编辑的图片 您的描述或指令；请精简为简洁的描述
手工输入 手输到 SEO > Alt attribute

Image carousel 元素有同样的 SEO 字段。其 Alt attribute 描述整个轮播的主题。

如果 Alt attribute 为空，图片完全没有替代文本，屏幕阅读器可能读出文件名。对于纯装饰性图片，请改用版块或列背景图片：背景不需要替代文本。

设置

AI Image Alt Text 设置在 Configuration > AI > AI Image Alt Text settings (/admin/config/ai/ai_image_alt_text)。

设置 作用 默认值
Alt text generation prompt AI 遵循的指令 带好替代文本规则的提示词
Image style 发送前将照片缩小，消耗更少积分 模块自带的样式
AI provider/model 描述照片的模型 Use Default Image Vision Model：先保存 DXPR 提供方时即为 DXPR
Autogenerate on upload 照片上传后立即写替代文本，无需点击 关
Hide button 上传替代文本写好后隐藏 Generate with AI 按钮 关

写好替代文本

  • 用一两句话描述照片内容。
  • 包含在本页重要的细节。
  • 不要以“image of”或“picture of”开头。
  • 具体而不泛泛。
照片 差的替代文本 好的替代文本
团队合影 “Image” “Five team members in the office lobby”
开放日 “Event” “Students touring the new library on Open Day”
图表 “Graph” “Bar chart showing 40% more applications in 2026”

如果您看不到替代文本

  • Alternative text 下方没有 Generate with AI 按钮。 照片尚未上传，或您的角色缺少 Generate AI Alt Tags，或没有 AI 模型能读图。请先上传照片，在 /admin/people/permissions 检查权限，并按 在 DXPR Builder 中开启 AI 所述保存 DXPR 提供方表单。
  • 出现“We could not create an Alt Text, please try again later.”。 AI 服务没有响应。请稍等，再点击 Generate with AI。
  • Insert selected 后 Alt attribute 仍为空。 照片在替代文本随它保存之前就插入了。请在 SEO > Alt attribute 下输入文本，或移除照片再从库中重新挑选。

接下来做什么？