🏠 Dr.Portal 홈 🗂️ 메디컬 콘텐츠 허브 📘 환자교육자료 이미지 생성기 ← 📚 갤러리
📘 USER MANUAL · v1.1 · 2026-04-28 · 다국어+테마 추가

환자교육자료 이미지 생성기 매뉴얼

7단계 입력 폼 + AI Vision 분석으로 만성질환 환자 교육용 인포그래픽을 자동 생성합니다. 공유형(갤러리)과 병원용(병원명·로고 자동 삽입)으로 분리 운영하며, 이전 교육자료를 첨부하면 AI가 텍스트로 변환해 드립니다.

1모드 선택
2교육 내용 입력 (텍스트/이미지)
3옵션 자동 채움
4미세 조정
5이미지 생성
6저장·공유

📑 목차

15분 빠른 시작

가장 빠른 경로 — 의사가 환자에게 설명한 내용을 그대로 붙여넣고 1분 만에 인포그래픽을 받는 흐름입니다.

1⚙️ OpenAI API 키 등록 (최초 1회)
우상단 ⚙️ 버튼 클릭 → sk-... 형태의 OpenAI 본인 키 입력 → [저장]
키는 sessionStorage에만 저장되며 탭을 닫으면 자동 삭제됩니다 (공용 PC 보안).
2🌐 자료 모드 선택
화면 좌측 상단 모드 토글:
  • 🌐 공유형 — 갤러리·SNS·블로그용. 병원 식별 정보 제외 (default)
  • 🏥 병원용 — 병원명·의사명·로고 자동 삽입
3📝 교육 내용 붙여넣기
A 섹션 textarea에 실제 환자에게 설명한 내용을 그대로 붙여넣습니다.
형식 예시: [만성질환관리교육-당뇨병] 자가혈당측정(SMBG)의 중요성
[교육실시내역] 자가혈당측정은 본인의 혈당 패턴을 이해하고...
4) 핵심 키워드 : #자가혈당측정 #SMBG #혈당기록
4✅ 교육실시내역 적용 클릭
A섹션(자료 카테고리·질환·세부 주제) → B섹션(대상) → C섹션(메시지·키워드) → D섹션(시각·인물·오브젝트)이 일괄 자동 채워집니다.
E·F·G(디자인·출력·안전)는 의료 인포그래픽 표준 기본값 유지.
5🎨 이미지 생성 → 결과 확인
우측 결과 패널 [✨ 프롬프트 생성] (선택) + [🎨 이미지 생성] 클릭 → 12~22초 후 결과 표시.
이미지 클릭 또는 [🔍 크게 미리보기]로 풀스크린 확인 → [⬇ PNG 다운로드] 또는 [🎁 갤러리 기부].
✓ 완료! 익숙해지면 1분 안에 인포그래픽 1장이 만들어집니다.

2자료 모드 — 공유형 vs 병원용

같은 교육 내용이라도 어디에 쓸지에 따라 2가지 모드 중 선택하세요.

🌐 공유형🏥 병원용
용도갤러리·SNS·블로그 공유우리 병원 환자 안내문
병원명·의사명❌ 자동 제외✅ 회원정보 자동 채움 (수정 가능)
로고 삽입✅ 첨부 시 하단 우측 자동 배치
OpenAI API/v1/images/generations로고 있을 시 /v1/images/edits, 없을 시 generations
갤러리 기부✅ 가능❌ 차단 (개인 식별 정보 보호)

병원용 모드 — 자동 채움 동작

병원 로고 업로드 (선택)

⚠️ 추후 회원정보 연동 예정 — 현재 1단계는 브라우저 단위 캐싱이라 다른 기기에서는 다시 업로드 필요. 2단계(2026-05~) Firebase 회원정보 연동 시 모든 기기·동료 자동 공유 예정.

3🌐 출력 언어 (다국어 13종)

이미지 안 모든 텍스트를 13가지 언어 중 하나로 출력합니다. 모드 토글 아래 노란색 row의 [🌐 출력 언어] 셀렉트에서 변경.

