사용 안내

스튜디오 /studio/

• 포즈 — 좌측 패널 탭(스탠딩·에디토리얼·의자·스툴·포징 블록·소파·침대·식탁·책상·바닥)에서 선택, 총 57종. 가구는 포즈에 연동됩니다 — 포즈를 바꾸면 이전 가구가 정리되고 필요한 가구만 자동 설치됩니다.
• 오브젝트 이동 — 삼각대·캐릭터·소품 모두 클릭으로 선택 후 ⇧ Shift+드래그로 개별 이동합니다. 단순 드래그는 화면 회전, 빈 곳 클릭은 선택 해제입니다. (⌘+드래그 = 카메라 바로 이동)
• 표정·시선 — "표정·시선" 모달에서 촬영용 표정 9종(미소·활짝 웃음·시크·아련·윙크·놀람 등)과 방향 패드(카메라 응시·자유 타겟 포함)를 조정합니다. 마네킹에는 입 모양 4종으로 근사 표현되고, AI 생성 프롬프트에는 상세 표정이 반영됩니다.
• 카메라 — 프리셋, 높이(삼각대 텔레스코핑), 렌즈 24/35/50/85mm, 조준 높이. 탑다운은 천장 와이어 리그로 전환됩니다.
• 조명 — 5등(키·필·바운스·배경·탑)을 사이드바 칩에서 조명별로 켜고 끕니다(초기 = 전체 점등). 강도·위치는 [조명 상세 조정] 모달에서 조절하고, 우측 미리보기가 1초 간격으로 촬영 결과를 보여줍니다.
• 촬영 — 촬영 결과에는 장비·그림자·헬퍼가 제거되고 롤러 스크린 색상 배경으로 저장됩니다. 원본 이미지는 브라우저 DB에 보존됩니다.
• 촬영 리스트 — 컷 클릭 = 당시 설정 복원, 이름 클릭 = 수정. [개인/공용] 전환으로 다른 사용자에게 공개할 수 있으며, 탭(내 컷·즐겨찾기·공용)으로 구분해 조회합니다.
• 도움말 — 우측 하단 [촬영 도움말] 버튼에서 조작법 전체를 확인할 수 있습니다.

포즈 편집기 /posedoll/

• 파츠를 클릭해 관절 기즈모로 직접 회전 — 가동범위(joint_limits)가 자동 적용됩니다.
• 프리셋 기반으로 수정한 포즈를 저장/불러오기, 미러·언두를 지원합니다.

모션 · 컷씬 /motion/

• 모션 — 대기·걷기·뛰기·손 흔들기 재생, 속도 조절, 전진 이동(무대 왕복)과 카메라 추적.
• 컷씬 — 촬영 감독이 연출한 3부작(은신·격투·추적)을 시네마틱 카메라와 레터박스로 감상합니다. 재생 중에는 감독 카메라가 화면을 제어합니다.

AI 생성기 /generator/

