AI에게 alt 텍스트 맡기기.

Learn DXPR BuilderBuild pagesSchrijven en ontwerpen met AI

alt 텍스트는 스크린 리더와 검색엔진용으로 사진을 설명합니다. Image 요소를 통해 사진을 업로드할 때 AI가 대신 작성해 줍니다. 사진이 업로드 폼에 있는 동안 한 번 클릭하면 됩니다. DXPR Builder가 텍스트를 이미지의 Alt attribute(으)로 복사합니다. 동영상에서는 캠퍼스 사진을 업로드하고 AI가 설명하게 합니다.

시작하기 전에

  • AI가 다음 문서대로 켜져 있습니다: Turn on AI in DXPR Builder.
  • 다음 모듈이 켜져 있습니다: AI Image Alt Text. DXPR CMS에서 대신 켜줍니다.
  • 사용자의 역할에 Generate AI Alt Tags 권한이 있습니다. DXPR CMS는 콘텐츠 편집자, 콘텐츠 관리자, 사이트 빌더에게 부여합니다.

설정

  1. 페이지에 Image 요소를 추가하세요. 설정 대화상자가 열립니다.
  2. 이제 Select Image(을)를 클릭하세요.
  3. 다음에서 Add file 아래 Choose File(을)를 클릭하고 사진을 고르세요.
  4. 이제 Alternative text 필드 아래에서 Generate with AI(을)를 클릭하세요.
  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에 Five laptops and a teapot on a table이라고 표시된 Image 요소 SEO 패널. 옆에는 해당 책상 사진

alt 텍스트의 출처

출처 Alt attribute에 들어가는 내용
미디어 라이브러리에서 고른 사진 라이브러리의 사진 대체 텍스트(있는 경우)
AI로 생성하거나 편집한 이미지 설명 또는 지시. 일반 설명으로 줄이세요
직접 입력 다음 아래에 직접 입력한 내용: SEO > Alt attribute

Image carousel 요소에는 같은 SEO 필드가 있습니다. Alt attribute(은)는 전체 캐러셀의 주제를 설명합니다.

이미지의 Alt attribute이 비어 있으면 이미지에 alt 텍스트가 전혀 없으며, 스크린 리더가 파일 이름을 읽을 수 있습니다. 순전히 장식용 그림에는 대신 섹션이나 열 배경 이미지를 사용하세요. 배경에는 alt 텍스트가 필요 없습니다.

설정

AI Image Alt Text 설정은 다음에 있습니다: Configuration > AI > AI Image Alt Text settings (/admin/config/ai/ai_image_alt_text).

설정 기능 기본값
Alt text generation prompt AI가 따르는 지침 좋은 alt 텍스트 규칙의 프롬프트
Image style 전송 전에 사진을 축소하여 크레딧을 아낍니다 모듈 자체 스타일
AI provider/model 사진을 설명하는 모델 Use Default Image Vision Model: DXPR 공급자를 먼저 저장한 경우의 DXPR
Autogenerate on upload 사진이 업로드되자마자 클릭 없이 alt 텍스트 작성 꺼짐
Hide button 업로드 시 alt 텍스트가 작성되면 Generate with AI 숨기기 꺼짐

좋은 alt 텍스트 작성

  • 사진에 표시된 내용을 한두 문장으로 설명하세요.
  • 이 페이지에서 중요한 세부 사항을 포함하세요.
  • “image of”나 “picture of”로 시작하지 마세요.
  • 일반적인 말보다 구체적으로 쓰세요.
사진 나쁜 alt 텍스트 좋은 alt 텍스트
단체 사진 “Image” “Five team members in the office lobby”
Open Day “Event” “Students touring the new library on Open Day”
차트 “Graph” “Bar chart showing 40% more applications in 2026”

alt 텍스트가 표시되지 않는 경우

  • Alternative text 아래에 Generate with AI 버튼이 없습니다. 사진이 아직 업로드되지 않았거나, 역할에 Generate AI Alt Tags 권한이 없거나, 이미지를 읽을 수 있는 AI 모델이 없습니다. 사진을 먼저 업로드하고, /admin/people/permissions에서 권한을 확인한 뒤, Turn on AI in DXPR Builder 문서대로 DXPR 공급자 폼을 저장하세요.
  • “We could not create an Alt Text, please try again later.” 메시지가 표시됩니다. AI 서비스가 응답하지 않았습니다. 잠시 기다렸다가 Generate with AI(을)를 다시 클릭하세요.
  • Insert selected 후에도 Alt attribute이 비어 있습니다. alt 텍스트가 함께 저장되기 전에 사진이 삽입되었습니다. SEO > Alt attribute 아래에 텍스트를 입력하거나, 사진을 제거하고 라이브러리에서 다시 고르세요.

다음 단계