지원 언어

구분언어 (10 + 3)주요 활용
단일 언어🇰🇷 한국어 / 🇬🇧 English / 🇨🇳 简体中文 / 🇹🇼 繁體中文 / 🇯🇵 日本語 / 🇻🇳 Tiếng Việt / 🇹🇭 ภาษาไทย / 🇪🇸 Español / 🇷🇺 Русский / 🇲🇳 Монгол이미지 안 텍스트 1종 단독
다국어 병기🌏 한국어 + English / 한국어 + Tiếng Việt / 한국어 + 简体中文한국어 큰 헤더 + 외국어 작은 부제 동시 표기

활용 시나리오

프롬프트 동작

영어 프롬프트에 4개 항목(이름·script·우선/금지)이 정확히 전달됩니다:

💡 팁 — 출력 언어는 이미지 안 텍스트만 변경합니다. 좌측 옵션 폼·우측 미리보기 등 도구 UI 자체의 한국어 표시는 그대로입니다.
⚠️ 다문화 환자 자료를 갤러리 기부할 때는 자료명·태그를 한국어로 작성해 주세요 (검색·분류 일관성).

4교육 내용 입력 — 3가지 방법

방법 1 — 텍스트 직접 붙여넣기 (가장 빠름)

의사가 환자에게 설명한 내용을 그대로 textarea에 붙여넣습니다. 형식이 자유로워도 자동 파서가 다음을 인식합니다:

방법 2 — 이전 교육자료 이미지 첨부 + AI Vision 분석

이전에 만든 PDF 캡처, 안내문 사진 등을 첨부하면 gpt-4o-mini Vision이 한국어로 텍스트화해 줍니다.

  1. 📎 영역에 이미지 첨부 (클릭/드래그/Ctrl+V · PNG·JPG·WEBP, 8MB 이하)
  2. [🔍 이미지 분석] 클릭 (~5초, ~0.3원)
  3. 분석 결과가 textarea에 자동 채움 + A 4개 필드 즉시 적용 (자료 카테고리·질환·세부 주제·자료명)
  4. (선택) textarea 검토·수정
  5. [✅ 교육실시내역 적용] → B/C/D 채움

방법 3 — 7단계 폼 직접 입력 (정밀 제어)

위 자동화 없이 7단계 폼(A주제·B대상·C메시지·D시각·E디자인·F출력·G안전)을 직접 채워가며 만들 수 있습니다. 모든 옵션이 통제 가능한 콤보박스/체크박스/라디오로 제공됩니다.

💡 팁 — 방법 2 + 1을 조합하면 가장 강력합니다. Vision으로 이미지에서 텍스트 추출 → textarea에서 직접 보정 → [✅ 적용]으로 자동 매핑.

5AI Vision 이미지 분석

이전에 만든 환자 교육자료 이미지를 첨부하면 OpenAI gpt-4o-mini Vision API가 다음을 추출합니다:

추출 항목내용이후 사용
[카테고리-질환]자료 카테고리 + 질환 분야A 자료 카테고리·질환 자동 채움
자료명/주제자료의 핵심 주제A 자료명·세부 주제 자동 채움
[교육실시내역]본문 200~400자 한국어 요약textarea에 채움 + 프롬프트 앵커로 사용
핵심 키워드#키워드 5개 이내C 강조 키워드 자동 체크 (적용 시)
🆕 분석 직후 A섹션 자동 적용 — Vision이 추출한 [카테고리-질환] 패턴에서 자료 카테고리·질환 분야·세부 주제·자료명 4개 필드가 즉시 자동으로 채워집니다 (B/C/D는 [✅ 교육실시내역 적용] 클릭 시).

Vision의 안전 정책 (시스템 프롬프트에 명시)

비용 (gpt-4o-mini Vision)

⚠️ 콘텐츠 정책 — 노골적 의료 묘사·해부도 사진은 거부될 수 있음. 그런 경우 프롬프트 자동 조합으로 대체 시도.

