프롬프트 데이터

IMGPrompt의 프롬프트 자료는 웹 수집, promptoMANIA, sd-webui-prompt-all-in-one, 그리고 awesome-gpt-image-2-prompts(CC BY 4.0)에서 가져왔습니다. 중복 제거, 표준화, 18개 언어 현지화를 거쳐 총 5000+ 개의 이미지/영상 생성 프롬프트를 16개 주분류와 수백 개 하위 분류로 정리했습니다.

데이터 구조 설명

모든 프롬프트 데이터는 프로젝트 디렉터리 src/app/data 아래에 다음 구조로 저장됩니다.

src
└── app
    └── data
        ├── prompt              # 18개 언어 버전의 프롬프트
        │   ├── prompt-zh.json  # 중국어 간체 (기준, 다른 언어는 여기서 파생)
        │   ├── prompt-en.json  # 영어
        │   ├── prompt-ja.json  # 일본어
        │   └── ......          # 나머지 15개 언어
        └── prompt-custom.json  # 사용자 커스텀 프롬프트 (모든 언어에서 로드)

각 프롬프트는 하나의 JSON 객체에 대응합니다.

{
  "displayName": "portrait",
  "langName": "초상화",
  "object": "캐릭터",
  "attribute": "기본",
  "description": "(선택) 설명 또는 작성자 표기",
  "preview": "(선택) 미리보기 이미지 URL"
}

필드 설명

필드 필수 여부 설명
displayName ✅ 필수 영어 프롬프트(고유값). 프롬프트 상자에 실제로 삽입되는 내용
langName ✅ 필수 모국어/대상 언어 번역. UI에서 태그에 표시됨
object ✅ 필수 주분류 (예: 캐릭터 / 환경 / 사진 / 아트 스타일)
attribute ✅ 필수 하위 분류 (예: 기본 / 나이 / 조명 효과 / 배경)
description ❌ 선택 미리보기 팝오버의 추가 설명(작성자 표기, 사용 팁 등). 데스크톱 호버 / 터치 길게 누르기 시 표시
preview ❌ 선택 미리보기 이미지 URL. 데스크톱 호버 또는 터치 0.5초 길게 누르기 시 팝오버에 표시되며, 클릭 / 탭하면 라이트박스 확대 보기로 진입

💡 preview 필드는 "호버 / 길게 눌러 미리보기 + 클릭 확대" 기능의 데이터 소스입니다. 데스크톱에서는 hover로, 터치 화면에서는 길게 누르기로 열리고, 클릭 / 탭은 여전히 태그 추가 / 제거에만 사용됩니다.

데이터 관리 팁

  • displayName은 반드시 고유해야 합니다. 중복 항목은 무시되며 추천 품질에도 영향을 줍니다.
  • 쉼표 규약: ", "(쉼표+공백)는 앱의 태그 구분자입니다. 묶음 항목 내부에는 공백 없는 ","를 사용하세요(예: snow,ice). 공백이 들어가거나 전각 쉼표를 쓰면 빌드 단계에서 차단됩니다(sliceData 검증).
  • 다국어 데이터에서는 같은 object / attribute를 재사용해 화면 분류를 일관되게 유지하세요.
  • 태그 표시가 잘리지 않도록 langName은 가능한 한 간결하게 작성하세요.
  • preview는 WebP 형식, 150 KB 이하, 정사각형 구도(1:1)를 권장합니다. 호버 / 길게 누르기 팝오버에서 가장 보기 좋습니다.

커스텀 프롬프트 추가

프롬프트를 확장하려면 IMGPrompt 데이터 변환기로 커스텀 데이터를 표준 형식으로 변환하세요. 변환 결과를 src/app/data/prompt-custom.json에 저장하면 앱 시작 시 자동으로 로드되어 모든 언어 환경에 적용됩니다.

예시:

[
  {
    "displayName": "cyberpunk cityscape",
    "langName": "사이버펑크 도시",
    "object": "환경",
    "attribute": "도시"
  },
  {
    "displayName": "cinematic lighting",
    "langName": "영화 조명",
    "object": "빛과 그림자 효과",
    "attribute": "조명 효과",
    "description": "부드러운 방향성 조명 + 림 라이트로 입체감 강화",
    "preview": "https://example.com/preview/cinematic.webp"
  }
]

커스텀 항목은 내장 항목과 완전히 같은 규칙으로 표시됩니다. preview가 있으면 호버 / 길게 누르기 미리보기와 클릭 확대 기능이 활성화됩니다.