--- url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/ai/image-alt-text' title: 'AI에게 alt 텍스트 맡기기 | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T01:38:21+00:00' updated: '2026-10-24T09:09:48+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- alt 텍스트는 스크린 리더와 검색엔진용으로 사진을 설명합니다. 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에게 alt 텍스트 맡기기' description: |- alt 텍스트는 스크린 리더와 검색엔진용으로 사진을 설명합니다. 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-24T01:38:21+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/ko/hc/documentation/learn-dxpr-builder/ai/image-alt-text' articleSection: 'Schrijven en ontwerpen met AI' - '@type': WebPage '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/ai/image-alt-text' description: |- alt 텍스트는 스크린 리더와 검색엔진용으로 사진을 설명합니다. Image 요소를 통해 사진을 업로드할 때 AI가 대신 작성해 줍니다. 사진이 업로드 폼에 있는 동안 한 번 클릭하면 됩니다. DXPR Builder가 텍스트를 이미지의 Alt attribute(으)로 복사합니다. 동영상에서는 캠퍼스 사진을 업로드하고 AI가 설명하게 합니다. breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 홈 item: 'https://dxpr.com/ko' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: ko --- [Help Center](/ko/node/75)/[Documentation](/ko/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에게 alt 텍스트 맡기기. Learn DXPR BuilderBuild pagesSchrijven en ontwerpen met AI ## In this guide Related guides - [AI로 이미지 생성](/ko/hc/documentation/learn-dxpr-builder/ai/image-generation) - [페이지 접근성 높이기](/ko/hc/documentation/learn-dxpr-builder/advanced/accessibility) - [AI 모델과 공급자](/ko/hc/documentation/learn-dxpr-builder/ai/models-and-providers) alt 텍스트는 스크린 리더와 검색엔진용으로 사진을 설명합니다. Image 요소를 통해 사진을 업로드할 때 AI가 대신 작성해 줍니다. 사진이 업로드 폼에 있는 동안 한 번 클릭하면 됩니다. DXPR Builder가 텍스트를 이미지의 **Alt attribute**(으)로 복사합니다. 동영상에서는 캠퍼스 사진을 업로드하고 AI가 설명하게 합니다. ## 시작하기 전에 - AI가 다음 문서대로 켜져 있습니다: [Turn on AI in DXPR Builder](/ko/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. 이제 **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 텍스트의 출처 | 출처 | 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](/ko/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이 비어 있습니다.** alt 텍스트가 함께 저장되기 전에 사진이 삽입되었습니다. **SEO** > **Alt attribute** 아래에 텍스트를 입력하거나, 사진을 제거하고 라이브러리에서 다시 고르세요. ## 다음 단계 - [Generate an image with AI](/ko/hc/documentation/learn-dxpr-builder/ai/image-generation): 사진을 만든 뒤 설명을 답니다. - [Accessibility](/ko/hc/documentation/learn-dxpr-builder/advanced/accessibility): 페이지를 모두에게 맞추는 더 많은 방법입니다. - [Models and providers](/ko/hc/documentation/learn-dxpr-builder/ai/models-and-providers): 사진을 설명하는 모델입니다.