• ① 촬영 컷 선택 — 스코프 필터(전체·내 컷·공용)로 구분해 선택. 내 컷은 이름 수정과 [개인/공용] 전환이 바로 가능하고, 다른 사용자의 공용 컷은 조회·참조 전용입니다. 선택한 컷은 포즈 레퍼런스(1번 첨부)로 지정됩니다.
• ② 가이드 프롬프트 — GPT/미드저니/Claude 3종 + 설정 JSON(포즈·표정 상세 서술 포함). 복사해서 외부 도구에 사용하세요.
• ③ AI 생성 — 라이브러리(모델·의상·악세사리·배경·소품·조명·포즈·스타일·기타)에서 선택하거나 드래그앤드롭으로 첨부하고, 관리자가 활성화한 Nano Banana Lite·Nano Banana·Nano Banana Pro·GPT Image 2 중 모델과 차감 크레딧을 확인해 생성합니다.
• 라이브러리 — 관리에서 등록 스코프(개인/공용)를 골라 등록하고, 항목별 [개인/공용] 전환·설명·삭제는 [저장] 시 반영됩니다. 개인·공용·다른 사용자 공용 섹션은 동일한 크기의 썸네일을 가로로 정렬합니다. 모델 이미지는 전용 미리보기의 원본 위에서 마우스를 자유롭게 드래그해 1:1 대표 영역을 선택하고, 화면에 표시된 영역 그대로 640×640 썸네일로 저장합니다. [썸네일 수정]에서는 저장된 선택 박스를 다시 불러와 내부 드래그로 이동하거나 네 모서리로 크기를 조절할 수 있습니다. 모델 카드를 클릭하면 왼쪽에 전체 원본이, 오른쪽 사이드 패널에 설명 편집·썸네일·기능 버튼이 표시되며, 저장된 썸네일이 없으면 화면용 자동 썸네일을 보여 줍니다. 첨부 화면은 내 라이브러리/공용 라이브러리 섹션으로 나뉘며 공용 등록·변경·삭제는 로컬 IP 또는 관리자 허용 IP에서만 활성화됩니다.
• 히스토리 — 내 기록/공용 탭으로 구분 조회. 상세에서 [공용으로 전환]하면 모든 사용자가 볼 수 있고, 타인 기록은 조회 전용입니다.
• 관리자 콘솔 — 관리자 계정은 상단 [관리자]에서 독립 /admin/ 콘솔로 이동합니다. 생성기 내부의 기존 환경설정은 서비스 설정과 사용자·크레딧 화면으로 포팅되었습니다.

마이페이지 /mypage/

로그인 후 상단의 사용자 이름을 선택하면 내 콘텐츠와 크레딧을 관리하는 개인 작업실로 이동합니다.

관리자 콘솔 /admin/

관리자 로그인과 로컬·허용 IP 확인을 모두 통과한 경우에만 접근할 수 있는 독립 운영 화면입니다.

관리자 REST 경로는 GET /api/admin/overview, 콘텐츠용 /api/admin/{shots|library|generations}, 게시판용 /api/admin/{inquiries|notices}입니다. 공지 첨부는 multipart/form-data로 업로드하며, 관리자 세션과 허용 IP를 모두 검사합니다.

문의·공지·즐겨찾기 REST API /api/mypage

공용 이미지 라이브러리 REST API /api/public-library

모델, 의상, 악세사리, 배경과 그 밖의 촬영 레퍼런스 이미지를 공용 라이브러리로 조회·관리합니다.

허용 분류: model, outfit, acc, background, prop, lighting, pose, style, other

# 조회 — 응답의 access.can_write로 현재 IP의 쓰기 가능 여부도 확인
curl 'https://studio.oootool.com/api/public-library?kind=background'

# 등록 — 먼저 로그인해 받은 HttpOnly 쿠키를 cookie.txt에 보관
curl -c cookie.txt -X POST 'https://studio.oootool.com/api/?action=login' \
  -H 'Content-Type: application/json' \
  --data '{"id":"관리자 또는 사용자 ID","password":"비밀번호"}'
curl -b cookie.txt -X POST 'https://studio.oootool.com/api/public-library' \
  -H 'Content-Type: application/json' \
  --data '{"id":"background-001","kind":"background","name":"회색 사이클로라마","caption":"중성 회색 스튜디오 배경","dataUrl":"data:image/jpeg;base64,...","thumb":"data:image/jpeg;base64,..."}'

# 변경 / 삭제
curl -b cookie.txt -X PATCH 'https://studio.oootool.com/api/public-library/background-001' \
  -H 'Content-Type: application/json' --data '{"caption":"부드러운 중성 회색 배경"}'
curl -b cookie.txt -X DELETE 'https://studio.oootool.com/api/public-library/background-001'

관리자 허용 IP는 DB 관리 권한으로 등록합니다.

INSERT INTO admin_ip_allowlist (ip_address, label, is_active)
VALUES ('203.0.113.10', '촬영 라이브러리 관리 PC', 1)
ON DUPLICATE KEY UPDATE label=VALUES(label), is_active=1;

로그인 · 계정