📘 사용자 매뉴얼 · BETA

LesionCard Studio 사용 안내

검사 영상(초음파·내시경·X-ray·심전도)을 ChatGPT Images 2.0으로 분석하여 환자 교육용 병변 위치 설명 카드를 자동 생성하는 도구입니다. 프롬프트 입력 없이 버튼·체크박스 선택만으로 의료 인포그래픽을 만들 수 있습니다.

1영상 첨부

2옵션 선택

3모델·품질

4프롬프트 확인

5생성·다운로드

📋 목차

1. 이 도구는 무엇인가요? 2. 시작하기 (API 키 등록) 3. 입력 영상 첨부 4. 검사 종류 선택 5. 병변/소견 hint (선택) 6. 표현 방식·레이아웃 7. AI 모델·품질·비용 8. 프롬프트 모달 활용 9. 영어/한국어 두 버전 비교 10. 결과 다운로드 / 변형 11. 환자 정보(PII) 보호 12. 자주 묻는 질문 (FAQ) 13. 향후 업데이트 계획

1 이 도구는 무엇인가요?

LesionCard Studio는 진료 후 환자에게 "이 영상의 어디에 어떤 병변이 있다"를 쉽게 설명할 수 있도록 위치 설명 카드를 자동으로 만들어 주는 AI 도구입니다.

🎯 어떤 결과가 나오나요?

다음 같은 형태의 카드가 한 장 나옵니다 (1024×1024 등 선택 가능):

📑 좌측: 원본 검사 영상 + 화살표·라벨(병변·간·담낭 등)
🎨 우측: 해부학 일러스트 + 병변 위치 zoom-in inset
📋 하단: 검사 정보 요약 (검사 부위 / 위치 / 측정값 / 진료 안내)
💬 Footer: 안심 banner (예: "초음파 영상은 병변의 위치와 크기 확인에 도움을 줍니다.")

🔧 지원하는 검사 5종

대장내시경 — 폴립(Paris 분류)·선종·암·게실증·염증성 장질환 등
위내시경 — 위궤양(Forrest)·위암(Borrmann)·바렛 식도·역류성 식도염 등
흉부촬영 — 폐 결절·경화·흉수·기흉·심비대·무기폐 등
심전도(EKG) — STEMI·심방세동·심실빈맥·방실차단·각차단 등
초음파 — 간/담낭/신장/갑상선/유방 — 낭종·결절·결석·종양 등

🆚 환자 교육자료 생성기와의 차이?

환자 교육자료 생성기 — 질환 자체에 대한 교육 텍스트·일러스트 (고혈압·당뇨 등)
LesionCard Studio — 특정 환자의 실제 검사 영상을 분석하여 이번 검사의 결과를 설명하는 카드

2 시작하기 — OpenAI API 키 등록

LesionCard Studio는 OpenAI 이미지 생성 API를 사용합니다. 본인의 개인 API 키를 한 번 등록하면 다음 방문 시 자동 복원됩니다.

1상단 헤더의 ⚙️ 설정 버튼 클릭

설정 모달이 열리며 키 입력칸이 표시됩니다.

2OpenAI 키 입력 (sk-...로 시작)

OpenAI Platform 계정에서 발급받은 본인 키. "sk-"로 시작하는 형식.

3💾 저장 버튼 클릭

두 곳에 저장됩니다 — 세션(현재 탭) + 영구 백업(이 브라우저). 다음 방문 시 자동 복원.

⚠ 공용 PC 사용 시 사용 후 반드시 ⚙️ 설정 → 🗑 키 삭제로 영구 백업까지 함께 제거하세요. 세션은 탭 종료 시 자동 삭제되지만, 영구 백업은 명시적 삭제 필요합니다.

💡 키 발급 안내 — OpenAI Platform 계정에서 결제 정보 등록 후 API 키 발급 가능. LesionCard Studio는 사용량에 따라 본인 OpenAI 계정으로 직접 과금됩니다 (이미지 1장 약 $0.05~0.21).

3 입력 영상 첨부 (선택)

좌측 패널 맨 위 "📷 입력 영상" 카드에 검사 영상을 첨부합니다. 미첨부 시 텍스트만으로 일반 일러스트 카드를 생성합니다.

📥 3가지 입력 방식

드래그&드롭 — 파일을 카드 위로 드래그
클릭하여 선택 — 카드 클릭 → 파일 선택 다이얼로그
Ctrl+V 붙여넣기 — 클립보드의 이미지 (스크린샷·캡처 등) 붙여넣기

