API 키 설정
Transy에서 AI 번역을 사용하려면 Gemini API 키가 필요합니다. 이 가이드에서는 API 키 발급 방법과 앱에 등록하는 방법을 안내합니다.
Gemini API란?
Google에서 제공하는 AI 서비스입니다. Transy는 Gemini API를 사용하여 번역, TTS(음성 변환) 등의 기능을 제공합니다.
Gemini의 장점
| 장점 | 설명 |
|---|---|
| 무료 티어 | 매일 무료로 사용 가능한 할당량 제공 |
| 빠른 속도 | 응답 속도가 빠름 |
| 다양한 모델 | 용도에 맞는 여러 모델 선택 가능 |
| 한국어 지원 | 한국어 번역 품질이 우수함 |
Gemini API 키 발급
1단계: Google AI Studio 접속
- Google AI Studio에 접속
- Google 계정으로 로그인
2단계: API 키 생성
- 좌측 메뉴에서 “Get API key” 클릭
- “Create API key” 버튼 클릭
- 프로젝트 선택 (없으면 새로 생성)
- 생성된 API 키 복사
주의: API 키는 한 번만 표시됩니다. 안전한 곳에 저장해 두세요.
무료 티어 정보
Gemini API는 무료 티어를 제공합니다. 무료 사용량은 모델마다 다르며, Google 정책에 따라 변경될 수 있습니다.
무료 티어 확인 방법
최신 무료 티어 정보는 Google AI 공식 페이지에서 확인하세요:
무료 티어 한도 (2026년 2월 기준)
| 모델 | 분당 요청 (RPM) | 일일 요청 (RPD) | 분당 토큰 (TPM) |
|---|---|---|---|
| Gemini 2.5 Flash (앱 기본) | 10 | 250 | 250,000 |
| Gemini 2.5 Flash-Lite | 15 | 1,000 | 250,000 |
| Gemini 2.5 Pro | 5 | 100 | 250,000 |
| Gemini 2.0 Flash | 무료 | 무료 | 250,000 |
| Gemini 2.0 Flash-Lite | 무료 | 무료 | 250,000 |
| Gemini 3 Flash Preview | 무료 | 무료 | - |
| Gemma 3 27B | 완전 무료 | 완전 무료 | - |
팁: 앱 기본 모델인 Gemini 2.5 Flash는 무료 티어에서 일일 250회까지 사용 가능합니다. 일반적인 소설 읽기에 충분합니다.
참고: 2025년 12월 7일에 Google이 무료 티어를 50-80% 축소했습니다. Gemini 3 Pro Preview는 무료 티어가 없습니다.
※ 무료 한도는 Google 정책에 따라 변경될 수 있습니다.
앱에서 API 키 등록
설정 화면 진입
- 앱 실행 후 라이브러리 화면에서 우측 상단 설정(톱니바퀴) 아이콘 클릭
- 설정 화면에서 “API 키 관리” 섹션 확인
설정 화면 구성:
- 상단 바: “설정” 타이틀과 뒤로가기 버튼
- 스크롤 가능한 섹션들: 프리미엄, API 키 관리, 번역 설정 등
- 하단 저장 버튼: 전체 너비의 OutlinedButton
API 키 추가
“API 키 관리” 섹션에서:
- “API 키 추가” 버튼 클릭
- 다이얼로그에서 별칭, API 키, 제공자(Gemini) 입력
- “저장” 클릭
키 검증
저장 시 자동으로 API 키가 유효한지 검증합니다.
- 성공: 키가 정상적으로 등록됨
- 실패: 키가 잘못되었거나 만료됨
여러 API 키 관리
Transy는 여러 개의 API 키를 등록하고 관리할 수 있습니다.
용도
- 개인용/업무용 키 분리
- 여러 프로젝트의 키 관리
- API 설정 체인 구성 (하나가 실패하면 다른 것 사용)
키 관리
등록된 API 키 목록이 카드 형태로 표시됩니다:
- 편집: 별칭 수정
- 삭제: 사용하지 않는 키 제거
- 사용량 확인: “사용량 통계 보기” 버튼으로 API 호출 통계 확인
사용 가능한 모델
Transy에서 사용할 수 있는 Gemini 모델입니다.
텍스트 모델 (번역/전처리용)
| 모델 | 특징 | 추천 용도 |
|---|---|---|
| Gemini 2.5 Flash | 빠르고 경제적 (앱 기본값) | 일반 번역, 대부분의 사용자 |
| Gemini 2.5 Pro | 높은 품질 | 고품질 번역이 필요할 때 |
| Gemini 2.5 Flash-Lite | 매우 빠름, 저비용 | ⚠️ 비추천 (줄바꿈 버그) |
| Gemini 3 Pro Preview | 최신 모델 (실험적, 유료 전용) | 최고 품질 번역 |
| Gemini 3 Flash Preview | 최신 모델 (실험적) | 최신 기능 테스트 |
| Gemini 2.0 Flash | 안정적인 이전 버전 | 안정성 중시 |
| Gemini 2.0 Flash-Lite | 가벼운 이전 버전 | 빠른 처리 |
| Gemma 3 27B | 오픈소스 모델 | 완전 무료 |
TTS 모델 (음성 변환용)
| 모델 | 특징 |
|---|---|
| Gemini 2.5 Flash TTS | 기본 TTS 모델 (권장) |
| Gemini 2.5 Pro TTS | 고품질 TTS |
어떤 모델을 선택해야 할까요?
처음 사용하시는 분
Gemini 2.5 Flash (앱 기본 모델)을 사용하세요.
- 빠르고 품질도 좋음
- 무료 티어 사용 가능 (일 250회)
- 대부분의 소설 번역에 적합
- 가성비가 우수함
번역 품질이 중요한 분
Gemini 3 Flash Preview 또는 Gemini 2.5 Pro를 선택하세요.
- 더 자연스러운 번역
- 문맥 이해력이 뛰어남
- 비용이 더 높음
- 속도는 조금 느림
저비용으로 많이 읽고 싶은 분
Gemini 2.0 Flash 또는 Gemma 3 27B를 선택하세요.
- 비용이 가장 저렴 (Gemma는 완전 무료)
- 무료 티어가 관대함
- 기본적인 번역 품질 제공
주의: Gemini 2.5 Flash-Lite는 줄바꿈이 무한 생성되는 버그가 있어 사용을 비추천합니다.
문제 해결
“API 키가 유효하지 않습니다”
- 키를 복사할 때 앞뒤 공백이 포함되지 않았는지 확인
- 키가 만료되거나 삭제되지 않았는지 확인
- Google AI Studio에서 키 상태 확인
“할당량 초과”
- 무료 티어 한도를 초과한 경우
- 일일 한도가 리셋될 때까지 대기 (24시간 후)
- 또는 유료 플랜으로 업그레이드
- 또는 다른 할당량을 가진 키-모델 을 추가
API 키를 잃어버렸어요
- Google AI Studio에서 새 키를 생성하세요
- 기존 키는 삭제하고 새 키를 사용하는 것이 안전합니다
| ← 앱 설치 | 다음: 첫 소설 추가하기 → |