모델 선택 UI 표시명 정책 PRD

Start date: 2026-06-16 Status: Draft 앱/웹/스튜디오: 스튜디오, 앱, 웹 Source: Slack thread + 디자인 완료 캡처 Figma: https://www.figma.com/design/YXyI88Br0T5bH1NE1SIwEx/AX_2026_2?node-id=2730-7524&t=TkIPvaJx5BmjRZSz-1

1. 목표 및 배경

모델 선택 UI에서 실제 모델명만 노출하면 유저와 디렉터가 각 모델의 성격을 직관적으로 이해하기 어렵다.
이번 변경은 각 생성 모델에 유저-facing ModelName과 아이콘을 부여해, 모델 선택을 기술명 선택이 아니라 경험/성격 선택처럼 이해시키는 것을 목표로 한다.

이번 PRD는 디자인 완료본을 기준으로 한 표시 정책 정리이며, 별도 화면 spec은 작성하지 않는다. 화면 레이아웃과 아이콘 시각 표현은 최종 디자인을 따른다.

2. 범위

포함

• 스튜디오 AI 모델 설정 영역의 모델 표시 정책
• 플레이세팅 > 모델 선택 화면의 모델 표시 정책
• ModelName, 원래 모델명 노출 여부, 설명 문구 방향, 스타 소모 표시 정책

제외

• 모델별 생성 품질/프롬프트 변경
• 모델 라우팅/서버 생성 로직 변경
• 스타 차감 로직 변경
• 신규 로깅 이벤트 설계
• 별도 spec-preview / screen-design 작성

3. 모델 표시명 매핑

내부/원래 모델	유저-facing ModelName	아이콘	비고
Gemini 2.5 Pro	플레어	디자인 에셋 기준	기존 안정형 Gemini 모델
Gemini 3.5 Flash	글로우	디자인 에셋 기준	신규/속도형 Gemini 모델
Gemini 3.1 Pro	샤이닝	디자인 에셋 기준	고품질 Gemini 모델
Gemini 3.1 Flash Lite	윙스	디자인 에셋 기준	UI에서는 원래 모델명 미노출

정책:

• 유저와 디렉터에게는 ModelName을 주요 선택명으로 표시한다.
• 내부 모델명은 생성/라우팅/로그 식별을 위한 값이며, 유저-facing 선택명과 분리한다.
• 아이콘 에셋 키와 최종 비주얼은 디자인/FE 에셋 기준을 따른다.

4. 화면별 표시 정책

4.1 스튜디오 — AI 모델 설정

스튜디오는 디렉터가 에피소드 제작 의도에 맞는 모델을 고르는 화면이다. ModelName을 메인으로 보여주되, Gemini 계열 모델은 원래 모델 정보를 함께 제공해 제작자가 기술적 기준도 확인할 수 있게 한다.

요구사항:

• 각 모델 카드에 ModelName과 아이콘을 표시한다.
• 플레어, 글로우, 샤이닝은 원래 모델명 정보를 함께 표시한다.
  • 플레어: Gemini 2.5 Pro
  • 글로우: Gemini 3.5 Flash
  • 샤이닝: Gemini 3.1 Pro
• 윙스는 원래 모델명 정보를 별도로 표시하지 않는다.
• 각 모델 설명은 디자인 완료본 기준의 간결한 설명을 사용한다.
• 스튜디오 카드에서는 플레이어용 1회 선택 시 n개 스타 소모 문구를 주요 정보로 노출하지 않는다.

4.2 플레이세팅 > 모델 선택

플레이세팅의 모델 선택은 플레이어가 다음 씬 생성에 사용할 모델을 고르는 화면이다. 플레이어에게는 기술 모델명보다 ModelName, 설명, 스타 소모량을 중심으로 보여준다.

요구사항:

• 각 모델 카드에 ModelName과 아이콘을 표시한다.
• 원래 모델명 정보는 표시하지 않는다.
  • 예: Gemini 3.5 Flash 같은 기술명은 플레이어 모델 선택 화면에 노출하지 않는다.
