README.md

metadata

title: Stable Diffusion WebUI
emoji: 🌸
colorFrom: pink
colorTo: purple
sdk: docker
pinned: false

🌸 Anime Diffusion WebUI

허깅페이스 스페이스에서 실행되는 애니메이션 스타일 이미지 생성기입니다.

✨ 기능

• 텍스트 → 이미지 (txt2img): 프롬프트를 입력하여 이미지 생성
• 이미지 → 이미지 (img2img): 기존 이미지를 애니메이션 스타일로 변환
• 다양한 애니메이션 모델: 8가지 인기 모델 지원
• 네거티브 프롬프트: 원하지 않는 요소 제외
• 변환 강도 조절: img2img에서 원본 유지 정도 조절
• REST API 지원: 외부 앱에서 API 호출 가능

🤖 지원 모델

모델	특징
Mistoon Anime V3 ⭐	카툰풍 애니메이션, 선명한 색상, 두꺼운 외곽선
Anything V5	가장 인기 있는 애니메이션 모델
Counterfeit V3	고품질 애니메이션/일러스트
DreamShaper V8	다양한 스타일 지원
OpenJourney V4	Midjourney 스타일
Stable Diffusion v1.5	기본 모델
MeinaMix V11	고퀄리티 애니메이션
ReV Animated	애니메이션 특화

🚀 사용법

1. 드롭다운에서 원하는 모델을 선택합니다
2. 프롬프트 입력창에 원하는 이미지를 설명합니다
3. (선택) 네거티브 프롬프트로 원하지 않는 요소를 지정합니다
4. 이미지 크기와 생성 옵션을 조절합니다
5. "🚀 이미지 생성" 버튼을 클릭합니다

💡 프롬프트 예시

1girl, solo, long blue hair, blue eyes, school uniform, 
cherry blossoms, masterpiece, best quality, detailed

⚠️ 주의사항

• CPU 모드에서는 이미지 생성에 2-5분 정도 소요됩니다
• 첫 실행 시 모델 다운로드로 추가 시간이 필요합니다
• GPU 스페이스를 사용하면 훨씬 빠른 생성이 가능합니다

🔌 REST API 사용법

이 프로젝트는 웹 인터페이스뿐만 아니라 REST API도 제공합니다.

1. 텍스트 → 이미지 API (txt2img)

• 엔드포인트: POST /api/generate
• 본문 구조 (JSON):

{
  "prompt": "생성할 프롬프트 (필수)",
  "negative_prompt": "제외할 태그 (선택)",
  "model_name": "사용할 모델 이름 (선택)",
  "width": 512,
  "height": 512,
  "num_inference_steps": 25,
  "guidance_scale": 7.5,
  "seed": -1
}

2. 이미지 → 이미지 API (img2img)

• 엔드포인트: POST /api/img2img
• 본문 구조 (JSON):

{
  "image_base64": "Base64로 인코딩된 입력 이미지 (필수)",
  "prompt": "변환할 스타일 프롬프트 (필수)",
  "negative_prompt": "제외할 태그 (선택)",
  "model_name": "사용할 모델 이름 (선택)",
  "strength": 0.75,
  "num_inference_steps": 25,
  "guidance_scale": 7.5,
  "seed": -1
}

3. Python 호출 예제 (txt2img)

import requests
import base64

url = "https://your-space.hf.space/api/generate"
payload = {
    "prompt": "1girl, anime, long hair, masterpiece",
    "negative_prompt": "bad anatomy, blurry",
}

response = requests.post(url, json=payload)
data = response.json()

if data["success"]:
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(data["image_base64"]))

4. Python 호출 예제 (img2img)

import requests
import base64

# 이미지를 Base64로 인코딩
with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

url = "https://your-space.hf.space/api/img2img"
payload = {
    "image_base64": image_base64,
    "prompt": "anime style, colorful, masterpiece",
    "strength": 0.75
}

response = requests.post(url, json=payload)
data = response.json()

if data["success"]:
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(data["image_base64"]))

🛠️ 기술 스택

• FastAPI / Uvicorn - REST API 서버
• Gradio - 웹 인터페이스
• Diffusers - 허깅페이스 디퓨전 라이브러리
• Docker - 컨테이너 환경
• PyTorch - 딥러닝 프레임워크