67단계 입력 폼 가이드

각 섹션은 collapsible(접기/펼치기) <details>로 구성되어 화면을 압축할 수 있습니다.

A. 1단계. 주제 설정

B. 2단계. 대상 설정

C. 3단계. 메시지 설정

D. 4단계. 시각 설정

E·F·G — 디자인·출력·안전

일반 의료 인포그래픽 표준 default가 미리 채워져 있어 그대로 사용해도 무방합니다. 필요 시 색상 테마, 텍스트 밀도, 출력 포맷, 제외 요소 등을 조정.

7이미지 생성 방식 — 텍스트 vs 변형

소스 이미지가 첨부되어 있으면 우측 토글이 자동으로 표시됩니다.

옵션API입력 이미지사용 시나리오
✏️ 텍스트 기반 새 생성 (default)/v1/images/generations없음Vision으로 추출한 텍스트만으로 깔끔한 새 인포그래픽
🔄 첨부 이미지 변형/v1/images/edits소스 이미지기존 자료의 구도·메시지를 살리며 새 디자인으로 재구성

입력 이미지 우선순위 (변형 모드 선택 시)

  1. 소스 이미지 (첨부 + 변형 모드 ON)
  2. 병원 로고 (병원용 + 로고 등록 + 변형 모드 OFF)
  3. 없음 (그 외 모든 케이스 — 텍스트만)
⚠️ 변형 모드 + 병원용 + 로고 조합 시 → 소스 이미지가 input 우선이라 로고는 합성되지 않을 수 있습니다 (토스트로 안내).
💡 팁 — 처음에는 ✏️ 텍스트 기반을 권장합니다. 결과가 마음에 안 들면 🔄 변형으로 같은 옵션 그대로 다시 생성해 비교해 보세요.

8출력 형식 · 모델 · 비용

출력 형식 (8종)

형식이미지 사이즈주요 용도
A4 세로형 교육자료1024×1536병원 출력물, EMR 첨부
A4 가로형 교육자료1536×10242단·3단 접지물
1:1 카드뉴스1024×1024인스타그램, 카페 게시글
4:5 카드뉴스1024×1536인스타·블로그 본문
16:9 썸네일1536×1024유튜브·블로그 표지, 대기실 모니터
9:16 모바일 포스터1024×1536카카오톡, 모바일 공유
병실 TV/대기실 모니터용1536×1024병원 디스플레이 슬라이드
EMR 첨부용 설명 카드1024×1024EMR 진료기록 첨부

AI 모델 — GPT Image 2 (단일)

2026-04 기준 한국어 가독성이 검증된 단일 모델입니다. 이전에 있던 gpt-image-1.5는 한국어 텍스트 깨짐 이슈로 제외되었습니다.

품질·비용·시간 (1024×1536 A4 세로 기준)

품질출력 토큰비용 (1장)예상 시간권장 용도
Low (저렴)~167~7원~6초빠른 시안 확인 · 변형 다수 비교
Medium (default)~1,367~57원~12초일반 환자 교육자료 (권장)
High (고품질)~5,500~228원~22초대형 출력·인쇄용 최종본

변형 모드(/v1/images/edits)는 입력 이미지 토큰이 추가되어 시간이 약 1.4× 더 소요됩니다.

💡 환율 — 1 USD = 1,380원으로 환산 (참고용, 실제 결제 시점에 따라 변동).

9저장 폴더 · 파일명 형식

📁 저장 폴더 지정 (Chrome·Edge 전용)

  1. ⚙️ 설정 → 📁 저장 폴더 → [📂 폴더 선택]
  2. 네이티브 폴더 선택 다이얼로그에서 폴더 지정
  3. 이후 [⬇ PNG 다운로드] 시 그 폴더에 자동 저장 (브라우저 기본 다운로드 폴더 우회)
  4. IndexedDB 영속 — 페이지 새로고침 후에도 자동 복원, 권한은 첫 사용 시 1회 재요청