🔒 PII 자동 가림 (기본 활성)

의료 영상은 보통 상단에 환자 이름·진료번호·생년월일이 표시됩니다. LesionCard Studio는 상단 10%를 자동으로 검정 처리하여 OpenAI에 PII가 전송되지 않도록 합니다.

미리보기는 처리된 결과를 표시 — 전송될 모습 그대로 확인 가능
토글 OFF 시 원본 그대로 전송 (사용자 책임)
GE LOGIQ P9 등 일반 의료 기기 헤더는 대부분 가려짐

⚠ PII 보호는 사용자 책임 — 자동 가림은 상단 10%만 처리합니다. 환자 정보가 영상의 다른 위치(예: 측면·하단)에 있다면 전송 전 직접 가리거나 트리밍해야 합니다.

📊 지원 파일 / 크기

이미지 형식: JPG / PNG / WebP / BMP 등 (브라우저가 지원하는 모든 이미지)
최대 파일 크기: 20 MB

4 검사 종류 선택 (필수)

좌측 "1. 검사 선택" 카드에서 5종 중 하나를 클릭합니다.

검사	대표 장기	대표 라벨
대장내시경	대장	병변(용종)·점막·대장 주름·혈관 패턴
위내시경	식도·위·십이지장	병변·위 점막·위주름·식도-위 접합부
흉부촬영	폐·심장	병변·폐·심장·갈비뼈·횡격막
심전도	심장	이상소견·P파·QRS·ST 분절·T파·해당 lead
초음파	간·담낭·신장·갑상선·유방	병변·간·담낭(쓸개)·췌장·신장·비장

💡 검사 선택의 효과 — 검사 종류에 따라 카드 제목·헤더 텍스트·라벨 후보·검사별 세부 옵션 탭이 자동 변경됩니다. 예: 초음파 선택 → "초음파 병변 위치 설명 카드", 검사별 옵션 탭에 "스캔 방향·장기 도식·segment·질감" 표시.

5 병변/소견 hint (선택사항)

좌측 "2. 병변/소견" 카드의 6개 항목은 모두 체크박스로 토글됩니다. 체크된 항목만 프롬프트에 포함되고, 미체크 항목은 ChatGPT가 영상을 보고 직접 판단합니다.

🤖 영상 분석 검증 모드 (모두 해제, 기본값)

모든 체크박스 해제 시 ChatGPT가 입력 영상만 보고 자체 분석
장기·병변 종류·위치를 AI가 직접 판단
👨‍⚕️ AI의 영상 판독 능력을 확인하고 싶을 때 적합

📌 Hint 부여 모드 (일부 또는 전부 체크)

체크한 항목만 프롬프트에 "Clinical hint" 라인으로 추가
예: 장기만 체크 → "organ: 간 (liver)" 만 hint로 전달
병변 유형까지 체크 → "lesion type: 단순낭종 (simple liver cyst)" 추가
크기 hint 체크 시 측정값 bullet에도 자동 채움

⚠ 주의 — Hint vs 영상 충돌 시 AI에게 "사용자 hint를 참고하되 실제 영상과 충돌 시 영상을 우선"이라고 지시되어 있습니다. 영상에 명백히 다른 소견이 있으면 AI가 영상을 우선합니다.

🎁 추가 자동 채움 (장기 hint 활성 시)

장기 체크박스를 켜면 다음이 자동으로 프롬프트에 채워집니다:

Subtitle: "[해부 부위] [장기 별명] 부위 병변 위치 안내" — 예: "우상복부 담낭(쓸개) 부위..."
캡션: 장기별 정확한 한국어 캡션 — 예: "병변은 간 아래쪽의 담낭(쓸개) 부위에서 관찰됩니다."
해부 일러스트 묘사: 인접 해부 자동 추가 — "liver and gallbladder with adjacent pancreas"
검사 한정어: "ultrasound" → "abdominal ultrasound" / "thyroid ultrasound" 등
라벨 별명 추가: 일반 라벨 + 별명 (담낭·쓸개 등) 자동 포함

6 표현 방식 · 레이아웃 · 강조

👤 대상 독자

환자용 — 친절·안심되는 톤, 한국어 위주 + 의학용어 괄호 병기
보호자용 — 실용적, 짧은 돌봄 가이드 힌트 포함
의료진용 — 임상 전문 용어, 정확한 해부, 간결

🎨 시각 스타일 4종

