문서 정보

Ultra_random_prompt_v7.5 공개본 상세 사용자 메뉴얼

작성 기준: Ultra_random_prompt_v7.5 공개본 보강 기준

작성자: 나이스맨

대상 사용자: 처음 사용하는 사용자, 프롬프트 생성기를 직접 수정하려는 사용자, API 이미지 미리보기/이미지 분석을 함께 쓰려는 사용자

중요 안내

현재 공개본 참고 정보

목차

1. 앱 소개

2. 가장 먼저 알아야 할 핵심 개념

3. 화면 구성 전체 이해

4. 처음 사용하는 사람을 위한 5분 사용법

5. 왼쪽 선택 패널 사용법

6. 생성 대상: 배경만 생성, 이미지 분석, 툴팁

7. 일반 클릭, Ctrl/⌘ 클릭, Shift 클릭

8. 직접 선택, 멀티선택, 풀 지정의 차이

9. 압축 보기와 하위 카테고리 사용법

10. 오른쪽 출력 패널 사용법

11. 자연어형과 단어형 차이

12. 자연어형/단어형 전환과 자동 재생성

13. 모델 선택 기준

13-1. 아티스트 입력 기능

14. 생성 개수와 결과 리스트

15. 미리보기와 결과 리스트의 차이

16. 복사, 번역, 이미지 버튼 사용법

17. AI 이미지 미리보기 기능

18. 이미지 분석 기능

19. 이미지 분석 커스텀 지시어 사용법

20. API 키 입력, 저장, 삭제

21. API 키 하드코딩 방법

22. 모델명 변경 방법

23. 설정 저장 / 설정 초기화 / 좌하단 초기화

============================================================

이 앱에는 서로 다른 두 종류의 초기화가 있습니다.

이 둘을 헷갈리면 저장해 둔 선택 상태가 사라진 것처럼 느껴질 수 있으므로 반드시 구분해서 사용해야 합니다.

우상단 설정 저장 / 설정 갱신:

좌하단 초기화:

우상단 설정 초기화:

간단히 말하면:

좌하단 초기화 = 앱 작업 화면을 저장 설정 기준으로 다시 정리

우상단 설정 초기화 = 저장된 선택 설정 자체를 삭제하고 공개본 기본값으로 복구

API 키 = 두 초기화 모두 삭제하지 않음

24. 좌하단 초기화의 정확한 의미

============================================================

좌하단 초기화는 “저장된 설정 삭제” 버튼이 아닙니다.

저장된 선택 설정이 있는 경우:

저장된 선택 설정이 없는 경우:

좌하단 초기화가 지우는 것:

좌하단 초기화가 지우면 안 되는 것:

설정 자체를 완전히 삭제하려면 우상단 설정 영역의 설정 초기화 버튼을 사용합니다.

25. 인물 프롬프트 만들기

26. 외형, 헤어, 피부, 메이크업

27. 의상, 신발, 액세서리

28. 배경, 시간, 계절, 날씨

29. 조명, 분위기, 색감, 이벤트

30. 스타일과 렌더링 매체

31. 구도, 앵글, 렌즈

32. 배경만 생성 모드

33. NSFW 탭 사용법

34. 커스텀 입력 사용법

35. 좋은 프롬프트를 만드는 실제 요령

36. 상황별 추천 사용 예시

37. 이미지 분석 예시

38. POOL 데이터 직접 추가 방법

39. 압축 보기 카테고리에 데이터 넣기

40. ITEM_BIAS 가중치 이해

41. 기능성 항목 추가 시 주의점

42. 문제 해결

43. 직접 수정 후 점검 체크리스트

44. 최종 빠른 요약

45. 최신 v7.5 추가 기능 요약

46. Ollama Vision 이미지 분석 사용법

47. 남녀/그룹 세부 설정 사용법

48. 포즈 조합 허용 기능

49. 최신 배경만/NSFW 안정화 이해

50. 배포본 최종 확인 체크리스트

1. 앱 소개

Ultra_random_prompt_v7.5 공개본은 이미지 생성용 프롬프트를 버튼 선택 방식으로 만드는 HTML 기반 프롬프트 생성기입니다.

일반적인 이미지 생성 프롬프트를 직접 작성하려면 다음 요소들을 모두 생각해야 합니다.

이 앱은 이런 요소를 버튼으로 고르게 하고, 선택한 값을 조합해 프롬프트를 자동 생성합니다.

핵심 목적은 세 가지입니다.

1. 사용자가 직접 영어 프롬프트를 길게 쓰지 않아도 됩니다.

2. 원하는 항목은 고정하고, 나머지는 랜덤으로 다양하게 실험할 수 있습니다.

3. 이미지 분석, 이미지 미리보기, 번역까지 한 HTML 안에서 처리할 수 있습니다.

이 앱은 단순 랜덤 생성기가 아니라, “선택 가능한 프롬프트 조합 도구”입니다.

2. 가장 먼저 알아야 할 핵심 개념

이 앱을 쓰기 전에 다음 네 가지 개념만 이해하면 됩니다.

첫째, 선택하지 않은 항목은 대부분 결과에 들어가지 않습니다.

예를 들어 신발을 고르지 않으면 결과 프롬프트에 신발 설명이 들어가지 않을 수 있습니다.

둘째, 일반 클릭은 “이 항목을 쓰겠다”는 뜻입니다.

예를 들어 배경에서 “비 오는 밤 네온 골목”을 클릭하면, 그 배경이 프롬프트에 들어갑니다.

셋째, Ctrl/⌘ 클릭은 “여러 후보 중 랜덤”입니다.

예를 들어 표정에서 미소, 무표정, 도도한 표정을 Ctrl로 여러 개 고르면, 생성할 때 그중 하나가 랜덤으로 들어갑니다.

넷째, 미선택 랜덤과 전체 랜덤은 다릅니다.

처음에는 일반 클릭만 써도 됩니다. 익숙해지면 Ctrl/⌘ 클릭과 Shift 클릭을 사용하세요.

3. 화면 구성 전체 이해

앱은 크게 왼쪽과 오른쪽으로 나뉩니다.

왼쪽은 선택하는 곳입니다.

오른쪽은 결과를 보는 곳입니다.

왼쪽에는 다음과 같은 탭이 있습니다.

각 탭 안에는 여러 슬롯이 있습니다.

슬롯은 하나의 선택 묶음입니다.

예:

오른쪽에는 다음이 있습니다.

4. 처음 사용하는 사람을 위한 5분 사용법

처음 사용하는 경우 아래 순서를 그대로 따라 하세요.

1. 왼쪽에서 생성 대상이 인물 중심인지 확인합니다.

2. 연령대를 고릅니다.

예: 20대, 30대

3. 성별을 고릅니다.

예: 여성, 남성

4. 인원수를 고릅니다.

예: 1인

5. 인종/지역을 고릅니다.

예: 한국인, 동아시아계, 유럽계

6. 표정을 고릅니다.

예: 미소, 차분한 표정

7. 의상을 고릅니다.

예: 캐주얼, 정장, 드레스

8. 배경을 고릅니다.

예: 카페, 도시 거리, 네온 골목

9. 조명이나 분위기를 고릅니다.

예: 시네마틱, 자연광, 네온 조명

10. 구도를 고릅니다.

예: 상반신 포트레이트, 쓰리쿼터샷, 전신샷

11. 오른쪽에서 자연어형을 선택합니다.

12. 모델은 처음에는 Z-Image를 사용합니다.

13. 특정 화풍을 원하면 인물 커스텀 영역의 아티스트 입력을 사용합니다.

14. 생성 개수는 5개 또는 10개를 사용합니다.

15. 생성하기를 누릅니다.

16. 결과 리스트에서 마음에 드는 프롬프트를 복사합니다.

초보자는 너무 많은 항목을 한꺼번에 선택하지 않는 것이 좋습니다.

처음에는 성별, 나이, 인종, 의상, 배경, 스타일, 구도 정도만 선택해도 충분합니다.

5. 왼쪽 선택 패널 사용법

왼쪽 선택 패널은 프롬프트의 재료를 고르는 곳입니다.

버튼은 대부분 다음 방식으로 표시됩니다.

선택 패널은 사용자가 원하는 것만 고르도록 설계되어 있습니다.

모든 슬롯을 채울 필요는 없습니다.

예를 들어 인물 이미지를 만들 때 반드시 신발을 고를 필요는 없습니다.

상반신 포트레이트라면 신발은 보이지 않기 때문에 신발 설명이 없어도 됩니다.

반대로 전신샷이나 패션 이미지에서는 신발, 하체 의상, 액세서리까지 고르면 더 좋습니다.

6. 생성 대상: 배경만 생성, 이미지 분석, 툴팁

왼쪽 상단 생성 대상 영역에는 중요한 버튼들이 있습니다.

------------------------------------------------------------

6-1. 배경만 생성

------------------------------------------------------------

배경만 생성은 인물 없이 장면이나 배경을 만들 때 사용합니다.

예:

배경만 생성을 켜면 인물, 외형, 의상, 포즈 같은 항목은 결과에서 제외되거나 약화됩니다.