브라우저지원동작
Chrome / Edge / Opera지정 폴더 자동 저장
Firefox / Safari일반 다운로드(브라우저 기본) 자동 fallback

📝 파일명 형식 (토큰 템플릿)

다양한 정보를 토큰으로 조합한 파일명 패턴을 지정할 수 있습니다.

7개 프리셋

사용 가능한 토큰

토큰예시
{date}2026-04-28
{datetime}20260428_1430
{time}1430
{topic}당뇨병
{subtopic}자가혈당측정SMBG의중요성
{title}자료명
{category}환자 교육자료
{mode} / {mode_short}공유형 / share
{quality}medium
{format}A4 세로형 교육자료
{hospital} / {doctor} / {age}병원용 모드 정보

빈 토큰은 자동 생략, 연속 underscore 압축, 파일시스템 금지 문자 자동 치환, 100자 길이 제한.

10🎨 테마 · 폰트 크기

도구 헤더 우측 [🎨 테마] 버튼 → 드롭다운 popover에서 배경 테마 + 글자 크기를 변경할 수 있습니다.

8가지 배경 테마

구분4종특징·권장
밝은 계열파스텔 / 사쿠라 / 민트 / 바닐라밝은 배경 + 따뜻한 톤. 일상·친근한 작업 환경 (default)
어두운 계열미드나잇 / 오션 / 포레스트 / 오버진어두운 배경 + 발광 액센트. 야간 작업·눈 피로 감소

4단계 글자 크기 (S / M / L / XL + ↺ 초기화)

cross-page 자동 동기화

선택값은 portal-theme · portal-fs localStorage 키로 저장되어 다음 DrPortal 페이지와 자동 공유됩니다:

한 곳에서 고르면 모든 페이지에 자동 적용됩니다. FOUC(첫 페인트 깜빡임) 없이 즉시 적용 — 페이지 head 사전 적용 스크립트가 처리.

💡 팁 — 폰트 크기는 본문(body 기반) 텍스트만 스케일됩니다. 일부 px 하드코딩된 작은 요소(아이콘·작은 라벨)는 그대로 유지되며, 메인 콘텐츠 가독성 향상에 우선 효과.
⚠️ 다크 테마 선택 시 일부 색상 강조 영역(노란색 모드 토글 등)은 의도적으로 밝은 톤을 유지합니다 (식별성 보장).

12API 키 · 보안 정책

OpenAI API 키 저장 정책

이미지 데이터 저장 위치

데이터저장 위치지속성
OpenAI API 키sessionStorage탭 닫으면 삭제
병원 로고localStorage (hospitalId 스코프)2MB 이하 영구
저장 폴더 핸들IndexedDB영구 (권한은 1회 재요청)
파일명 템플릿localStorage영구
생성된 이미지지정 폴더 또는 Downloads (사용자 선택)파일
갤러리 기부 자료Firebase RTDB영구 (관리자 정책 적용)

병원 식별 정보 격리

13자주 묻는 질문 (FAQ)

OpenAI API 키는 어디서 받나요?

OpenAI 공식 사이트에서 본인 계정으로 발급받아야 합니다. DrPortal에서 직접 발급해 드리지 않습니다 (보안 정책).

키는 결제 정보 등록 후에 사용 가능하며, gpt-image-2는 paid 모델이라 무료 크레딧 외 결제 한도 설정이 필요합니다.

한 번 만든 자료를 다른 모드로 재생성하려면?

방법 1 — 가장 간단: 모드 토글만 변경 후 [🎨 이미지 생성] 다시 클릭. 다른 모든 옵션은 유지됩니다.

방법 2 — 미세 조정: 텍스트 자료명·키워드 등을 직접 편집한 뒤 재생성.

이미지에 한국어가 깨져요

다음을 확인해 주세요:

  • 모델이 GPT Image 2인지 (이전 1.5는 한국어 깨짐으로 제외)
  • 품질이 Medium 이상인지 (Low는 작은 텍스트가 깨질 수 있음)
  • 텍스트 밀도가 "많게"가 아닌지 (너무 많으면 모델이 쥐어짜다 깨짐)
  • 출력 형식이 너무 작은 사이즈가 아닌지 (16:9 썸네일은 텍스트 적게 권장)