스타일	색상 팔레트	적합 상황
클린 메디컬	blue·teal·white·light gray	병원 공식 자료, 환자 대기실 게시 (권장)
심플 일러스트	파스텔, 부드러운 음영	아동·고령 환자, 가족 친화적 자료
전문 인포그래픽	딥 블루·청록·warm gray	학술 자료, 의료진 발표용
실사 혼합	사실적 anatomy + 임상 사진	판독 컨퍼런스, 정밀 비교

📐 레이아웃 4종

레이아웃	크기	적합 용도
1:1 카드	1024×1024	SNS·메신저 공유
4:5 카드뉴스	1024×1536	인스타그램·카카오 채널
16:9 썸네일	1536×1024	유튜브·블로그 썸네일
A4 교육자료	1024×1536	인쇄 배포·차트 첨부 (권장)

✨ 강조 방식 (5종 체크박스)

병변 색상 강조 — 눈에 띄는 색상으로 병변 표시
윤곽선 강조 — 병변 경계를 선명한 선으로
위치 포인터 — 화살표 + 리더 라인
해부도 오버레이 — 장기 도식 위에 위치 표시
핵심 라벨 배치 — 중요 라벨만 깔끔히

📦 포함 요소 (6종 체크박스)

해부학 위치 라벨 / 검사 이미지 미니뷰 / 화살표 / 한줄 요약 / 병변 확대뷰 / 주의문구 — 카드에 어떤 요소를 포함할지 선택.

📋 검사별 세부 옵션 탭

선택한 검사에 따라 자동 활성화. 예시:

초음파: 스캔 방향·장기 도식·segment·질감 반영
대장내시경: Paris 분류·NICE 분류·뷰 종류·해부도식
위내시경: 관찰 위치·해부도식·영상강화(NBI/BLI)·거리
흉부촬영: 촬영 자세(PA/AP/Lateral)·폐야 구분·silhouette·해부 라벨
심전도: 주요 lead·레이아웃·기록 속도·gain

7 AI 모델 · 품질 · 비용

우측 미리보기 패널의 "🤖 AI 모델" 영역에서 모델·품질을 선택합니다.

🤖 두 모델 비교 (2026-04 기준)

모델	출시	출력 단가	특징
gpt-image-2 NEW	2026-04	$30 / 1M tok	최신·최고 품질. 다국어 텍스트, 인포그래픽 안정성 우수
gpt-image-1.5	2025-12	$32 / 1M tok	안정·균형. gpt-image-2 대비 약간 저렴, 충분한 품질

⚡ 품질 3단계

품질	출력 토큰 (1024×1024)	1장 비용	적합 상황
Low	~200 tok	~$0.006 (≈ 8원)	대량 초안·미리보기
Medium	~1,767 tok	~$0.053 (≈ 73원)	일상 환자 카드 (권장)
High	~7,033 tok	~$0.211 (≈ 291원)	최종 인쇄·중요 자료

💸 비용 절약 팁 — 초안을 medium으로 4장 빠르게 생성 → 마음에 드는 1장만 high로 재생성하면 가성비가 가장 좋습니다.

📊 실시간 비용 미리보기

모델·품질·레이아웃을 선택하면 우측 패널 하단에 다음이 자동 표시됩니다:

출력 토큰 수
예상 비용 ($ + 원, 환율 1380원 가정)
예상 응답 시간 (초)

8 프롬프트 확인/수정 모달

"✨ 카드 생성" 또는 "🔀 변형 4개 만들기" 클릭 시, 자동 생성된 프롬프트가 모달로 떠서 사용자가 직접 확인·수정할 수 있습니다. ChatGPT는 이 프롬프트를 그대로 받아 이미지를 생성합니다.

🌐 두 탭 — 영어 / 한국어

🇺🇸 영어 버전 (기본·권장) — OpenAI 모델 학습 데이터 비율이 더 높아 일반적으로 안정적
🇰🇷 한국어 버전 — 한국어 라벨·뉘앙스가 더 자연스럽지만 모델별 응답 편차 가능

📝 모달 내 정보

상단 메타 — 모드(images.edits / images.generations), 모델, 품질, 사이즈, 장수, 예상 비용·시간
편집 textarea — 자유롭게 프롬프트 수정 가능 (글자 수 카운터)
한국어 요약 — 사용자 옵션 요약 (참고용)

🔘 4가지 액션 버튼

버튼	동작
🔄 자동 복원	편집 내용 버리고 자동 생성된 프롬프트로 reset
✓ 한국어로 생성	한국어 프롬프트로 1회 호출
🔀 두 버전 비교	영어·한국어 동시 호출 (×2 비용) → 좌우 비교
✓ 영어로 생성	영어 프롬프트로 1회 호출 (기본·권장)

💡 안정성 강화 문구 자동 부착 — 입력 영상 모드일 때 프롬프트 끝에 "Use the uploaded image directly...", "Do not alter the core lesion location..." 등 4줄이 자동 추가되어 결과 안정성이 향상됩니다.

9 영어 / 한국어 두 버전 비교

같은 옵션을 영어와 한국어 두 프롬프트로 동시에 생성하여 결과를 비교할 수 있습니다.

🔀 사용 방법

1옵션 선택 후 ✨ 카드 생성 클릭

2모달에서 영어/한국어 탭 확인 (필요 시 편집)

3🔀 두 버전 비교 클릭 → 확인 다이얼로그

비용이 ×2 (또는 변형 4개 모드면 ×8)임을 안내

4병렬 생성 → 좌우 그리드 결과

🇺🇸 EN 라벨이 좌, 🇰🇷 KO가 우. 마음에 드는 이미지 클릭하면 큰 화면으로 전환.

💡 어느 쪽이 좋을까? 일반적으로 영어 버전이 안정적이지만, 특정 한국 의료 용어(담낭·쓸개·결석 등)는 한국어 버전이 더 자연스럽게 라벨링되는 경우가 있습니다. 처음 사용 시 "두 버전 비교"로 본인 워크플로에 맞는 언어를 결정한 뒤 그 언어로 본 작업을 진행하시는 것을 권장합니다.

10 결과 다운로드 / 변형 / 재생성

🍩 도넛 진행률

호출 시 우측 미리보기 영역에 도넛형 진행률이 시계 반대 방향으로 채워집니다.

0% → 92%까지 추정 시간 기반 점진 (ease-out)
응답 도착 시 100% (그린 + ✓)
실패 시 0% (빨강 + ✗)
완료 후 0.7초 뒤 자동 숨김 → 결과 표시

🖼 결과 표시 모드

단일 생성 — 큰 이미지 1장 + 액션 버튼
변형 4개 — 2×2 그리드, 클릭하면 큰 화면
두 버전 비교 — 좌우 1×2 그리드, 클릭하면 큰 화면

🔘 결과 액션 버튼

📥 다운로드 — PNG 파일로 자동 저장 (파일명에 검사 종류·병변·타임스탬프 자동)
🔄 재생성 — 같은 옵션으로 다시 생성
🔀 변형 4개 — 같은 옵션으로 4장 비교

11 환자 정보(PII) 보호 정책

🔒 자동 보호 장치

상단 10% 자동 가림 — 영상 첨부 시 Canvas로 상단 10%를 검정 처리하여 환자 이름·진료번호·생년월일 영역 차단
프롬프트 명시 지시 — "DO NOT display any patient identifiers (name, ID, date of birth) even if visible in the input image"
키 세션 분리 — OpenAI API 키는 사용자 본인 sessionStorage에 저장 (외부 서버 미전송)

👨‍⚕️ 사용자 책임 영역

자동 가림은 상단 10%만 처리합니다. 다음 경우는 사용자가 직접 처리하셔야 합니다:

환자 정보가 영상의 측면·하단·모서리에 표시되는 경우
영상 안에 환자 ID가 워터마크로 들어간 경우
환자 정보가 캡션 텍스트로 함께 캡처된 경우

→ 첨부 전에 그래픽 도구로 직접 가리거나 트리밍하시기 바랍니다.

📤 OpenAI 정책

OpenAI는 API로 전송된 데이터를 모델 학습에 사용하지 않습니다 (기본 정책). 그러나 의료 데이터의 민감성을 고려하여 환자 식별 정보는 항상 가린 상태로 전송하시기를 권장합니다.

12 자주 묻는 질문 (FAQ)

Q입력 영상 없이도 카드를 만들 수 있나요?›

네. 영상 미첨부 시 images.generations 모드로 자동 전환되어 일반 일러스트 카드가 생성됩니다. 이 경우 좌측 패널에 실제 영상 대신 일반 검사 일러스트가 그려집니다.

Q한 번에 비용이 얼마나 나오나요?›

기본값 (gpt-image-2 medium 1024×1024) 기준 $0.053 (~73원)입니다. High 품질은 약 4배(~291원), 변형 4개는 ×4, 두 버전 비교는 ×2 추가됩니다. 모달 상단 "예상 비용" 라인에서 정확한 값을 미리 확인하세요.

Q생성 시간은 얼마나 걸리나요?›

