--- url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/ai/image-alt-text' title: '让 AI 写替代文本 | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T00:43:20+00:00' updated: '2026-10-24T09:09:48+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: '替代文本为屏幕阅读器和搜索引擎描述照片。通过 Image 元素上传照片时，AI 可以为您代写：照片还在上传表单中时点一下即可。然后 DXPR Builder 将文本复制到图片的 Alt attribute 中。该视频上传了一张校园照片，并让 AI 描述它。' tags: - 'Schrijven en ontwerpen met AI' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T09:09:48+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: '让 AI 写替代文本' description: '替代文本为屏幕阅读器和搜索引擎描述照片。通过 Image 元素上传照片时，AI 可以为您代写：照片还在上传表单中时点一下即可。然后 DXPR Builder 将文本复制到图片的 Alt attribute 中。该视频上传了一张校园照片，并让 AI 描述它。' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T00:43:20+0000' dateModified: '2026-10-24T09:09:48+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/zh-hans/hc/documentation/learn-dxpr-builder/ai/image-alt-text' articleSection: 'Schrijven en ontwerpen met AI' - '@type': WebPage '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/ai/image-alt-text' description: '替代文本为屏幕阅读器和搜索引擎描述照片。通过 Image 元素上传照片时，AI 可以为您代写：照片还在上传表单中时点一下即可。然后 DXPR Builder 将文本复制到图片的 Alt attribute 中。该视频上传了一张校园照片，并让 AI 描述它。' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 首页 item: 'https://dxpr.com/zh-hans' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: zh-hans --- [Help Center](/zh-hans/node/75)/[Documentation](/zh-hans/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Build pages](/hc/documentation/learn-dxpr-builder/build) /[Schrijven en ontwerpen met AI](/hc/documentation/learn-dxpr-builder/ai) # 让 AI 写替代文本. Learn DXPR BuilderBuild pagesSchrijven en ontwerpen met AI ## In this guide Related guides - [用 AI 生成图片](/zh-hans/hc/documentation/learn-dxpr-builder/ai/image-generation) - [让您的页面无障碍可访问](/zh-hans/hc/documentation/learn-dxpr-builder/advanced/accessibility) - [AI 模型和服务商](/zh-hans/hc/documentation/learn-dxpr-builder/ai/models-and-providers) 替代文本为屏幕阅读器和搜索引擎描述照片。通过 Image 元素上传照片时，AI 可以为您代写：照片还在上传表单中时点一下即可。然后 DXPR Builder 将文本复制到图片的 **Alt attribute** 中。该视频上传了一张校园照片，并让 AI 描述它。 ## 开始之前 - AI 已按 [在 DXPR Builder 中开启 AI](/zh-hans/hc/documentation/learn-dxpr-builder/ai/setup) 所述开启。 - 该 **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** 下）显示同样的文本；只改本页的话请在那里改。 ## 替代文本的来源 | 来源 | 进入 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](/zh-hans/hc/documentation/learn-dxpr-builder/ai/setup) 所述保存 DXPR 提供方表单。 - **出现“We could not create an Alt Text, please try again later.”。** AI 服务没有响应。请稍等，再点击 **Generate with AI**。 - **Insert selected 后 Alt attribute 仍为空。** 照片在替代文本随它保存之前就插入了。请在 **SEO** > **Alt attribute** 下输入文本，或移除照片再从库中重新挑选。 ## 接下来做什么？ - [用 AI 生成图片](/zh-hans/hc/documentation/learn-dxpr-builder/ai/image-generation)：先创建照片，再描述它。 - [无障碍](/zh-hans/hc/documentation/learn-dxpr-builder/advanced/accessibility)：让页面适合所有人的更多方法。 - [模型和服务商](/zh-hans/hc/documentation/learn-dxpr-builder/ai/models-and-providers)：哪个模型描述您的照片。