다크 모드
이미지 분석
정보
이미지 분석은 룹에 업로드된 사진을 AI가 분석하여 각 사진의 설명(description)을 생성하고, 전체 사진 설명을 바탕으로 룹의 요약 메시지를 만드는 기능입니다. 분석 결과는 리캡 생성의 기반 데이터로 활용됩니다.
기능 소개
- 룹 단위로 이미지 분석이 실행되며, 해당 룹에 업로드된 모든 사진이 분석 대상입니다.
- AI가 각 사진을 분석하여 장면, 인물, 분위기 등을 설명하는 텍스트를 생성합니다.
- 각 사진의 설명은 해당 미디어의 AI 메타데이터에 저장됩니다.
- 모든 사진 분석이 완료되면, 전체 설명을 종합하여 룹의 요약 메시지를 생성합니다.
- AI 분석에 사용되는 프롬프트는 버전 관리되어 안정적으로 운영됩니다.
- 분석 과정은 백그라운드에서 비동기로 진행됩니다.
동작 규칙
- 사진만 분석 대상: 룹에 업로드된 사진(PHOTO)만 분석 대상입니다. 영상(VIDEO), 포스터(POSTER), 하이라이트(HIGHLIGHT) 등 다른 미디어 유형은 분석하지 않습니다.
- 룹 단위 실행: 이미지 분석은 개별 사진이 아닌 룹 단위로 실행됩니다. 해당 룹의 모든 사진이 한 번에 분석됩니다.
- 분석 결과 저장: AI가 생성한 사진 설명은 각 미디어의 AI 메타데이터(description 필드)에 저장됩니다.
- 룹 요약 메시지 생성: 모든 사진의 설명이 완료되면, AI가 전체 설명을 종합하여 룹의 요약 메시지를 생성합니다. 이 메시지는 룹에 아직 설명이 없는 경우에만 저장됩니다.
- 프롬프트 버전 관리: 분석에 사용되는 AI 프롬프트는 카테고리별로 별도 관리됩니다. 사진 설명, 태그, 요약 메시지 각각에 대해 독립적인 프롬프트 템플릿이 사용됩니다.
- 맥락 정보 활용: 사진 분석 시 룹의 날짜와 장소 정보가 AI에게 함께 전달되어 더 정확한 설명을 생성합니다.
- 리캡 생성 기반 데이터: 사진별 AI 설명은 리캡(Story) 생성 시 핵심 입력 데이터로 활용됩니다. 설명이 있는 사진만 리캡 생성에 사용될 수 있습니다.
- 다국어 지원: 분석 결과는 요청 시 지정된 언어 코드에 따라 생성됩니다. 기본 언어는 한국어(ko)입니다.
- 청크 단위 처리: 사진이 많은 경우 3장씩 나누어 순차적으로 처리합니다. 각 청크 사이에 API 요청 속도 제한이 적용됩니다.
- AI 이미지 선택: 분석된 사진 데이터를 기반으로 AI가 콘텐츠 유형(포스터, 하이라이트 등)별로 가장 적합한 이미지를 자동으로 선택할 수 있습니다.
사용자 흐름
이미지 분석 실행
분석 실행
룹에 사진이 업로드된 상태에서 이미지 분석이 실행됩니다.
사진별 설명 생성
AI가 각 사진을 분석하여 장면, 인물, 분위기 등을 설명하는 텍스트를 생성합니다. 룹의 날짜와 장소 정보가 맥락으로 활용됩니다.
설명 저장
각 사진의 AI 설명이 해당 미디어의 메타데이터에 저장됩니다.
룹 요약 메시지 생성
모든 사진의 설명을 종합하여 룹의 요약 메시지를 생성합니다. 룹에 아직 설명이 없는 경우에만 저장됩니다.
분석 결과 활용 (리캡 생성)
리캡 생성 요청
사용자가 리캡 생성을 요청합니다.
사진 설명 데이터 활용
AI가 각 사진의 분석 설명을 입력 데이터로 사용하여 리캡 콘텐츠를 생성합니다. 설명이 있는 사진이 리캡에 포함됩니다.
리캡 완성
사진 설명과 룹 맥락 정보를 바탕으로 리캡이 생성됩니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-10 | 소스 코드 기반으로 정확도 개선: 사진만 분석 대상 명시, 룹 단위 실행, 설명 저장 위치(ai_metadata), 룹 요약 메시지 생성 규칙, 청크 단위 처리, 맥락 정보 활용, 리캡과의 관계 명확화 |
| 2026-03-09 | 최초 작성 |