Appearance
3.1 pro, 3.1 flash lite 모델 추가 PRD
Start date: 03/17/2026 Release date: 03/31/2026 Status: Released created: March 16, 2026 6:42 PM 앱/웹/스튜디오: 스튜디오, 앱, 웹
1. 목표 및 배경
문제
- 현재 모든 씬 생성에 Gemini 2.5 Pro(60스타)가 고정 사용되고 있어, 스타가 부족한 유저는 씬 생성을 포기하거나 이탈함
- 디렉터가 에피소드 제작 시 모델을 선택할 수 없어, 품질/비용에 대한 제어권이 없음
- 고품질 모델(3.1 Pro)을 원하는 유저에게 업그레이드 경로가 없음
아이디어
- 저비용 모델(Gemini 3.1 Flash Lite, 10스타)을 도입하여 씬 생성 진입장벽을 대폭 낮추고, 플레이어에게 품질/비용 선택권을 제공
- 디렉터가 에피소드별 권장 모델을 지정할 수 있게 하여 제작 의도를 반영
가설
- 저비용 모델(10스타) 도입 시, 스타 부족으로 씬 생성을 포기했던 유저가 flash lite를 사용하여 플레이를 지속할 것이다.
- 모델 선택권 제공으로 전체 씬 생성량이 유의미하게 증가할 것이다.
KPI
- 핵심 지표: 전체 씬 생성량 증가
2. 타깃 사용자
- 플레이어(앱/웹): 스타 소모를 줄이면서도 플레이를 지속하고 싶은 유저 / 고품질 생성을 원해 프리미엄 모델을 선택하고 싶은 유저
- 디렉터(스튜디오): 에피소드 특성에 맞는 모델을 지정하여 플레이 경험을 설계하고 싶은 제작자
3. 핵심 기능 요구사항
모델 라인업 및 스타 소모
| 모델 | 이름 | 설명 | 스타 소모 | 포지셔닝 | 비고 |
|---|---|---|---|---|---|
| Gemini 3.1 Pro | Gemini 3.1 Pro | 풍부한 표현을 구사하며 속도감 있게 이야기를 진행시켜요 | 72스타 | 프리미엄 | 고품질 |
| Gemini 2.5 Pro | Gemini 2.5 Pro | 주어진 규칙을 잘 지키며 안정감 있게 이야기를 이끌어요. | 60스타 | 기본(현행) | 현재 기본값 |
| Gemini 3.1 Flash Lite | Wings 1.0 | 저렴한 비용으로 가볍게 이야기를 즐길 수 있어요. | 10스타 | 경량 | 저비용, 진입장벽 완화 |
모델 이름 고민
- 걍 flash만 다르게: gemini 3.1 Pro / gemini 2.5 Pro / 스피드 모드
- 이야기꾼 컨셉: 그랜드 바드 / 바드 / 스프린터
- 정령/뮤즈 컨셉: 오라클 / 뮤즈 / 스파크
- 탐험가 컨셉: 파인더 / 가이드 / 스카우트
보조 모델(상태값, 요약) 규칙
| 메인 모델 선택 | 보조 모델 적용 |
|---|---|
| Gemini 3.1 Pro | 기존 보조 모델 유지 |
| Gemini 2.5 Pro | 기존 보조 모델 유지 |
| Gemini 3.1 Flash Lite | 보조 모델도 flash lite로 일괄 변경 (요약은 제외) |
- flash lite 선택 시 보조 모델도 일괄 변경하는 이유: 비용 일관성 유지 및 저비용 경로의 실질적인 비용 절감 보장
A. 스튜디오 (디렉터)
모델 지정
- 디렉터는 에피소드 제작 시 사용할 모델을 선택할 수 있음
- 모델 선택은 스냅샷(버전) 단위로 적용됨
- 예: 스냅샷 v1은 Gemini 2.5 Pro, 스냅샷 v2는 Gemini 3.1 Pro 지정 가능
- 디렉터가 지정한 모델 = 플레이어가 해당 에피소드 플레이 시 디폴트 모델
기본값
- 모델을 별도 지정하지 않은 경우, 기본값은 Gemini 2.5 Pro (현행 유지)
UI 위치
- 스튜디오 [세계관] 탭 쪽에 위치
B. 앱/웹 (플레이어)
디폴트 모델
- 에피소드 플레이 시작 시, 디렉터가 해당 에피소드(최신 스냅샷 기준)에 지정한 모델이 디폴트로 적용
모델 변경
- 플레이어는 플레이 중 언제든 모델을 변경할 수 있음
- 변경된 모델은 다음 씬 생성부터 적용
- 모델 변경 시 해당 모델의 스타 소모량이 UI에 즉시 반영되어야 함
씬 생성 중 비활성화
- 씬이 생성 중인 동안에는 모델 선택 UI가 비활성화(disabled) 되어야 함
- 생성 완료 후 다시 활성화
UI 위치 (상세 디자인 시 결정)
- 플레이 화면 내 모델 선택 UI (씬 생성 버튼 근처 또는 설정 영역)
- 현재 선택된 모델과 소모 스타가 명확히 표시되어야 함
C. 스타 소모 연동
- 모델 변경 시 씬 생성 버튼 또는 관련 UI에 표시되는 스타 소모량이 선택된 모델에 맞게 즉시 갱신
- 실제 스타 차감은 선택 시점이 아닌 씬 생성 시점에 해당 모델의 스타량으로 차감
D. 어드민에서 각 모델 별 프롬프트 설정
어드민에서 각 모델 별로 프롬프트 설정 가능해야합니다.
3.1 flash lite 씬 생성 프롬프트 변경 필요 @momo
jsx## Current Story main event - Unfold the story through emotionally rich dialogue, walking through the STORY GUIDE below — letting it flow gently toward the next event triggers
4. 사용자 플로우
스튜디오 (디렉터) 플로우
- 디렉터가 에피소드를 제작/편집
- 모델 선택 옵션에서 원하는 모델 지정
- 저장 → 해당 스냅샷에 모델 정보가 기록됨
- 플레이어가 이 에피소드를 플레이하면 지정된 모델이 디폴트로 적용
앱/웹 (플레이어) 플로우
- 플레이어가 에피소드 플레이 시작 → 디렉터 지정 모델이 디폴트로 설정
- 플레이 화면에서 현재 모델과 소모 스타 확인 가능
- 모델을 변경하고 싶으면 모델 선택 UI에서 다른 모델 선택
- 소모 스타 표시가 즉시 변경됨
- 다음 씬 생성 시 변경된 모델로 생성, 해당 스타 차감
- 씬 생성 중에는 모델 선택 UI 비활성화 → 생성 완료 후 다시 활성화
5. 에러 처리 및 예외 상황
- 스타 부족: 선택한 모델의 스타 소모량보다 보유 스타가 적을 경우, 씬 생성 시 기존 스타 부족 안내 플로우 동일 적용
- 씬 생성 실패: 모델 변경과 무관하게 기존 에러 처리 동일 적용. 실패 시 스타 미차감
- 씬 생성 중 모델 변경 시도: 모델 선택 UI 비활성화 상태이므로 변경 불가. 별도 에러 메시지 불필요
- 모델 서비스 장애 시: 선택한 모델이 일시적으로 사용 불가한 경우의 폴백 정책 → 폴백 없음
6. 데이터 분석
핵심 분석 항목
- 모델별 씬 생성량 및 비율 추이
- flash lite 도입 전후 전체 씬 생성량 변화
로깅 이벤트
| 타입 | 이름 | 용도 | 파라미터 | 비고 |
|---|---|---|---|---|
| Event | generate_scene (기존) | 씬 생성 시 모델 정보 추가 | play_model: 'gemini_2_5_pro' | 'gemini_3_1_pro' |
| default_model: 'gemini_2_5_pro' | 'gemini_3_1_pro' | 'gemini_3_1_flash_lite' | 기존 이벤트에 파라미터 추가 | |
| Event | generate_scene_complete (기존) | 씬 생성 시 모델 정보 추가 | play_model: 'gemini_2_5_pro' | 'gemini_3_1_pro' |
| default_model: 'gemini_2_5_pro' | 'gemini_3_1_pro' | 'gemini_3_1_flash_lite' | 기존 이벤트에 파라미터 추가 |
7. 출시 계획
- 출시 범위: 스튜디오 + 앱/웹 동시 출시
- 기본값 전략: 기존 에피소드는 모두 Gemini 2.5 Pro(현행)로 유지, 변경 없음