최신 v7.5에서는 배경만 모드에서 인물 중심 이벤트가 다시 끼어들지 않도록 보정되어 있습니다.

예를 들어 데이트, 쇼핑, 공연 대기, 스튜디오 촬영 같은 인물 중심 이벤트는 배경만 모드에서 자동으로 재삽입되지 않도록 정리되어 있습니다.

배경만 생성에서는 다음 항목을 고르는 것이 좋습니다.

------------------------------------------------------------

6-2. 이미지 분석

------------------------------------------------------------

이미지 분석은 메인 POOL 선택과 섞이지 않는 독립 기능입니다.

버튼을 누르면 별도 레이어 창이 열립니다.

그 창 안에서 이미지를 업로드하고, GPT, Gemini, Ollama Vision 중 하나로 이미지를 분석해 영어 프롬프트 1개를 만듭니다.

이미지 분석은 다음 상황에 좋습니다.

중요:

지원 방식:

Ollama 주의:

Ollama는 로컬 Vision 모델로 이미지를 분석하는 보조 기능입니다.

일반 텍스트 모델은 이미지를 볼 수 없으므로 정상 분석이 불가능합니다.

Ollama 결과는 GPT/Gemini보다 간단하거나 품질 편차가 있을 수 있습니다.

------------------------------------------------------------

6-3. 툴팁

------------------------------------------------------------

툴팁은 POOL 항목의 설명을 보여주는 기능입니다.

PC에서 마우스를 올리면 설명 카드가 나타납니다.

툴팁 ON:

툴팁 OFF:

7. 일반 클릭, Ctrl/⌘ 클릭, Shift 클릭

이 앱의 선택 방식은 세 가지입니다.

------------------------------------------------------------

7-1. 일반 클릭

------------------------------------------------------------

일반 클릭은 한 슬롯에서 하나를 고정 선택하는 방식입니다.

예:

표정에서 “미소”를 클릭하면 미소가 선택됩니다.

그 뒤 “무표정”을 클릭하면 미소는 해제되고 무표정이 선택됩니다.

즉 일반 클릭은 “이 슬롯은 이 항목 하나로 고정하겠다”는 의미입니다.

------------------------------------------------------------

7-2. Ctrl/⌘ 클릭

------------------------------------------------------------

Windows는 Ctrl, Mac은 ⌘ 키를 사용합니다.

Ctrl/⌘ 클릭은 여러 항목을 후보로 선택하는 방식입니다.

예:

표정에서 다음을 Ctrl로 클릭합니다.

그러면 생성할 때 이 세 표정 중 하나가 랜덤으로 선택됩니다.

이 방식은 “원하는 범위 안에서만 랜덤”을 만들 때 좋습니다.

------------------------------------------------------------

7-3. Shift 클릭

------------------------------------------------------------

Shift 클릭은 현재 누른 하위 카테고리 내부 항목만 전체 선택하거나 해제합니다.

예:

의상 압축 보기에서 캐주얼 하위 카테고리 안의 항목을 Shift 클릭하면, 캐주얼 하위 카테고리 내부 항목만 후보가 됩니다.

포멀, 유니폼, 판타지 같은 다른 하위 카테고리는 함께 건드리지 않습니다.

다시 같은 하위 카테고리에서 Shift 클릭하면 그 하위 카테고리 내부 후보가 해제됩니다.

이 기능은 데이터가 많은 압축 보기에서 원하는 범위만 빠르게 후보화할 때 특히 유용합니다.

대표/전체 버튼은 보기 전환용이며, Shift 일괄 선택의 기준은 실제 항목이 속한 하위 카테고리입니다.

8. 직접 선택, 멀티선택, 풀 지정의 차이

------------------------------------------------------------

8-1. 직접 선택

------------------------------------------------------------

직접 선택은 반드시 결과에 들어가야 하는 항목입니다.

예:

중요한 컨셉은 직접 선택하는 것이 좋습니다.

------------------------------------------------------------

8-2. 멀티선택

------------------------------------------------------------

멀티선택은 사용자가 고른 후보 중 하나가 랜덤으로 들어가는 방식입니다.

예:

의상 후보:

생성할 때마다 이 중 하나가 들어갑니다.

중요:

직접 멀티선택한 후보들은 item 단위 균등 확률입니다.

예를 들어 서로 다른 세부 pool에서 총 5개 후보를 직접 선택했다면, 5개 모두 각각 20% 확률입니다.

이때 ITEM_BIAS나 GROUP_BIAS는 적용되지 않습니다.

------------------------------------------------------------

8-3. 풀 지정

------------------------------------------------------------

풀 지정은 해당 슬롯의 전체 pool에서 랜덤으로 뽑는 방식입니다.

예:

날씨를 풀 지정하면 맑음, 비, 눈, 안개 등 전체 날씨 pool에서 하나가 랜덤으로 나올 수 있습니다.

풀 지정은 결과 다양성을 크게 늘립니다.

중요:

초록 점선 풀 랜덤은 직접 멀티선택과 다릅니다.

풀 랜덤은 앱에 설정된 GROUP_BIAS와 ITEM_BIAS 가중치를 사용합니다.

따라서 자주 쓰기 좋은 기본 항목은 더 자주 나오고, 특수한 항목은 상대적으로 덜 나올 수 있습니다.

9. 압축 보기와 하위 카테고리 사용법

v7.5는 항목 수가 많아서 모든 데이터를 한 화면에 그대로 보여주면 너무 길어집니다.

그래서 일부 슬롯은 압축 보기 구조를 사용합니다.

압축 보기에는 보통 다음 버튼이 있습니다.

대표는 자주 쓰는 항목만 보여줍니다.

전체는 모든 항목을 보여줍니다.

하위 카테고리는 특정 종류만 보여줍니다.

예를 들어 의상 슬롯이라면:

같은 식으로 나뉠 수 있습니다.

압축 보기에서도 선택 방식은 같습니다.

하위 카테고리 버튼에 숫자가 표시될 수 있습니다.

그 숫자는 그 카테고리 안에서 선택된 항목 수입니다.

10. 오른쪽 출력 패널 사용법

오른쪽 출력 패널은 결과를 관리하는 곳입니다.

주요 구성은 다음과 같습니다.

1. 출력 형식

2. 모델 선택

3. 생성 개수

4. 선택 요약

5. 미리보기

6. 결과 리스트

출력 형식과 모델은 결과 문장 구조에 큰 영향을 줍니다.

생성 개수는 한 번에 몇 개의 결과를 만들지 정합니다.

선택 요약은 지금 선택된 항목을 확인하는 곳입니다.

미리보기는 현재 선택 상태로 하나의 샘플을 보여줍니다.

결과 리스트는 생성하기 버튼을 눌렀을 때 만들어지는 여러 개의 프롬프트입니다.

11. 자연어형과 단어형 차이

------------------------------------------------------------

11-1. 자연어형

------------------------------------------------------------

자연어형은 문장형 프롬프트입니다.

예:

A young East Asian woman standing in a rainy neon alley, wearing a black casual jacket, framed in a cinematic three-quarter shot with wet pavement reflections and moody blue-magenta lighting.

장점:

------------------------------------------------------------

11-2. 단어형

------------------------------------------------------------

단어형은 쉼표로 구분된 태그형 프롬프트입니다.

예:

1girl, East Asian woman, rainy neon alley, black jacket, three-quarter shot, cinematic lighting, wet pavement, blue magenta color grading

장점:

12. 자연어형/단어형 전환과 자동 재생성

공개본에서는 자연어형과 단어형을 바꿀 때 결과 리스트가 자동으로 다시 생성됩니다.

예:

1. 자연어형으로 10개 생성

2. 단어형 버튼 클릭

3. 기존 10개 결과가 단어형 10개로 자동 재생성

4. 다시 자연어형 클릭

5. 자연어형 10개로 자동 재생성

중요:

미리보기만 바뀌는 것이 아니라 결과 리스트도 현재 형식에 맞게 다시 생성됩니다.

모델을 바꿔도 같은 원리입니다.

예:

1. 단어형 ILXL로 10개 생성

2. Pony 클릭

3. Pony 형식 10개로 자동 재생성

이 기능은 사용자가 결과를 비교하기 편하게 하기 위한 것입니다.

13. 모델 선택 기준

자연어형 모델:

Z-Image:

Qwen:

Flux:

Anima:

단어형 모델:

ILXL:

Pony:

SDXL:

SD:

13-1. 아티스트 입력 기능

아티스트 입력은 특정 작가명이나 화풍 이름을 프롬프트에 추가하고 싶을 때 사용하는 보조 기능입니다.

일반 POOL 버튼처럼 랜덤 후보에 섞이는 기능이 아니라, 사용자가 입력한 아티스트 목록을 최종 프롬프트 출력 단계에서 모델별 규칙에 맞게 붙여 주는 기능입니다.

사용 위치:

입력 방법:

가중치 입력:

모델별 출력 형식:

Anima:

단어형 SD / SDXL / Pony / ILXL:

자연어형 Z-Image / Qwen / Flux:

일반 / NSFW / 배경만 모드와의 관계:

저장과 초기화:

주의할 입력:

14. 생성 개수와 결과 리스트

생성 개수는 한 번에 만들 프롬프트 수입니다.

1개:

5개:

10개:

20개 이상:

생성 개수가 많을수록 다양한 결과를 볼 수 있지만, 결과를 고르는 데 시간이 더 걸립니다.

멀티선택이나 풀 지정이 많을수록 여러 개 생성했을 때 차이가 더 크게 나타납니다.

15. 미리보기와 결과 리스트의 차이

미리보기는 현재 선택 상태의 샘플 1개입니다.

결과 리스트는 생성 버튼을 눌렀을 때 만들어지는 실제 여러 개의 결과입니다.

미리보기는 선택을 바꾸면 즉시 바뀔 수 있습니다.

결과 리스트는 생성 버튼 또는 출력 형식/모델 전환에 의해 다시 생성됩니다.

즉 미리보기와 결과 리스트가 항상 같은 것은 아닙니다.

랜덤 후보가 있으면 미리보기와 결과 리스트의 항목이 달라질 수 있습니다.

16. 복사, 번역, 이미지 버튼 사용법

결과 리스트의 각 프롬프트에는 버튼이 표시됩니다.

복사:

번역:

이미지:

17. AI 이미지 미리보기 기능

AI 이미지 미리보기는 현재 프롬프트로 실제 이미지를 생성해 보는 기능입니다.

지원 모델:

OpenAI:

Gemini:

중요:

사용 흐름:

1. 프롬프트를 생성합니다.

2. 결과의 이미지 버튼을 누릅니다.

3. 이미지 미리보기 레이어가 열립니다.

4. API 키가 없으면 레이어 안에서 입력합니다.

5. OpenAI 또는 Gemini 이미지 모델을 선택합니다.

6. 생성하기를 누릅니다.

7. 이미지가 표시됩니다.

이미지 미리보기는 프롬프트를 이미지로 만들어 보는 기능입니다.

이미지 분석과는 반대 방향입니다.

18. 이미지 분석 기능

이미지 분석은 업로드한 이미지를 읽어 영어 프롬프트 1개를 만드는 기능입니다.

지원 모델:

OpenAI:

Gemini:

Ollama Vision:

사용 흐름:

1. 왼쪽 생성 대상 영역에서 이미지 분석 버튼을 누릅니다.

2. 이미지 분석 레이어가 열립니다.

3. GPT, Gemini, Ollama Vision 중 하나를 선택합니다.

4. GPT/Gemini는 API 키가 없으면 레이어 안에서 입력합니다.

5. Ollama는 API 키 입력 없이 모델 목록을 불러옵니다.

6. 이미지를 업로드합니다.

7. 필요하면 커스텀 지시어를 입력합니다.

8. 분석 실행을 누릅니다.

9. 분석 프롬프트가 표시됩니다.

10. 복사하거나 번역합니다.

Ollama를 사용할 때:

이미지 분석은 메인 POOL과 섞이지 않습니다.

메인 결과 리스트에도 자동으로 들어가지 않습니다.

분석창 안에서만 독립적으로 작동합니다.

이미지 분석창을 닫아도 현재 페이지에서는 분석 결과가 임시로 보관됩니다.

초기화 버튼을 누르면 분석 결과가 삭제됩니다.

좌하단 전체 초기화를 누르면 이미지 분석 상태도 함께 초기화됩니다.

하지만 저장된 선택 설정과 저장된 OpenAI/Gemini API 키는 삭제되지 않습니다.

Ollama는 저장 API 키가 없으므로 삭제할 키도 없습니다.

19. 이미지 분석 커스텀 지시어 사용법

커스텀 지시어는 이미지 분석 방향을 조절하는 입력칸입니다.

한국어로 입력해도 됩니다.

최종 결과 프롬프트는 영어로 출력됩니다.

예:

조명과 배경을 더 강조하고 인물 묘사는 간결히 해줘.

결과:

예:

의상과 소재감을 자세히 분석해줘.

결과:

Ollama에서의 주의:

좋은 커스텀 지시어:

주의:

커스텀 지시어는 이미지를 변형하는 기능이 아닙니다.

예를 들어 원본이 사진인데 “수채화로 바꿔줘”라고 쓰면 분석 기능의 본래 목적과 충돌할 수 있습니다.

이미지 분석은 원본 이미지의 모습, 스타일, 조명, 구도를 최대한 충실하게 프롬프트로 옮기는 기능입니다.

20. API 키 입력, 저장, 삭제

API 기능을 사용할 때는 기능별로 필요한 조건이 다릅니다.

API 키가 필요한 기능:

API 키가 필요 없는 기능:

단, Ollama는 API 키가 필요 없을 뿐이며, 로컬 Ollama가 실행 중이어야 합니다.

또한 이미지 분석에는 Vision 지원 모델이 필요합니다.

API 키는 레이어 안에서 입력할 수 있습니다.

브라우저에 저장하도록 체크하면 localStorage에 저장됩니다.

저장하지 않으면 현재 창에서만 임시로 사용합니다.

키가 없을 때도 이미지 분석 버튼이나 이미지 미리보기 버튼은 열립니다.

다만 GPT/Gemini 실행에는 레이어 안에서 키를 입력해야 합니다.

Ollama는 키 입력창 대신 모델 목록과 Vision 안내가 표시됩니다.

저장된 API 키 삭제는 각 레이어의 키 관리 버튼에서 할 수 있습니다.

Ollama는 저장 API 키가 없으므로 삭제할 키가 없습니다.

주의:

localStorage에 저장된 키는 해당 브라우저/파일 환경에 저장됩니다.

공용 PC에서는 저장하지 않는 것이 좋습니다.

21. API 키 하드코딩 방법

하드코딩은 HTML 소스 안에 API 키를 직접 넣는 방식입니다.

개인용으로만 사용하세요.

API 키가 들어간 HTML 파일은 절대로 공유하지 마세요.

하드코딩 대상:

하드코딩 대상이 아닌 것:

Ollama는 로컬 서버와 설치된 모델을 사용하므로 API 키를 HTML에 넣지 않습니다.

Ollama가 필요하면 Ollama 앱을 실행하거나 터미널에서 ollama serve를 실행하고, Vision 모델을 설치해야 합니다.

OpenAI 키 넣기:

1. HTML 파일을 텍스트 편집기로 엽니다.

2. 다음 문구를 검색합니다.

keyLabel: 'OpenAI API 키'

3. 근처의 아래 줄을 찾습니다.

hardcodedApiKey: '',

4. 따옴표 안에 키를 넣습니다.

예:

hardcodedApiKey: 'sk-xxxxxxxxxxxxxxxx',

Gemini 키 넣기:

1. 다음 문구를 검색합니다.

keyLabel: 'Gemini API 키'

2. 근처의 아래 줄을 찾습니다.

hardcodedApiKey: '',

3. 따옴표 안에 Gemini 키를 넣습니다.

예:

hardcodedApiKey: 'AIzaSyxxxxxxxxxxxxxxxx',

중요:

줄 번호는 참고용입니다.

소스가 조금만 바뀌어도 줄 번호는 달라집니다.

항상 keyLabel 문구로 찾는 것이 안전합니다.

하드코딩 키를 제거하려면 다시 빈 값으로 바꾸면 됩니다.

hardcodedApiKey: '',

22. 모델명 변경 방법

모델이 단종되거나 이름이 바뀌면 모델명을 수정할 수 있습니다.

이미지 미리보기 OpenAI 모델 검색어:

model: 'gpt-image-1-mini'

이미지 미리보기 Gemini 모델 검색어:

gemini-2.5-flash-image

이미지 분석 OpenAI 모델 검색어:

model: 'gpt-4.1-mini'

이미지 분석 Gemini 모델 검색어:

model: 'gemini-2.5-flash'

Ollama 모델명:

대부분은 모델명만 바꾸면 되지만, API 회사가 요청 방식 자체를 바꾸면 모델명만 바꿔도 작동하지 않을 수 있습니다.

Ollama의 경우 모델 파일명과 태그가 다양하므로, 앱은 Vision 후보 키워드를 이용해 이미지 분석 가능성을 판별합니다.

23. 설정 저장 / 설정 초기화 / 좌하단 초기화

앱에는 선택 설정 저장 기능이 있습니다. 이 기능은 현재 화면을 초기화하는 기능과 분리해서 이해하는 것이 좋습니다.

설정 저장:

설정 초기화:

좌하단 전체 초기화:

24. 좌하단 초기화의 정확한 의미

좌하단 초기화는 저장된 선택 설정이 있으면 그 저장 상태로 되돌리고, 저장된 선택 설정이 없을 때만 공개본 기본값으로 되돌립니다.

초기화되는 것:

초기화되지 않는 것:

즉 “초기화”는 현재 화면을 정리하는 기능입니다.

저장된 설정을 삭제하는 기능이 아닙니다.

저장된 설정을 삭제하려면 우상단 설정 영역의 설정 초기화 버튼을 따로 사용합니다. 저장된 설정은 다음 실행 때 자동 복원되는 용도이며, 좌하단 초기화는 그 저장값을 삭제하지 않습니다.