• 각 모델 설명은 스튜디오와 다른 플레이어용 간결 설명을 사용한다.
• 1회 선택 시 사용되는 스타 개수를 계속 표시한다.
  • 플레어: 60개
  • 글로우: 60개
  • 샤이닝: 72개
  • 윙스: 10개
• 모델 선택 시 실제 스타 차감은 기존 정책대로 씬 생성 시점에 적용한다.

5. 유지되는 기존 정책

• 디렉터가 스튜디오에서 지정한 모델은 해당 에피소드 플레이 시 기본 모델로 적용된다.
• 플레이어는 플레이 중 모델 선택 화면에서 모델을 변경할 수 있다.
• 변경된 모델은 다음 씬 생성부터 적용된다.
• 씬 생성 중에는 모델 선택 변경이 비활성화된다.
• 스타 부족/생성 실패 처리 등 결제·차감 예외는 기존 모델 선택 정책을 따른다.

6. 데이터/로그 정책

이번 변경은 기존 씬 생성 이벤트와 모델 식별 파라미터를 유지하되, 모델 데이터값은 유저-facing ModelName이나 등급명(plus / standard / lite)이 아니라 실제 모델명 기반 canonical id로 통일한다. 신규 이벤트는 만들지 않는다.

정책:

• play_model / default_model은 기존 컨벤션대로 유지한다.
• 값은 모델의 실제 식별명을 사용한다.
• plus / standard / lite 같은 tier 값은 신규 저장/전송/로그 값으로 사용하지 않는다.
• flare / glow / shining / wings 같은 유저-facing ModelName slug도 데이터값으로 사용하지 않는다. 표시명은 향후 변경될 수 있으므로 UI 매핑으로만 취급한다.
• 기존 데이터에 남아 있는 legacy 값은 읽기 호환/마이그레이션 대상으로만 다루고, 신규 값은 아래 canonical id로 저장·전송한다.

이벤트	파라미터	값
generate_scene	play_model	gemini-2.5-pro / gemini-3.5-flash / gemini-3.1-pro / gemini-3.1-flash-lite
generate_scene	default_model	gemini-2.5-pro / gemini-3.5-flash / gemini-3.1-pro / gemini-3.1-flash-lite
generate_scene_complete	play_model	gemini-2.5-pro / gemini-3.5-flash / gemini-3.1-pro / gemini-3.1-flash-lite
generate_scene_complete	default_model	gemini-2.5-pro / gemini-3.5-flash / gemini-3.1-pro / gemini-3.1-flash-lite

UI 표시 매핑:

canonical model id	UI 표시명
gemini-2.5-pro	플레어
gemini-3.5-flash	글로우
gemini-3.1-pro	샤이닝
gemini-3.1-flash-lite	윙스

7. 오픈 확인

1. 최종 아이콘 에셋 키는 FE/디자인 기준으로 확정한다.
2. 스튜디오/플레이세팅의 모델별 설명 문구는 디자인 완료본 카피를 그대로 따른다.
3. 기존 에피소드에 저장된 기본 모델 값은 변경하지 않고, UI 표시만 신규 ModelName으로 매핑하는 것으로 가정한다.

8. Acceptance Criteria

• 스튜디오 모델 선택 UI에서 네 모델 모두 ModelName과 아이콘이 표시된다.
• 스튜디오에서 플레어/글로우/샤이닝은 원래 Gemini 모델 정보가 표시되고, 윙스는 원래 모델 정보가 표시되지 않는다.
• 플레이세팅 > 모델 선택에서 네 모델 모두 ModelName과 아이콘이 표시된다.
• 플레이세팅 > 모델 선택에서는 원래 모델명이 노출되지 않는다.
• 플레이세팅 > 모델 선택에서는 모델별 1회 생성 스타 소모량이 표시된다.
• 모델 선택/기본 모델/씬 생성 시점 차감/생성 중 비활성화 정책은 기존 동작과 동일하게 유지된다.
• generate_scene, generate_scene_complete의 play_model, default_model 값은 gemini-2.5-pro / gemini-3.5-flash / gemini-3.1-pro / gemini-3.1-flash-lite 중 하나로 기록된다.
• plus / standard / lite 및 유저-facing ModelName slug는 신규 모델 데이터값으로 사용하지 않는다.