란쯔란 무엇인가
란쯔는 독립적으로 실행할 수 있는 포즈 스튜디오이자 DeepSeek Harness 플러그인입니다. ai-pose-gallery-zh에 수록된 288개 그룹, 1,439장의 포즈 선화에서 하나 이상의 포즈를 선택한 다음 캐릭터 및 의상 참고 이미지와 결합해 같은 모델의 다양한 동작 이미지를 생성합니다.
프로젝트는 기본적으로 커뮤니티 캐릭터 고래 소녀의 성인형 이미지인 대비어를 모델로 사용합니다. 긴 웨이브 파란 머리, 고래 귀와 흰긴수염고래 꼬리를 지녔으며, 기본 의상은 네이비와 흰색 메이드복입니다. 최대 3장의 다른 모델 사진을 가져와 캐릭터의 얼굴과 의상을 바꿀 수도 있습니다.
포즈 선화는 신체 자세를 설명하는 용도로만 사용되며, 기본적으로 선화의 빈 신체가 최종 이미지에 그려지지는 않습니다. 선화는 프로젝트 저장소에 보관되지 않고 필요할 때 공개 이미지 호스팅에서 불러옵니다.
핵심 기능
- 풍부한 포즈 라이브러리: 288개 그룹, 1,439장의 포즈 선화를 제공하며 단일 선택과 다중 선택을 지원합니다.
- 의상 교체: COSTUME-DB-01의 1,407벌 의상 중 하나를 선택하고 캐릭터의 얼굴, 헤어스타일, 고래 귀와 고래 꼬리를 유지할 수 있습니다.
- 사용자 지정 모델: 최대 3장의 모델 사진을 가져오거나 기본 모델인 대비어를 계속 사용할 수 있습니다.
- 다양한 이미지 생성 인터페이스: 화산방주 Seedream, Gemini 및 OpenAI 호환 인터페이스를 지원합니다.
- 키 없이 사용하는 워크플로: API 키를 구성하지 않아도 완성된 프롬프트가 생성되며, 이를
dsh-image-gen에 복사해 사용할 수 있습니다. - Harness 통합: 플러그인을 설치하면 사이드바에서 전체 스튜디오를 열 수 있고, Agent가 포즈와 의상을 검색하고 이미지를 생성하도록 할 수도 있습니다.
- 반응형 인터페이스: 넓은 화면에서는 다중 열 레이아웃을 사용하고, 좁은 화면에서는 단일 열로 축소되며 이미지 생성 버튼은 하단에 유지됩니다.
로컬 스튜디오 실행
1. 환경 준비
란쯔는 Node.js 22.19 이상을 요구합니다. Node.js 버전이 요구 사항을 충족하는지 확인한 후 프로젝트 디렉터리에서 의존성을 설치하고 개발 서버를 시작합니다.
npm install
npm run dev시작한 후 브라우저에서 http://127.0.0.1:43123을 엽니다.
2. 포즈 선택
스튜디오 중앙 영역에서 포즈를 선택합니다. 한 번에 여러 포즈를 선택하면 시스템이 각각에 해당하는 이미지를 생성합니다. 표준 전신 포즈가 기본 페이지이며, 섹시 유형과 2인 포즈는 기본적으로 표시되지 않으므로 성인용 스위치를 명시적으로 켜야 합니다.
3. 의상 선택
의상 페이지로 전환하면 의상 한 벌을 선택할 수 있습니다. 봄, 여름, 가을, 겨울 및 파티 카테고리는 기본적으로 표시되며, 속옷·수영복·섹시 카테고리는 성인용 포즈와 같은 스위치를 공유합니다.
의상을 선택하면 생성 결과에 해당 의상이 사용되고 캐릭터의 얼굴, 헤어스타일 및 기타 특징이 최대한 유지됩니다. 이때 기본 의상 유지 옵션은 선택한 의상에 우선권을 양보합니다.
4. 모델 설정 또는 변경
왼쪽 영역에서 모델을 관리합니다. 기본 모델인 대비어를 계속 사용하거나 자신의 모델 사진을 최대 3장 가져올 수 있습니다. 여러 참고 이미지는 캐릭터의 얼굴, 헤어스타일 및 의상 정보를 제공하는 데 도움이 되지만, 실제 결과는 사용하는 이미지 생성 모델에 따라 달라집니다.
5. 이미지 생성 인터페이스 구성
오른쪽 상단의 이미지 생성 설정을 열고 Gemini 또는 OpenAI 호환 인터페이스에 필요한 키를 입력합니다. 키는 현재 브라우저에만 저장되며 프로젝트 데이터로 저장소에 기록되지 않습니다.
란쯔는 다음 기본 구성을 지원합니다.
- Seedream: 화산방주 주소
https://ark.cn-beijing.volces.com/api/v3를 사용하며, 기본 모델은doubao-seedream-5-0-flash-260915입니다. - Gemini: 기본 모델은
gemini-2.5-flash-image입니다. - OpenAI 호환 인터페이스: 먼저
images/edits를 호출합니다. 인터페이스가 편집을 지원하지 않으면 순수 텍스트 생성으로 대체되며, 결과에 참고 이미지가 전송되지 않았다는 안내가 표시됩니다.
Seedream에는 모델 이미지, 선택한 의상 이미지 및 포즈 선화를 함께 제출합니다. 의상을 선택한 경우 참고 이미지 순서는 캐릭터, 인물 없는 의상 이미지, 포즈 선화입니다.
6. 생성 시작
모델, 포즈, 의상 및 인터페이스 설정을 마친 후 이미지 생성 버튼을 클릭하면 생성이 시작됩니다. 키를 구성하지 않아도 오른쪽에서 선택한 각 포즈에 대한 프롬프트가 생성됩니다. 이 프롬프트를 복사해 설치된 dsh-image-gen에 전달하여 생성할 수 있습니다.
서버 측 키 구성
브라우저에 키를 입력하고 싶지 않다면 환경 변수를 통해 서버 프로세스에 제공업체, 모델, 인터페이스 주소 및 키를 구성할 수 있습니다.
POSE_MUSE_PROVIDER=seedream \
POSE_MUSE_MODEL=doubao-seedream-5-0-flash-260915 \
POSE_MUSE_BASE_URL=https://ark.cn-beijing.volces.com/api/v3 \
POSE_MUSE_API_KEY=내 키 \
npm run dev이 방식은 고정된 머신이나 관리되는 환경에 스튜디오를 배포할 때 적합합니다. 시작 후 프런트엔드는 브라우저에 키를 저장하지 않고 서버가 제공하는 이미지 생성 구성을 직접 사용할 수 있습니다.
DeepSeek Harness에 설치
머신에 DeepSeek Harness가 이미 설치되어 있다면 란쯔를 플러그인으로 web 프로필에 추가할 수 있습니다.
dsh plugin --profile web add gen-ai-pose-image플러그인 패키지 이름은 gen-ai-pose-image입니다. 패키지가 아직 공개되지 않았거나 로컬 수정 사항을 디버깅해야 한다면 패키지 이름을 저장소의 로컬 경로로 바꿀 수 있습니다. 설치가 완료되면 해당 프로필을 다시 시작합니다.
다시 시작하면 왼쪽 사이드바에 란쯔 / 스튜디오 항목이 추가되고 플러그인 및 자동화 작업과 나란히 표시됩니다. 이를 열면 같은 페이지에서 모델, 포즈 및 의상을 선택하고 이미지 생성 설정을 조정하며 결과를 확인할 수 있습니다.
Agent가 란쯔 도구를 호출하도록 설정
플러그인은 Agent에 세 가지 도구를 제공합니다.
search_poses: 조건에 맞는 포즈를 검색합니다.search_costumes: 의상을 검색합니다.generate_pose_images: 선택한 내용에 따라 포즈 이미지를 생성합니다.
의상을 변경하려면 의상 번호를 costume_id로 전달합니다. Harness 프로세스에 POSE_MUSE_API_KEY가 설정되어 있으면 도구가 이미지를 직접 생성해 세션에 연결합니다. 키가 없으면 도구가 준비된 프롬프트를 반환하므로 dsh-image-gen의 generate_image 또는 edit_image에 계속 전달할 수 있습니다.
성인용 포즈와 성인용 의상은 기본적으로 검색 결과에 표시되지 않습니다. 사용자가 명시적으로 요청한 경우에만
search_poses또는search_costumes에include_adult: true를 전달해야 합니다.
모바일 및 좁은 패널에서 사용
란쯔는 반응형 레이아웃을 지원합니다. 화면이 좁으면 모델 영역이 상단으로 접히고 포즈 카테고리는 드롭다운 선택으로 바뀌며 이미지 생성 버튼은 페이지 하단에 고정됩니다. 의상 카테고리는 자동으로 줄 바꿈되고 카드 설명도 표시 영역 안에 유지됩니다.
Harness의 좁은 패널에서도 기존의 다중 열 스튜디오는 단일 열로 축소되므로 별도의 모바일 버전으로 전환할 필요가 없습니다.
고급 사용 팁
여러 포즈 생성 구성
란쯔에서는 여러 포즈를 동시에 선택할 수 있습니다. 동작을 비교해야 한다면 먼저 모델과 의상을 고정한 다음 포즈 그룹을 선택해 일괄 생성하면 같은 캐릭터가 서로 다른 자세에서 얼마나 일관적인지 관찰하기 쉽습니다.
의상 참고 이미지의 역할 이해
의상 라이브러리의 이미지에는 인물이 포함되지 않으며 주로 의상의 외형을 제공하는 데 사용됩니다. 의상을 선택하면 란쯔는 캐릭터 참고 이미지, 의상 참고 이미지 및 포즈 선화를 함께 활용합니다. 인터페이스가 이미지 편집을 지원하지 않아 순수 텍스트 생성으로 대체되는 경우 참고 이미지는 제출되지 않으며, 결과 페이지에 이 상황이 명확하게 표시됩니다.
먼저 프롬프트로 흐름 확인
사용 가능한 API 키가 아직 없다면 포즈, 모델 및 의상을 먼저 선택하고 오른쪽에 생성된 프롬프트를 확인한 뒤 다른 이미지 생성 도구에 복사할 수 있습니다. 이렇게 하면 정식 인터페이스를 구성하기 전에 워크플로를 검증할 수 있습니다.
프로젝트 검사 실행
로컬 코드를 수정했거나 제출을 준비하기 전에 테스트와 타입 검사를 실행할 수 있습니다.
npm test
npm run typecheck저작권 및 사용 제한
란쯔 자체 프로그램은 MIT License를 사용하지만, 이 라이선스는 프로그램 코드에만 적용되며 포즈, 의상 및 캐릭터 참고 이미지에 자동으로 적용되지 않습니다.
- 포즈 선화와 원본 데이터의 저작권은 ギア에 있으며, 상위 프로젝트 설명에 따르면 이 이미지는 상업적 용도로 사용할 수 없습니다.
- 의상 이미지는 ギア의 의상집 COSTUME-DB-01에서 제공되며, 저장소에는 번호와 키워드만 보관됩니다.
- 대비어 설정 이미지는 deepseek-whale-girl에서 제공되며, 작성자는 TreapGoGo이고 해당 저장소의 MIT 라이선스에 따라 사용됩니다.
- 대비어는 커뮤니티 캐릭터로 DeepSeek를 대표하지 않습니다. DeepSeek는 深度求索의 상표이며 프로젝트 라이선스는 해당 상표에 대한 권리를 부여하지 않습니다.
생성 결과를 게시하거나 사용하기 전에 프로젝트의 shared/license.mjs 및 LICENSE를 확인하고 각 소재에 적용되는 별도의 라이선스와 사용 제한을 준수해야 합니다.
정리
란쯔는 캐릭터 참고 이미지, 포즈 선화, 인물 없는 의상 이미지 및 이미지 생성 인터페이스를 하나의 스튜디오로 통합합니다. 로컬에서 포즈와 의상을 빠르게 선택할 수 있고, 플러그인을 DeepSeek Harness에 설치해 Agent가 소재를 검색하고 이미지를 생성하도록 할 수도 있습니다. 사용을 시작할 때는 먼저 로컬 스튜디오를 실행해 흐름을 확인한 다음 실제 인터페이스에 맞춰 브라우저 또는 서버 측 키를 구성하면 됩니다.