------------------------------------------------------------

24-1. 좌하단 초기화와 우상단 설정 초기화의 차이

------------------------------------------------------------

이 두 버튼은 이름이 비슷하지만 역할이 다릅니다.

좌하단 초기화:

우상단 설정 초기화:

실제 예시:

1. 자주 쓰는 기본 세팅을 만든다.

2. 우상단 설정 저장을 누른다.

3. 여러 항목을 바꾸며 실험한다.

4. 좌하단 초기화를 누른다. 저장된 세팅이 있으면 그 저장 상태로 돌아가고, 저장 세팅 자체는 남아 있다.

5. 저장 세팅 자체를 삭제하고 싶을 때만 우상단 설정 초기화를 누른다.

6. 저장 설정을 다시 자동 적용하고 싶다면 HTML을 다시 열거나 새로고침한다.

25. 인물 프롬프트 만들기

인물 프롬프트는 다음 순서로 만드는 것이 좋습니다.

1. 연령대

2. 성별

3. 인원수

4. 인종/지역

5. 필요하면 남녀/그룹 세부 설정

6. 표정

7. 시선

8. 포즈

9. 의상

10. 배경

11. 조명

12. 스타일

13. 구도

예:

20대 여성 1인, 한국인, 차분한 미소, 카메라 응시, 검은 원피스, 스튜디오 배경, 소프트박스 조명, 뷰티 포트레이트, 상반신 포트레이트

이렇게 핵심을 먼저 고르면 좋은 결과가 나옵니다.

남녀 혼성이나 소그룹을 만들 때는 새로 추가된 남녀/그룹 세부 설정을 사용할 수 있습니다.

예를 들어 다음과 같은 조합이 가능합니다.

주의:

남녀/그룹 세부 설정은 연령, 성별, 인원수, 인종/지역을 더 자세히 나누는 기능입니다.

여성용 포즈, 남성용 의상, 성별별 표정처럼 속성을 분리하는 기능은 아닙니다.

26. 외형, 헤어, 피부, 메이크업

외형 계열은 인물의 디테일을 결정합니다.

헤어:

피부:

메이크업:

주의:

클로즈업이나 상반신에서는 외형 디테일이 잘 보입니다.

전신샷이나 와이드샷에서는 얼굴/피부 디테일이 약해질 수 있습니다.

27. 의상, 신발, 액세서리

의상은 이미지 분위기를 크게 바꿉니다.

의상은 보통 다음 계열로 나뉩니다.

패션 이미지를 만들 때는 구도도 중요합니다.

의상 전체를 보이게 하려면:

얼굴 중심 이미지는 의상이 잘려 보일 수 있습니다.

신발은 전신샷이나 풀샷에서 의미가 큽니다.

상반신 포트레이트에서는 신발 설명이 결과에 잘 반영되지 않을 수 있습니다.

28. 배경, 시간, 계절, 날씨

배경은 인물이나 장면의 맥락을 만듭니다.

배경 예:

시간대:

날씨:

계절:

배경, 시간, 날씨는 서로 어울리게 고르는 것이 좋습니다.

예를 들어 비 오는 밤 네온 골목은 밤, 비, 네온 조명과 잘 어울립니다.

29. 조명, 분위기, 색감, 이벤트

조명은 이미지의 느낌을 결정하는 핵심 요소입니다.

조명 예:

분위기 예:

색감 예:

이벤트는 장면에 이야기를 줍니다.

예:

30. 스타일과 렌더링 매체

스타일은 이미지가 어떤 매체처럼 보일지를 정합니다.

사진 계열:

일러스트 계열:

회화 계열:

3D 계열:

스타일은 다른 요소와 충돌하지 않게 고르는 것이 좋습니다.

수채화 스타일인데 “극도로 선명한 사진 초점” 같은 표현이 너무 강하면 어색할 수 있습니다.

31. 구도, 앵글, 렌즈

구도는 이미지에서 무엇이 얼마나 보이는지 결정합니다.

클로즈업:

헤드샷:

버스트샷:

미디엄샷:

상반신 포트레이트:

쓰리쿼터샷:

전신샷:

풀샷:

와이드 환경 롱샷:

렌즈:

32. 배경만 생성 모드

배경만 생성은 인물 없이 배경을 만들 때 사용합니다.

추천 조합:

도시 야경:

자연 풍경:

실내 배경:

최신 v7.5의 배경만 모드는 인물 중심 이벤트가 끼어들지 않도록 보정되어 있습니다.

예를 들어 데이트, 쇼핑, 촬영 대기, 백스테이지처럼 인물이 핵심인 이벤트는 배경만 모드에서 자동으로 재삽입되지 않도록 정리되어 있습니다.

또한 야외 배경과 실내 전용 시간대, NSFW 장소와 일반 이벤트/날씨/계절이 섞이지 않도록 여러 장면축 보정이 들어가 있습니다.

이 보정은 주로 자동 랜덤에서 충돌을 줄이기 위한 것이며, 사용자가 직접 선택한 값은 가능한 유지하는 방향입니다.

배경만 생성 중에는 인물 관련 선택이 의미 없거나 자동 제외될 수 있습니다.

33. NSFW 탭 사용법

NSFW 기능은 성인용 이미지 프롬프트를 위한 기능입니다.

반드시 성인 대상과 함께 사용하세요.

NSFW에서 중요한 항목:

주의:

미성년, 어린이, 학생, 교복, 어린 인상과 NSFW를 결합하면 안 됩니다.

NSFW 사용 시에는 성인 subject가 유지되도록 설계되어 있습니다.

명시적으로 미성년을 뜻하는 custom 입력은 사용하지 마세요.

NSFW 착의와 노출 단계는 충돌할 수 있습니다.

예를 들어 완전 누드를 선택했는데 두꺼운 코트를 선택하면 의상 설명이 제거되거나 약화될 수 있습니다.

NSFW 포즈는 구도와 맞춰야 합니다.

후면 강조 포즈는 전신샷이나 쓰리쿼터샷이 더 좋습니다.

헤드샷에서는 포즈 의미가 거의 사라질 수 있습니다.

최신 v7.5에서는 NSFW 장소가 있을 때 일반 배경, 일반 이벤트, 일반 날씨, 계절, 시간대가 부자연스럽게 남지 않도록 보정이 강화되어 있습니다.

예를 들어 실내 NSFW 장소에 폭설 저녁이나 야외 캠핑 이벤트가 자동으로 붙는 식의 충돌을 줄였습니다.

============================================================

------------------------------------------------------------

33-1. NSFW 선택/탭 오픈 상태에서 일반 항목과 NSFW 항목의 관계

------------------------------------------------------------

NSFW 항목을 하나라도 선택했거나 NSFW 탭이 열린 상태에서 미선택 랜덤/전체 랜덤을 사용하면, 앱은 그 상태를 NSFW 생성 흐름으로 봅니다.

이때 모든 일반 항목이 사라지는 것은 아닙니다.

같은 성격으로 겹치는 항목은 NSFW 쪽이 우선하고, 겹치지 않는 항목은 일반 쪽을 계속 사용합니다.

NSFW 쪽이 우선하는 대표 항목:

계속 일반 쪽을 사용하는 대표 항목:

간단히 말하면, 겹치는 슬롯은 NSFW가 우선하고 겹치지 않는 슬롯은 일반이 계속 담당합니다.

예를 들어 NSFW 배경과 NSFW 조명을 선택한 상태에서 미선택 랜덤을 누르면, 일반 배경/일반 조명은 자동으로 밀리고 인물, 스타일, 색감, 구도 같은 일반 항목은 계속 랜덤에 참여합니다.

전체 랜덤도 같은 원칙을 따릅니다.

NSFW 탭이 닫힌 상태에서 전체 랜덤을 누르면 일반 랜덤으로 작동하고, NSFW 탭이 열린 상태에서 전체 랜덤을 누르면 NSFW 배경/조명/착의 계열이 우선되는 NSFW 랜덤으로 작동합니다.

34. 커스텀 입력 사용법

============================================================

커스텀 입력은 기존 POOL에 없는 표현을 직접 넣는 기능입니다.

커스텀 입력에는 보통 세 칸이 있습니다.

KO:

NL:

TAG:

예:

KO:

검은 실크 드레스

NL:

wearing a black silk dress with elegant flowing fabric

TAG:

black silk dress, elegant dress, silk fabric

커스텀 입력은 기존 선택보다 우선적으로 반영될 수 있습니다.

너무 긴 문장을 넣으면 프롬프트가 장황해질 수 있으니 핵심만 넣는 것이 좋습니다.

35. 좋은 프롬프트를 만드는 실제 요령

좋은 프롬프트를 만들려면 다음 원칙을 기억하세요.

1. 핵심은 직접 선택합니다.

2. 다양성은 Ctrl/⌘ 멀티선택으로 만듭니다.

3. 너무 많은 항목을 한꺼번에 고르지 않습니다.

4. 구도와 선택 항목을 맞춥니다.

5. 스타일과 품질 표현이 충돌하지 않게 합니다.

6. 배경, 시간, 날씨, 조명은 서로 어울리게 고릅니다.

7. 단어형에서는 쉼표 태그가 너무 길어지지 않게 합니다.

8. 자연어형에서는 장면을 문장으로 자연스럽게 이어주는 모델을 선택합니다.

좋은 예:

나쁜 예:

36. 상황별 추천 사용 예시

------------------------------------------------------------

36-1. 실사 포트레이트

------------------------------------------------------------

선택:

출력:

------------------------------------------------------------

36-2. 스트리트 패션

------------------------------------------------------------

선택:

출력:

------------------------------------------------------------

36-3. 애니 캐릭터

------------------------------------------------------------

선택:

출력:

------------------------------------------------------------

36-4. 수채화 인물

------------------------------------------------------------

선택:

주의:

수채화에는 sharp focus, ultra crisp 같은 표현이 너무 강하면 어색할 수 있습니다.

------------------------------------------------------------

36-5. 배경만 판타지 장면

------------------------------------------------------------

선택:

37. 이미지 분석 예시

예시 1: 어두운 플래시 포트레이트

커스텀 지시어:

조명과 배경을 더 강조하고, 인물 묘사는 원본에 충실하게 해줘.

결과 방향:

예시 2: 수채화 일러스트

커스텀 지시어:

수채화 번짐과 색감 중심으로 분석해줘.

결과 방향:

예시 3: 애니 스타일 이미지

커스텀 지시어:

캐릭터 스타일과 눈, 헤어, 의상 중심으로 분석해줘.

결과 방향:

이미지 분석은 인종/지역 외형도 가능한 범위에서 broad category로 분석합니다.

한국/일본/중국 계열은 보통 East Asian으로, 매우 명확할 때만 Korean 같은 표현이 나올 수 있습니다.

필리핀, 말레이시아, 인도네시아, 태국, 베트남 계열은 억지로 특정 국가를 추정하지 않고 보통 Southeast Asian으로 처리하는 것이 안정적입니다.

38. POOL 데이터 직접 추가 방법

POOL은 앱의 버튼 데이터입니다.

기본 구조:

{

ko:'한글 표시명',

nl:[

`영문 자연어 표현 1`,

`영문 자연어 표현 2`,

`영문 자연어 표현 3`

],

tag:'태그형 표현'

}

예:

{

ko:'검은 실크 드레스',

nl:[

`wearing a black silk dress with elegant flowing fabric`,

`dressed in a glossy black silk dress`,

`a refined black silk dress draping naturally over the body`

],

tag:'black silk dress, elegant dress, silk fabric'

}

주의:

39. 압축 보기 카테고리에 데이터 넣기

POOL에 항목을 추가해도 압축 보기의 원하는 카테고리에 자동으로 들어가지 않을 수 있습니다.

이때는 COMPACT_SLOT_CONFIG 쪽의 분류 규칙을 확인해야 합니다.

예:

새 의상 항목이 “레트로 데님 재킷”이라면, 캐주얼 또는 재킷 계열 정규식에 걸려야 원하는 하위 카테고리에서 보일 수 있습니다.

데이터 추가 시 확인할 것:

1. POOL에 항목이 들어갔는가

2. 전체 보기에서 보이는가

3. 대표 보기에 넣을 필요가 있는가

4. 하위 카테고리에서 보이는가

5. Ctrl/Shift 선택이 정상인가

6. 자연어형 결과에 nl이 들어가는가

7. 단어형 결과에 tag가 들어가는가

40. ITEM_BIAS 가중치 이해

ITEM_BIAS는 랜덤에서 특정 항목이 얼마나 자주 나올지 정하는 가중치입니다.

예:

'쓰리쿼터샷': 6

숫자가 높으면 더 자주 나옵니다.

숫자가 낮으면 덜 나옵니다.

단, 너무 높은 값을 주면 특정 항목만 반복될 수 있습니다.

추천:

41. 기능성 항목 추가 시 주의점

단순 의상이나 배경은 POOL 추가만으로 충분할 수 있습니다.

하지만 아래 항목은 관련 함수도 확인해야 합니다.

예:

구도에 새 항목을 추가하면 단순히 POOL.cang에 넣는 것만으로 부족할 수 있습니다.

FULLBODY_CANG, CLOSEUP_CANG, framingSemanticProfile 같은 관련 판별에도 반영해야 할 수 있습니다.

42. 문제 해결

------------------------------------------------------------

42-1. 자연어형에서 단어형으로 바꿨는데 결과가 안 바뀌는 것처럼 보일 때

------------------------------------------------------------

공개본에서는 형식 변경 시 결과 리스트가 자동 재생성되어야 합니다.

만약 미리보기만 바뀌고 결과 리스트가 그대로라면 브라우저 캐시로 이전 파일을 열었을 수 있습니다.

해결:

------------------------------------------------------------

42-2. 이미지 분석 번역 버튼이 안 보이거나 안 눌릴 때

------------------------------------------------------------

분석 결과가 있어야 번역 버튼이 활성화됩니다.

분석 결과가 비어 있으면 번역할 내용이 없습니다.

번역 레이어는 이미지 분석창 위에 표시되어야 합니다.

만약 안 보이면 브라우저 확대/축소 또는 창 위치 문제일 수 있습니다.

------------------------------------------------------------

42-3. API 키가 있는데 실패할 때

------------------------------------------------------------

가능한 원인:

해결:

------------------------------------------------------------

42-4. Ollama 모델 목록이 안 뜰 때

------------------------------------------------------------

가능한 원인:

해결:

------------------------------------------------------------

42-5. Ollama에서 분석 결과가 너무 짧거나 부족할 때

------------------------------------------------------------

Ollama는 로컬 Vision 모델의 성능에 따라 결과 품질이 크게 달라집니다.

GPT/Gemini보다 프롬프트 재구성 능력이 약할 수 있습니다.

해결:

------------------------------------------------------------

42-6. Ollama가 이미지를 볼 수 없다고 할 때

------------------------------------------------------------

가능한 원인:

해결:

------------------------------------------------------------

42-7. HTML 수정 후 앱이 안 열릴 때

------------------------------------------------------------

대부분 문법 오류입니다.

자주 발생하는 원인:

해결:

43. 직접 수정 후 점검 체크리스트

소스를 직접 수정했다면 아래를 확인하세요.

기본 점검:

선택 점검:

생성 점검:

모드 점검:

이미지 기능 점검:

초기화 점검:

44. 최종 빠른 요약

가장 간단한 사용법:

1. 원하는 항목을 선택합니다.

2. 중요한 것은 일반 클릭으로 고정합니다.

3. 여러 후보는 Ctrl/⌘ 클릭으로 고릅니다.

4. 현재 보이는 항목 전체를 후보로 쓰려면 Shift 클릭합니다.

5. 필요하면 남녀/그룹 세부 설정을 사용합니다.

6. 필요하면 포즈 조합 허용을 켭니다.

7. 자연어형 또는 단어형을 고릅니다.

8. 모델을 고릅니다.

9. 특정 화풍이 필요하면 아티스트 입력을 사용합니다.

10. 생성 개수를 정합니다.

11. 생성하기를 누릅니다.

12. 결과를 복사하거나 번역하거나 이미지 미리보기로 확인합니다.

기억할 핵심:

이후 부록에서는 최신 v7.5 추가 기능과 배포 전 확인 사항을 더 자세히 설명합니다.

45. 최신 v7.5 추가 기능 요약

최신 v7.5 공개본에서는 기존 프롬프트 생성 기능에 더해 다음 부분이 강화되었습니다.

1. Ollama Vision 이미지 분석 추가

2. 남녀/그룹 세부 설정 추가

3. 포즈 조합 허용 기능 안정화

4. 배경만/NSFW/일반 모드 경계 안정화

5. 랜덤 가중치와 스타일 prefix 정리

46. Ollama Vision 이미지 분석 사용법

Ollama Vision은 로컬에서 실행되는 멀티모달 모델을 이용해 이미지를 분석하는 기능입니다.

사용 조건:

사용 흐름:

1. 이미지 분석 버튼을 누릅니다.

2. 분석 모델에서 Ollama Vision을 선택합니다.

3. Ollama 모델 목록 새로고침을 누릅니다.

4. Vision 후보로 표시되는 모델을 선택합니다.

5. 이미지를 업로드합니다.

6. 필요하면 한국어 커스텀 지시어를 입력합니다.

7. 분석 실행을 누릅니다.

8. 영어 이미지 생성 프롬프트 결과를 확인합니다.

Ollama Vision 모델 예시:

주의:

Ollama가 느릴 때:

47. 남녀/그룹 세부 설정 사용법

남녀/그룹 세부 설정은 기본 subject 위에 추가되는 세부 설정입니다.

기본 연령대, 성별, 인원수, 인종/지역 구조는 그대로 유지됩니다.

그 위에 남녀별 연령, 인종/지역, 인원수를 더 자세히 지정할 수 있습니다.

사용 가능한 세부 설정:

예시:

남녀 커플:

소그룹 혼성:

같은 성별 혼합:

중요 규칙:

하지 않는 기능:

이 기능은 인원·연령·지역 조합을 위한 것이며, 성별별 의상이나 포즈를 따로 고정하는 기능이 아닙니다.

48. 포즈 조합 허용 기능

포즈 조합 허용은 하나의 기본 포즈에 보조 포즈 성격을 더해 더 다양한 장면을 만들기 위한 기능입니다.

예:

사용 방법:

1. 포즈 조합 허용을 켭니다.

2. 조합 후보가 표시되는지 확인합니다.

3. 기본 포즈를 직접 선택하거나 랜덤에 맡깁니다.

4. 생성 결과에서 조합 표현이 자연스러운지 확인합니다.

주의:

결과가 어색할 때:

49. 최신 배경만/NSFW 안정화 이해

최신 v7.5에서는 배경만, NSFW, 일반 모드가 서로 섞이지 않도록 많은 보정이 들어갔습니다.

사용자는 이 보정을 자세히 몰라도 되지만, 결과가 왜 자동으로 정리되는지 이해하면 좋습니다.

배경만 모드:

NSFW 모드:

NSFW와 일반 항목의 우선순위:

자동 보정의 원칙:

예:

사용자가 직접 “비 오는 날씨”와 “실내 침실 NSFW 장소”를 함께 고르면 앱이 무조건 지우지 않을 수 있습니다.

하지만 자동 랜덤에서 그런 조합이 우연히 생기면 정리될 가능성이 큽니다.

50. 배포본 최종 확인 체크리스트

배포본을 사용하거나 공유하기 전에 아래를 확인하세요.

파일 확인:

기본 기능 확인:

이미지 기능 확인:

모드 확인:

아티스트 기능 확인:

문제가 있으면:

부록 A. 초보자를 위한 추천 조합 모음

실사 한국 여성 포트레이트

--------------

사용 팁: 핵심 항목은 직접 선택하고, 표정·의상·색감처럼 변화를 보고 싶은 요소만 Ctrl/⌘ 멀티선택하세요.

비 오는 네온 거리 패션

-------------

사용 팁: 핵심 항목은 직접 선택하고, 표정·의상·색감처럼 변화를 보고 싶은 요소만 Ctrl/⌘ 멀티선택하세요.

애니 일러스트 캐릭터

-----------

사용 팁: 핵심 항목은 직접 선택하고, 표정·의상·색감처럼 변화를 보고 싶은 요소만 Ctrl/⌘ 멀티선택하세요.

수채화 감성 인물

---------

사용 팁: 핵심 항목은 직접 선택하고, 표정·의상·색감처럼 변화를 보고 싶은 요소만 Ctrl/⌘ 멀티선택하세요.

고급 호텔 배경만

---------

사용 팁: 핵심 항목은 직접 선택하고, 표정·의상·색감처럼 변화를 보고 싶은 요소만 Ctrl/⌘ 멀티선택하세요.

어두운 플래시 인물

----------

사용 팁: 핵심 항목은 직접 선택하고, 표정·의상·색감처럼 변화를 보고 싶은 요소만 Ctrl/⌘ 멀티선택하세요.

부록 B. 커스텀 지시어 예시

[이미지 분석용] 조명과 배경의 분위기를 더 자세히 분석하고, 인물의 외형은 원본에 충실하게 유지해줘.

[이미지 분석용] 스타일이 사진인지 일러스트인지 수채화인지 먼저 분명히 잡고, 최종 프롬프트는 영어로 작성해줘.

[이미지 분석용] 인물의 의상 소재와 색을 자세히 분석하되, 배경은 간결하게 정리해줘.

[커스텀 의상 NL] wearing a fitted black wool coat with clean tailoring and subtle texture

[커스텀 배경 NL] inside a rain-streaked glass greenhouse filled with dark green plants and soft diffused light

[커스텀 스타일 NL] rendered as a delicate watercolor illustration with soft color bleeding and atmospheric paper texture

부록 C. 자주 헷갈리는 표현 정리

부록 D. 슬롯별 세부 사용 가이드

이 부록은 실제 사용자가 어떤 슬롯을 언제 선택하면 좋은지 설명합니다. 모든 슬롯을 매번 선택할 필요는 없습니다. 중요한 컨셉만 고르고 나머지는 비워두거나 미선택 랜덤을 사용하는 것이 좋습니다.

연령대

---

인물의 나이 인상을 정합니다. 포트레이트에서는 결과에 강하게 반영됩니다. NSFW를 사용할 때는 반드시 성인 연령대를 선택해야 합니다.

성별

--

영어 문장의 woman, man, people 같은 핵심 명사를 결정합니다. 남녀 혼성이나 커플에서는 문장 구조가 달라질 수 있습니다.

인종/지역

-----

인물의 외형적 계열을 지정합니다. 한국인, 동아시아계, 유럽계, 동남아시아계 같은 표현은 모델의 얼굴 인상에 영향을 줍니다.

표정

--

인물의 감정과 분위기를 정합니다. 미소, 무표정, 도도한 표정, 수줍은 표정 등은 결과 인상에 크게 작용합니다.

시선

--

카메라를 보는지, 옆을 보는지, 아래를 보는지 정합니다. 인물 이미지의 심리적 방향을 바꿉니다.

포즈

--

몸의 자세를 결정합니다. 포즈는 구도와 강하게 연결됩니다.

손동작

---

손의 위치와 행동을 정합니다. 클로즈업이나 상반신에서 의미가 큽니다.

헤어 길이

-----

머리 길이를 정합니다. 얼굴형과 스타일에 큰 영향을 줍니다.

헤어 스타일

------

스트레이트, 웨이브, 묶음머리, 업스타일 같은 헤어 형태를 정합니다.

헤어 색상

-----

검정, 브라운, 금발, 컬러 헤어 등 색을 정합니다.

피부

--

피부 톤과 질감을 정합니다. 포트레이트에서 중요합니다.

메이크업

----

얼굴의 화장 스타일을 정합니다.

의상

--

이미지의 캐릭터성과 분위기를 크게 결정합니다.

신발

--

전신샷이나 풀샷에서 중요합니다.

액세서리

----

작은 장식 요소입니다. 포트레이트의 디테일을 살립니다.

배경

--

장면의 장소를 정합니다. 인물보다 배경이 중요하면 배경 관련 항목을 더 많이 선택하세요.

시간대

---

아침, 낮, 해질녘, 밤 같은 시간 느낌입니다.

날씨

--

비, 눈, 안개 등 분위기를 크게 바꿉니다.

조명

--

사진/이미지의 품질을 결정하는 핵심 요소입니다.

색감

--

전체 컬러 팔레트와 후처리 느낌입니다.

스타일

---

사진, 애니, 일러스트, 수채화, 유화, 3D 등 매체를 결정합니다.

구도

--

무엇이 얼마나 보이는지 결정합니다.

렌즈

--

사진적 거리감과 배경 흐림을 정합니다.

부록 E. 작업 흐름별 자세한 레시피

아래 레시피는 실제 사용자가 어떤 순서로 버튼을 누르면 되는지에 초점을 맞춘 예시입니다. 그대로 따라 한 뒤, 마음에 안 드는 항목만 바꾸면 됩니다.

깨끗한 증명사진 느낌의 인물

---------------

1. 연령대 선택

2. 성별 선택

3. 인원수 1인 선택

4. 인종/지역 선택

5. 표정은 차분한 미소

6. 시선은 카메라 응시

7. 배경은 단순 스튜디오

8. 조명은 소프트박스 또는 균일한 스튜디오 조명

9. 구도는 헤드샷 또는 상반신 포트레이트

10. 렌즈는 85mm

11. 자연어형 Z-Image로 생성

영화 포스터 같은 인물

------------

1. 인물 기본 설정

2. 표정은 진지한 표정 또는 강렬한 눈빛

3. 배경은 도시 야경 또는 어두운 실내

4. 조명은 림라이트/스포트라이트/네온 중 하나

5. 분위기는 시네마틱

6. 색감은 블루/오렌지 또는 블루/마젠타

7. 구도는 미디엄샷 또는 쓰리쿼터샷

8. 자연어형 Flux로 생성

패션 룩북 이미지

---------

1. 성별/연령/인종 선택

2. 의상 슬롯에서 여러 의상 Ctrl 멀티선택

3. 신발과 액세서리 선택

4. 배경은 스튜디오 또는 도시 거리

5. 조명은 소프트박스 또는 자연광

6. 구도는 전신샷 또는 쓰리쿼터샷

7. 생성 개수 10개

8. 자연어형과 단어형을 전환해 비교

웹툰 커버풍 캐릭터

----------

1. 애니/일러스트 스타일 선택

2. 인물 기본 설정

3. 헤어/눈/의상 디테일 선택

4. 표정은 감정이 잘 드러나는 항목 선택

5. 배경은 단순하지만 분위기 있는 장소

6. 구도는 상반신 또는 전신

7. 단어형 ILXL 또는 자연어형 Anima로 생성

고딕 수채화 이미지

----------

1. 인물 또는 배경 선택

2. 스타일에서 고딕/수채화/회화 계열 선택

3. 색감은 어둡고 차분하게

