README.md

---
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 시리즈](https://github.com/QwenLM/Qwen-Image)를 참조하세요. 
[Qwen Chat](https://chat.qwen.ai/)에서 체험하거나 [모델을 다운로드](https://huggingface.co/Qwen/Qwen-Image-Edit)하여 ComfyUI나 diffusers로 로컬에서 실행할 수 있습니다.

---

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

<!-- Force restart -->