Low: 약 6초
Medium: 약 10–15초
High: 약 18–22초

입력 영상 분석 모드는 약 1.4배 추가, 변형 4개는 √4=2배 가중. 도넛 진행률에 추정 시간이 표시됩니다.

Q결과가 마음에 들지 않으면 어떻게 하나요?›

몇 가지 시도해 보세요:

🔄 재생성 — 같은 옵션으로 다시 (AI는 매번 다른 결과를 생성)
🔀 변형 4개 — 4장 중 가장 좋은 것 선택
모달에서 프롬프트 직접 편집 — 특정 라벨·색상·구도 추가 지시
품질을 high로 변경 — 디테일·텍스트 정확도 향상
장기 hint 체크 — 자동 분석에서 정답이 안 나오면 사용자가 명시

Q한국어 라벨이 깨져서 나옵니다.›

gpt-image-2는 한국어 텍스트 렌더링이 일반적으로 잘 됩니다. 그래도 문제 있으면:

품질을 medium 이상으로 — Low 품질은 텍스트 렌더링이 부정확할 수 있음
"두 버전 비교"로 어느 쪽이 한국어를 더 잘 렌더링하는지 확인
안정성 강화 문구의 "Keep all Korean labels crisp and medically neat"가 자동 포함됨

QAPI 키를 매번 입력해야 하나요?›

아닙니다. 한 번 저장하면 다음 방문 시 자동 복원됩니다.

세션 슬롯 (drportal_ai_keys): 탭 사용 중 유지 — DrPortal 표준
영구 백업 (lcs_openai_backup): 다음 방문 시 자동 복원 — LesionCard 전용

공용 PC에서는 사용 후 ⚙️ 설정 → 🗑 키 삭제 권장.

Q"+ 새 카드 만들기" 버튼은 무엇을 초기화하나요?›

입력 영상·검사·병변/소견 hint·표현 방식·레이아웃·강조·검사별 옵션·모델·품질·결과·미리보기를 모두 초기값으로 되돌립니다. OpenAI API 키는 유지됩니다 (편의성).

Q변형 4개와 두 버전 비교를 동시에 할 수 있나요?›

네. 🔀 변형 4개 만들기 클릭 → 모달에서 🔀 두 버전 비교 선택 시 영어·한국어 각 4장씩 총 8장이 생성됩니다 (×8 비용). 확인 다이얼로그가 다시 한 번 묻습니다.

Q결과 이미지를 PDF로 만들 수 있나요?›

현재는 PNG 다운로드만 지원합니다. PDF 변환은 향후 업데이트 예정 (브라우저에서 PNG → PDF 인쇄로 임시 가능).

QNEW 배지는 언제 사라지나요?›

홈 사이드바의 "NEW" 빨간 배지는 등록일(2026-04-27)로부터 7일 후인 2026-05-04 자정에 자동 숨김됩니다.

13 향후 업데이트 계획

LesionCard Studio는 현재 베타 단계로, 다음 업데이트가 순차 진행됩니다.

✓ 완료 (2026-04-27)

v1.0 베타 출시

5개 검사 · gpt-image-2/1.5 · 양식 자동 프롬프트 · 영어/한국어 두 버전 비교 · PII 자동 가림

⌛ 다음

템플릿 라이브러리

자주 사용하는 옵션 조합을 템플릿으로 저장 · Firebase RTDB 연동 · 1클릭 재사용

⌛ 다음

생성 이력 관리

사용자별 최근 생성 이력 저장 · 환자별 카드 모아보기 · 다시 생성 / 다운로드

📋 검토 중

DICOM 직접 입력

PACS 연동으로 DICOM 파일을 직접 첨부 (현재는 PNG/JPG 변환 후 첨부)

📋 검토 중

PDF 일괄 출력

생성된 카드 + 환자 정보를 A4 PDF로 일괄 출력 (인쇄·첨부용)

📋 검토 중

검사별 데이터 확장

현재 5개 검사 외에 MRI·CT·치과·안과 영상 추가

📋 검토 중

한국어 무료 공용 키

DrPortal 공용 OpenAI 프록시 (현재 Gemini만 운영) — 비용 부담 없는 시범 사용

📋 검토 중

관리자 통계 대시보드

사용량·검사 종류 분포·인기 옵션 분석 (관리자 전용)

💡 사용자 피드백 환영 — 사용 중 불편한 점·추가 기능 요청·잘못된 결과 등은 💬 요청사항 게시판에서 알려주세요. 반영된 요청에는 이지토큰 메달이 부여됩니다.