4. 조명은 부드러운 확산광

5. 배경은 오래된 실내/성당/정원 계열

6. 프롬프트에 sharp/crisp 계열이 과하게 들어가지 않게 확인

배경 컨셉아트

-------

1. 배경만 생성 켜기

2. 배경 장소 선택

3. 시간대/날씨 선택

4. 조명과 분위기 선택

5. 스타일은 컨셉아트/디지털 페인팅/3D 중 목적에 맞게 선택

6. 구도는 와이드 환경 롱샷

7. 생성 개수 10개 이상으로 다양성 확인

부록 F. 오류와 혼동을 줄이는 사용 습관

1. 중요한 항목은 직접 선택하세요.

랜덤에 맡기면 원하는 항목이 항상 나오지 않을 수 있습니다.

2. 결과가 이상하면 선택 요약을 먼저 확인하세요.

생각보다 많은 항목이 선택되어 충돌하고 있을 수 있습니다.

3. 자연어형/단어형을 바꾼 뒤 결과 리스트가 자동 재생성되는지 확인하세요.

공개본은 전환 시 기존 결과 개수만큼 다시 생성됩니다.

4. 좌하단 초기화는 저장된 선택 설정이 있으면 그 상태로 복원하고, 저장된 선택 설정이 없을 때만 공개본 기본값으로 정리합니다.

저장된 선택 설정과 저장된 API 키는 삭제되지 않습니다.

5. API 키를 소스에 넣은 파일은 절대 공유하지 마세요.

하드코딩 키는 편리하지만 보안 위험이 큽니다.

6. 이미지 분석은 분석 도구입니다.

메인 POOL과 자동으로 섞이지 않습니다. 분석 결과는 복사해서 사용하세요.

7. 커스텀 지시어는 변형 지시가 아니라 분석 우선순위 지시에 가깝게 쓰세요.

예: “조명과 배경 중심으로 분석”은 좋습니다. “완전히 다른 옷으로 바꿔줘”는 분석 목적과 맞지 않습니다.

부록 G. NSFW 사용 시 추가 주의

NSFW 탭은 성인용 이미지 프롬프트를 위한 기능입니다. 반드시 성인 연령대와 함께 사용해야 합니다.

좋은 흐름:

1. 성인 연령대 선택

2. 성별/인원수 선택

3. NSFW 착의 또는 노출 단계 선택

4. NSFW 배경과 조명 선택

5. 구도를 선택

6. 결과를 확인하며 충돌 표현이 없는지 확인

피해야 할 흐름:

NSFW는 프롬프트의 민감도가 높기 때문에 결과가 모델에서 거절되거나 약화될 수 있습니다.

모델마다 안전 필터가 다르므로 결과가 실패하면 표현을 더 완화하거나 다른 모델을 사용하세요.

부록 H. 이미지 분석 결과를 더 좋게 만드는 팁

이미지 분석은 업로드 이미지의 시각 요소를 읽어 영어 프롬프트로 정리합니다. 좋은 분석 결과를 얻으려면 이미지와 지시어를 잘 준비하는 것이 좋습니다.

좋은 이미지:

분석 지시어 예시:

피하면 좋은 지시어:

이런 지시어는 분석이 아니라 편집/변형에 가까우므로 이미지 분석 기능의 목적과 맞지 않습니다.

부록 I. 항목 선택 전략 상세 설명

이 앱은 단순히 버튼을 많이 누른다고 좋은 결과가 나오는 구조가 아닙니다. 좋은 결과는 “무엇을 고정하고, 무엇을 랜덤으로 둘지”를 잘 정하는 데서 나옵니다.

가장 중요한 기준은 다음과 같습니다.

1. 이미지의 주제를 고정합니다.

예를 들어 한국인 여성 포트레이트를 만들고 싶다면 성별, 인종/지역, 인원수는 직접 선택하는 것이 좋습니다.

2. 이미지의 분위기를 고정합니다.

시네마틱인지, 수채화인지, 애니인지, 실사 사진인지 같은 스타일은 결과 전체를 바꾸므로 직접 선택하는 것이 좋습니다.

3. 변화를 보고 싶은 요소만 랜덤으로 둡니다.

표정, 의상, 배경 후보, 색감 정도를 Ctrl/⌘로 여러 개 선택하면 결과가 다양하면서도 통제됩니다.

4. 구도는 가능하면 직접 선택합니다.

구도는 이미지의 보이는 범위를 결정하므로 랜덤으로 두면 결과가 크게 흔들릴 수 있습니다. 특히 패션, 신발, 전신 포즈를 원한다면 전신샷 또는 쓰리쿼터샷을 직접 선택하세요.

5. 배경과 날씨, 시간대는 서로 맞추는 것이 좋습니다.

밤 네온 골목을 선택했는데 밝은 한낮 자연광을 같이 강하게 선택하면 프롬프트가 충돌할 수 있습니다.

6. 스타일과 품질 표현도 서로 맞아야 합니다.

수채화 스타일에는 부드러운 번짐, 종이 질감, 색 번짐이 잘 맞습니다. 반대로 crisp photo realism 같은 표현은 수채화와 충돌할 수 있습니다.

인물 기본 조합

--------

실제 사용에서는 이 조합을 그대로 시작점으로 삼고, 표정이나 의상만 바꿔가며 결과를 비교하면 좋습니다.

의상 조합

-----

실제 사용에서는 이 조합을 그대로 시작점으로 삼고, 표정이나 의상만 바꿔가며 결과를 비교하면 좋습니다.

배경 조합

-----

실제 사용에서는 이 조합을 그대로 시작점으로 삼고, 표정이나 의상만 바꿔가며 결과를 비교하면 좋습니다.

스타일 조합

------

실제 사용에서는 이 조합을 그대로 시작점으로 삼고, 표정이나 의상만 바꿔가며 결과를 비교하면 좋습니다.

조명 조합

-----

실제 사용에서는 이 조합을 그대로 시작점으로 삼고, 표정이나 의상만 바꿔가며 결과를 비교하면 좋습니다.

부록 J. 자연어형 모델별 자세한 사용 예

자연어형 모델은 같은 선택값을 사용해도 문장 구성 방식이 조금씩 다릅니다.

Z-Image는 가장 기본적인 자연어형입니다. 문장을 균형 있게 만들고, 선택한 요소를 무난하게 연결합니다. 처음 쓰는 사용자는 Z-Image로 시작하는 것이 좋습니다.

Qwen은 조건을 분명하게 전달하고 싶을 때 유용합니다. 예를 들어 의상, 배경, 조명, 스타일을 빠짐없이 반영하고 싶은 경우에 좋습니다.

Flux는 사실적 장면이나 사진적 묘사에 잘 맞습니다. 거리 사진, 자연광, 시네마틱 장면, 현실적인 인물 이미지에 적합합니다.

Anima는 애니, 웹툰, 일러스트 계열 자연어 프롬프트에 적합합니다. 캐릭터 중심 이미지를 만들 때 사용하면 좋습니다.

자연어형에서 아티스트 입력을 사용하는 경우:

자연어형 사용 팁:

부록 K. 단어형 모델별 자세한 사용 예

단어형은 쉼표로 나뉜 태그를 중심으로 하는 출력입니다. Stable Diffusion 계열 또는 태그 기반 모델에 적합합니다.

ILXL은 일러스트/애니 계열에서 무난한 기본값입니다. 품질 태그와 일러스트 태그를 정리해서 쓰고 싶을 때 좋습니다.

Pony는 Pony 계열 모델에 맞는 태그 구조를 사용합니다. score, rating 계열 태그가 필요한 환경에서 유용합니다.

SDXL은 범용 SDXL 모델에 맞춘 단어형입니다. 실사와 일러스트를 모두 어느 정도 다룰 수 있습니다.

SD는 전통적인 Stable Diffusion 태그형에 가까운 출력입니다. 구형 모델이나 짧은 태그 중심 워크플로우에 사용할 수 있습니다.

단어형에서 아티스트 입력을 사용하는 경우:

단어형 사용 팁:

부록 L. 이미지 미리보기와 이미지 분석의 차이를 다시 정리

이미지 미리보기와 이미지 분석은 이름이 비슷하지만 완전히 반대 방향의 기능입니다.

이미지 미리보기:

이미지 분석:

따라서 이미지 미리보기 모델과 이미지 분석 모델은 서로 다릅니다.

이미지 분석 모델을 이미지 미리보기 모델로 바꾸거나, 이미지 미리보기 모델을 분석용으로 쓰는 것은 맞지 않습니다.

이미지 분석 결과는 메인 POOL 선택값과 자동으로 합쳐지지 않습니다.

이렇게 분리한 이유는 POOL 구조가 복잡하고, 분석 결과를 자동으로 POOL에 매핑하면 오탐이나 충돌이 생기기 쉽기 때문입니다.

부록 M. API 키 관리 상세 주의사항

API 키는 돈이 연결될 수 있는 민감한 정보입니다. 앱을 혼자 쓰는 개인용 HTML이라면 하드코딩이 편할 수 있지만, 공유 파일에는 절대 넣으면 안 됩니다.

안전한 사용 원칙:

