README.md

metadata

title: 퀀 이미지 편집기
emoji: ✒️
colorFrom: pink
colorTo: green
sdk: gradio
sdk_version: 5.43.1
app_file: app.py
pinned: false
license: apache-2.0
python_version: 3.11

퀀 이미지 편집기 (Qwen Image Editor)

이 앱은 Qwen-Image-Edit 모델을 사용한 한국어 이미지 편집기입니다.

한국어 로컬라이제이션 변경사항

이 프로젝트는 완전히 한국어로 로컬라이제이션되었습니다:

UI 컴포넌트

• 제목: "퀀 이미지 편집기" (로고 + 텍스트)
• 이미지 업로드 영역: "이미지를 여기로 끌어다 놓으세요 - 또는 - 업로드하려면 클릭하세요"
• 프롬프트 입력: "편집 지시사항을 설명해주세요" (플레이스홀더)
• 버튼: "편집!" (실행 버튼)
• 고급 설정 섹션: "고급 설정"

설정 옵션

• 시드: "시드" 및 "시드 랜덤화"
• 가이던스 스케일: "가이던스 스케일"
• 추론 단계: "추론 단계 수"
• 프롬프트 재작성: "프롬프트 재작성"

예시 섹션 (개선된 사용자 제어)

• 섹션 제목: "예시"
• 디자인: 깔끔한 Gradio 기본 예시 레이아웃 사용
• 인터랙션 방식:
  • 예시 클릭 → 이미지와 한국어 프롬프트가 필드에 입력됨
  • 자동 실행 없음 → 사용자가 "편집!" 버튼을 수동으로 클릭해야 생성 시작
  • 내부 처리 시 한국어 프롬프트가 자동으로 영어로 번역되어 AI 처리
• 예시 프롬프트들 (표시: 한국어만, 처리: 영어 자동 번역):
  1. "텍스트를 'COOL NEON SIGN HERE'으로 변경해주세요"
  2. "고양이가 전통 한국 한복을 입고 있는 모습으로 만들어 주세요"
  3. "사진 스타일을 빈티지 만화책 스타일로 바꿔주세요"

기술적 변경사항

코어 기능

• 로고: Hugging Face resolve URL을 사용하여 로컬 logo.png 파일 참조
• 정적 파일 서빙: gr.set_static_paths() 추가
• 설명 텍스트: GitHub 링크 및 사용 안내를 한국어로 번역
• GPU 타임아웃: 180초(3분)로 설정하여 안정적인 처리 보장
• 에러 핸들링: 예외 발생 시 원본 이미지 반환 및 재시도 로직 개선
• 다운로드 형식: PNG 형식으로 설정하여 더 나은 이미지 품질 제공
• AI 프롬프트 최적화: DashScope API를 통한 자동 프롬프트 번역 및 개선, 하드코딩된 번역 매핑 제거

사용자 인터페이스 개선

• 시드 랜덤화: 기본값으로 활성화되어 매번 다른 결과 생성, 일관된 UI/함수 동작 보장
• 레이아웃 개선: 프롬프트 필드 전체 너비 활용, 편집 버튼을 아래로 배치
• 이미지 박스 최적화: 400px 높이로 증가, 양쪽 박스 크기 일치
• 사용자 제어 향상: 예시 클릭 시 자동 실행 방지, 2단계 제어 (필드 채우기 → 수동 실행)
• 컴팩트 인터페이스: 작은 크기의 편집 버튼과 인라인 사용 설명으로 화면에 맞는 컴팩트한 레이아웃
• 중복 제거: 반복되는 사용 방법 설명을 제거하여 인터페이스 길이 단축
• 가로 레이아웃 최적화: 편집 버튼과 고급 설정을 같은 줄에 배치하여 세로 공간 절약
• 사용 안내 개선: 프롬프트 필드 하단에 명확한 한 줄 사용 안내 메시지 배치
• 예시 표시 단순화: 한국어만 표시하여 인터페이스 가독성 향상, 사용 안내 메시지를 예시 위로 이동

다국어 지원

• 한국어-영어 하이브리드: 한국어 UI 표시와 영어 처리의 최적 조합
• AI 자동 번역 시스템: 모든 한국어 프롬프트가 DashScope API를 통해 자동으로 영어로 번역 및 최적화되어 AI 처리
• 깔끔한 예시 인터페이스: Gradio 표준 예시 컴포넌트 활용으로 친숙하고 깔끔한 UI
• 선택적 실행: 예시 클릭으로 필드만 채워지고 수동 실행으로 사용자 제어 강화

사용자 워크플로우

기본 사용 방법

1. 이미지 업로드: 왼쪽 박스에 이미지를 끌어다 놓거나 클릭하여 업로드
2. 프롬프트 입력: 편집 지시사항을 한국어 또는 영어로 입력
3. 설정 조정 (선택사항): 고급 설정에서 시드, 가이던스 스케일 등 조정
4. 생성 실행: "편집!" 버튼 클릭하여 이미지 편집 시작

예시 활용 방법

1. 예시 선택: 하단 예시 섹션에서 원하는 예시 클릭
2. 자동 입력: 이미지와 한국어 프롬프트가 자동으로 필드에 입력됨
3. 프롬프트 수정 (선택사항): 필요시 한국어 또는 영어로 프롬프트 내용 수정
4. 수동 실행: "편집!" 버튼을 직접 클릭하여 생성 시작
5. 자동 번역: 한국어 프롬프트는 처리 시 자동으로 영어로 번역됨

고급 기능

• 프롬프트 재작성: DashScope API를 통한 자동 프롬프트 개선
• 시드 제어: 재현 가능한 결과를 위한 시드값 고정
• 단계별 조정: 추론 단계 수와 가이던스 스케일 세부 조정

원본 모델 정보

자세한 내용은 Qwen-Image 시리즈를 참조하세요. Qwen Chat에서 체험하거나 모델을 다운로드하여 ComfyUI나 diffusers로 로컬에서 실행할 수 있습니다.

---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference