Google TranslateGemma-4B 모델 기반 다국어 번역 웹 서비스
한국어, 영어, 일본어, 중국어, 스페인어, 프랑스어, 독일어, 러시아어, 포르투갈어, 이탈리아어, 아랍어, 베트남어, 태국어, 인도네시아어, 네덜란드어 (15개)
- 텍스트 번역
- 이미지 내 텍스트 추출 및 번역
- REST API 제공
- Docker & Docker Compose
- NVIDIA GPU (CUDA 12.8+)
- 최소 8GB VRAM
# 백그라운드 실행
docker-compose up -d --build
# 로그 확인
docker-compose logs -f
# 중지
docker-compose down- 웹 UI: http://localhost:8002
- API 문서: http://localhost:8002/docs
- 헬스 체크: http://localhost:8002/api/health
# 텍스트 번역
curl -X POST http://localhost:8002/api/translate \
-H "Content-Type: application/json" \
-d '{"text": "Hello, world!", "source_lang": "EN", "target_lang": "KO"}'
# 이미지 번역
curl -X POST http://localhost:8002/api/translate/image \
-F "file=@image.png" \
-F "source_lang=EN" \
-F "target_lang=KO"| 변수 | 기본값 | 설명 |
|---|---|---|
| TRANSLATOR_MODEL_ID | google/translategemma-4b-it | 모델 ID |
| TRANSLATOR_MAX_NEW_TOKENS | 512 | 최대 생성 토큰 |
| TRANSLATOR_LOG_LEVEL | INFO | 로그 레벨 |
| HUGGING_FACE_HUB_TOKEN | - | HF 토큰 (선택) |
- Backend: FastAPI, PyTorch, Transformers
- Frontend: HTML/CSS/JavaScript
- Infra: Docker, Gunicorn
이 프로젝트의 코드는 MIT License를 따릅니다.
이 서비스는 Google의 TranslateGemma-4B 모델을 사용합니다. 모델 사용 시 Gemma Terms of Use 및 Prohibited Use Policy를 준수해야 합니다.