1. 배포용 파일의 hardcodedApiKey는 반드시 빈 값이어야 합니다.

2. 다른 사람에게 HTML을 보낼 때는 API 키가 들어 있는지 다시 확인하세요.

3. GitHub, 블로그, 커뮤니티, 클라우드 공유 링크에 키가 들어간 파일을 올리지 마세요.

4. 공용 PC에서는 API 키를 localStorage에 저장하지 마세요.

5. 키가 노출되었다고 생각되면 즉시 API 제공 사이트에서 키를 폐기하고 새 키를 만드세요.

하드코딩 키와 저장 키의 차이:

좌하단 초기화는 저장된 API 키를 삭제하지 않습니다.

이미지 분석 초기화도 저장된 API 키를 삭제하지 않습니다.

API 키를 삭제하려면 각 레이어의 키 삭제 기능을 사용하거나, 소스의 hardcodedApiKey를 직접 비워야 합니다.

부록 N. 저장 설정과 초기화의 차이 상세 설명

이 앱에는 비슷해 보이는 초기화 기능이 여러 개 있습니다. 헷갈리지 않도록 정확히 구분하세요.

좌하단 초기화:

설정 저장:

설정 초기화 또는 저장 설정 삭제:

실제 사용 예:

1. 마음에 드는 기본 세팅을 만든다.

2. 설정 저장을 누른다.

3. 여러 실험을 한다.

4. 좌하단 초기화를 누른다. 저장된 선택 설정이 있으면 그 설정 상태로 복원되고, 저장 설정은 삭제되지 않는다.

5. 저장 설정은 삭제되지 않았으므로, 다음 실행 또는 새로고침 때 다시 자동 복원될 수 있다.

부록 O. 직접 소스 수정 시 작업 순서

소스를 직접 수정할 때는 반드시 순서를 지키는 것이 좋습니다.

1. 원본 파일을 백업합니다.

2. 한 번에 한 종류의 수정만 합니다.

3. 수정 후 브라우저에서 열어 봅니다.

4. 개발자 콘솔 오류를 확인합니다.

5. 선택 버튼이 정상인지 확인합니다.

6. 자연어형으로 생성합니다.

7. 단어형으로 생성합니다.

8. 자연어형/단어형 전환 자동 재생성을 확인합니다.

9. 설정 저장/자동 복원을 확인합니다.

10. 문제가 없으면 다음 수정으로 넘어갑니다.

한 번에 POOL, CSS, 함수, API 모델명을 모두 바꾸면 문제가 생겼을 때 원인을 찾기 어렵습니다. 가능한 한 작은 단위로 수정하세요.

부록 P. 프롬프트 결과를 읽는 방법

생성된 프롬프트를 볼 때는 다음 순서로 확인하면 좋습니다.

1. 주체가 맞는가?

예: woman, man, people, no humans, scenery 등

2. 나이와 인종/지역 표현이 맞는가?

예: young adult Korean woman, East Asian woman, European man 등

3. 의상이 맞는가?

의상이 너무 많이 섞이거나 노출 단계와 충돌하지 않는지 봅니다.

4. 배경이 맞는가?

배경, 시간대, 날씨, 조명이 서로 어울리는지 봅니다.

5. 스타일이 맞는가?

사진인데 수채화 표현이 섞였거나, 수채화인데 crisp photo realism이 과하게 들어가면 조정이 필요합니다.

6. 구도가 맞는가?

신발을 강조했는데 클로즈업이면 잘 보이지 않을 수 있습니다.

7. 단어형이면 태그가 너무 중복되지 않는지 봅니다.

중복 태그가 많으면 결과가 지저분해질 수 있습니다.

부록 Q. 공개본 최종 점검 기준

공개본으로 사용하기 전에는 다음을 확인하세요.

보안:

기본 동작:

출력:

이미지 기능:

초기화:

부록 R. 최신 동작 보강 요약

이 부록은 특히 헷갈리기 쉬운 최신 동작을 정리한 것입니다.

------------------------------------------------------------

R-1. 배경 / 의상 / 스타일 후보 누적

------------------------------------------------------------

배경, 의상, 스타일은 서로 다른 큰 분류의 후보를 함께 누적 선택할 수 있습니다.

예:

이렇게 총 5개 후보를 직접 선택하면, 생성 시 배경 축에서는 5개 중 1개만 랜덤 출력됩니다.

확률은 각 후보 20%입니다.

중요:

요약 목록에는 후보가 여러 개 보여도, 실제 프롬프트에는 각 큰 축당 1개만 들어갑니다.

즉:

------------------------------------------------------------

R-2. 직접 멀티선택과 풀 랜덤의 확률 차이

------------------------------------------------------------

직접 멀티선택:

예:

학생 ITEM_BIAS가 높고 소방관 ITEM_BIAS가 낮아도,

사용자가 학생과 소방관을 직접 멀티선택하면 거의 50% / 50%로 선택됩니다.

풀 랜덤:

정리:

------------------------------------------------------------

R-3. 미선택 랜덤과 전체 랜덤

------------------------------------------------------------

미선택 랜덤:

전체 랜덤:

주의:

현재 선택을 유지하고 싶으면 전체 랜덤이 아니라 미선택 랜덤을 사용하세요.

------------------------------------------------------------

R-4. 일부 선택만으로 생성할 때의 자동 누출 방지

------------------------------------------------------------

생성하기 기준에서는 사용자가 고르지 않은 세부 pool을 새로 만들지 않는 방향으로 정리되어 있습니다.

예:

다만 미선택 랜덤이나 전체 랜덤을 사용하면 빈 슬롯을 랜덤으로 채우는 기능상 해당 항목이 나올 수 있습니다.

이것은 정상 동작입니다.

------------------------------------------------------------

R-5. NSFW 선택/탭 오픈 상태의 랜덤 관계

------------------------------------------------------------

NSFW 항목을 하나라도 선택했거나 NSFW 탭이 열린 상태에서 미선택 랜덤을 누르면,

같은 성격의 빈 항목은 NSFW 쪽에서 보강됩니다.

예:

단, 사용자가 직접 고른 일반 항목은 유지됩니다.

예:

일반 배경을 직접 고른 뒤 NSFW 탭을 열고 미선택 랜덤을 눌러도,

그 일반 배경은 유지됩니다.

반대로 NSFW 배경을 직접 선택하면 충돌하는 일반 배경은 게이트가 정리합니다.

------------------------------------------------------------

R-6. 배경만 생성 보호

------------------------------------------------------------

배경만 생성은 인물이 없는 장면을 만들기 위한 모드입니다.

이 모드에서는:

NSFW 탭이 열려 있어도 배경만 생성 + 미선택 랜덤에서는 NSFW 인물 항목이 섞이지 않도록 보호됩니다.

------------------------------------------------------------

R-7. 성별 / 연령 / 인원 / 인종 조합 보호

------------------------------------------------------------

최신 보정은 role, outfit, event, action 같은 의미 충돌을 줄이지만,

성별, 연령, 인원, 인종/지역 조합을 함부로 바꾸지 않습니다.

남녀/그룹 세부 설정도 subject 계열로 보호됩니다.

즉:

------------------------------------------------------------

R-8. 아티스트 입력 기능

------------------------------------------------------------

아티스트 입력은 POOL 선택이나 랜덤 후보가 아닙니다.

사용자가 입력한 아티스트 이름을 최종 프롬프트에 모델별 규칙으로 덧붙이는 출력층 기능입니다.

기본 동작:

모델별 형식:

자연어형 가중치:

모드/순서 관계:

초기화 관계:

------------------------------------------------------------

R-9. 배포 전 마지막 확인

------------------------------------------------------------

배포 전에는 다음만 빠르게 확인하면 됩니다.

1. 앱이 정상으로 열리는가

2. 생성하기가 되는가

3. 미선택 랜덤이 직접 선택을 유지하는가

4. 전체 랜덤이 새 조합을 만드는가

5. 배경/의상/스타일 멀티선택 후보가 각 축 1개만 출력되는가

6. NSFW 탭 오픈 상태에서 미선택 랜덤이 의도대로 작동하는가

7. 배경만 생성에서 인물 문장이 나오지 않는가

8. 자연어형/단어형 전환이 정상인가

9. 아티스트 입력이 모델별 형식으로 정상 출력되는가

10. 자연어형 아티스트 문구가 전체 이미지풍을 visual reference로 쓰는 문장으로 출력되는가

11. 아티스트 가중치가 Anima/단어형에는 숫자로 반영되고 자연어형에는 숫자 대신 문장 강도로 반영되는가

12. 일반/NSFW/배경만 생성에서 아티스트가 공통 적용되는가

13. 아티스트를 먼저 입력하든, 선택 후 입력하든, 미선택 랜덤/전체 랜덤 후 입력하든 같은 최종 상태에서 같은 방식으로 반영되는가

14. 아티스트 모두 삭제, 좌하단 초기화, 우상단 설정 초기화 동작이 의도와 맞는가

15. 복사/번역/AI 이미지 미리보기 레이어가 열리는가

16. 설정 저장 후 새로고침 복원이 되는가

끝