저장 폴더가 설정되지 않아요 (Firefox/Safari)

File System Access API는 Chromium 기반 브라우저(Chrome·Edge·Opera)에서만 지원됩니다. Firefox/Safari는 자동으로 일반 다운로드(브라우저 기본 폴더)로 fallback 됩니다.

해당 브라우저는 [📂 폴더 선택] 버튼이 비활성 상태로 표시되며, ⚠️ 안내 박스가 함께 표시됩니다.

변형 모드와 텍스트 모드 결과 차이는?

✏️ 텍스트 기반 새 생성: 텍스트 프롬프트만으로 처음부터 새 디자인. 결과의 자유도가 크지만 원본 의도와 다를 수 있음.

🔄 첨부 이미지 변형: 첨부 이미지를 input으로 받아 재디자인. 원본 구도·핵심 메시지는 유지되며 디자인만 향상. 안정적이지만 자유도가 낮음.

같은 옵션으로 두 모드 결과를 비교 후 선택을 권장합니다.

생성된 이미지의 저작권은?

OpenAI 약관에 따라 사용자가 생성한 이미지의 권리는 사용자에게 있습니다. 단:

  • 다른 회원의 갤러리 기부 자료를 다운로드할 경우 해당 자료의 라이선스 정책에 따름
  • 병원 로고, 병원명, 의사명 등 개인·기관 식별 정보는 입력자 책임
  • 의료 자문·진단 도구로 사용하지 말 것 (어디까지나 환자 교육 시각자료)
Vision 분석이 거부됩니다 (content_policy)

OpenAI 콘텐츠 정책상 다음은 분석 거부될 수 있습니다:

  • 해부도 사진, 수술 장면, 노출이 강한 의료 사진
  • 피·상처가 직접 보이는 이미지
  • 식별 가능한 환자 얼굴 사진

해결책: 해당 부분을 가리거나 도식화된 이미지로 다시 시도. 또는 Vision 없이 텍스트 직접 입력 방법으로 우회.

다국어로 만든 자료를 갤러리 기부해도 되나요?

가능합니다. 단 공유형 모드로 만들었을 때만 기부됩니다 (병원용 모드는 차단).

다국어 자료도 한국 의료 환경에 도움이 되므로 권장합니다. 기부 시 자료명·태그는 가능하면 한국어로 입력해 다른 회원이 검색하기 쉽도록 해 주세요.

테마를 다크로 바꿨더니 일부 영역이 흰색으로 남아있어요

의도적으로 흰색을 유지하는 영역이 일부 있습니다:

  • 생성 이미지 미리보기 배경 — 의료 페이퍼 느낌 보존
  • 로고 미리보기 프레임 — 로고 식별성
  • 모드 토글 노란색 영역 — 자료 모드 강조

그 외 영역에서 가독성 문제가 있으면 알려 주세요 — 추가 보완하겠습니다.

폰트를 XL로 키웠는데 일부 글자만 안 커져요

현재 폰트 크기 토글은 본문 기반(body inheritance) 텍스트에만 적용됩니다. 다음 요소는 px 하드코딩이라 영향받지 않습니다:

  • 섹션 번호 뱃지·작은 라벨·체크박스 텍스트
  • 모달 제목·헤더 일부 요소

주요 본문(폼 라벨·입력값·결과 패널 텍스트)은 정상 스케일됩니다. 추후 라운드에서 전체 px → em/rem 변환 예정.

토큰 적립은 언제 받나요?

갤러리 기부(공유형 모드만) 시점에 즉시 적립됩니다. 추가로 다른 회원이 좋아요를 누르면 누적 적립 (좋아요 단위로 추가 토큰).

적립 내역은 사이드바 ⚡ 이지토큰 메뉴에서 확인 가능합니다.