FAQ

자주 묻는 질문

설치, 실행, 분기 — 핵심만 짧게.

설치

Codex 데스크톱 앱으로도 되나요?

아니요. Codex CLI로 실행됩니다. CLI가 없으면 ima2-gen이 첫 실행 때 설치를 안내하고, 로그인 창을 띄워줍니다. 안내대로 깔면 바로 시작할 수 있습니다.

어떻게 설치하나요?

터미널(macOS / Linux) 또는 PowerShell(Windows)을 엽니다. npm install -g ima2-gen으로 전역 설치하고 ima2 serve로 실행하세요. 브라우저에서 http://localhost:3333을 열면 됩니다.

npm install -g ima2-gen

ima2 serve

npm이 뭔가요? 한 번에 설치하는 방법이 있나요?

npm은 Node.js 패키지 매니저입니다. 처음이라면 OS별 설치 스크립트를 사용할 수 있습니다. 스크립트는 Node가 없으면 설치를 안내하고, ima2-gen 설치와 서버 실행을 돕습니다.

macOS

curl -fsSL https://lidge-jun.github.io/ima2-gen/install-mac.sh | bash

Windows PowerShell

irm https://lidge-jun.github.io/ima2-gen/install-windows.ps1 | iex

Windows / PowerShell에서도 되나요?

됩니다. Windows 10 이상, PowerShell 5.1 또는 PowerShell 7을 지원합니다. 공개 설치 스크립트는 GitHub Pages에서 제공되며, 실행 전 모든 명령을 화면에 출력합니다.

Node 모드는 언제 쓰나요?

마음에 든 결과에서 여러 방향을 비교하고 싶을 때 씁니다. 프롬프트, 구도, 색감을 노드별로 바꿔 보면서 원본은 그대로 남깁니다. 새로고침해도 request ID를 기준으로 결과를 다시 불러옵니다.

한 번에 몇 장까지 만들 수 있나요?

Classic은 한 번에 최대 8장까지 병렬로 만들 수 있습니다. Node에서는 자식 노드마다 별도 요청이 가니, 할당량이 허용하는 만큼 가지를 펼칠 수 있습니다.

레퍼런스 이미지를 붙일 수 있나요?

프롬프트당 다섯 장까지 붙일 수 있습니다. 컴포저에 끌어 놓거나 붙여 넣으면 끝. 큰 파일은 자동으로 압축돼서 업로드되므로 미리 손볼 필요는 없습니다.

Style sheet은 어떻게 쓰나요?

매체, 구도, 분위기, 팔레트, 제외할 요소를 시트로 묶어 두고 프롬프트에 붙여 쓰면 됩니다. 시트는 세션을 넘겨도 유지되므로 같은 룩을 다음 작업에서도 그대로 가져갈 수 있습니다.

OpenAI API key가 필요한가요?

이미지 생성에는 필요 없습니다. 로컬에 로그인된 Codex/ChatGPT 계정을 그대로 사용합니다. API key가 설정돼 있어도 이미지 생성 경로는 로그인 세션을 우선 사용하도록 설계되어 있습니다.

이미지는 어디 저장되나요?

로컬 사용자 데이터 폴더에 이미지와 작업 기록이 저장됩니다. 직접 확인, 동기화, 버전 관리까지 가능합니다. 이미지 파일을 별도 외부 저장소에 올리지 않습니다.

내 컴퓨터에서 어떤 데이터가 나가나요?

이미지 생성 요청은 OpenAI로 전송됩니다. 결과 파일과 작업 기록은 로컬에만 남습니다. ima2-gen이 별도로 수집하는 분석 데이터나 외부 저장소는 없습니다.

오프라인에서도 되나요?

이미지 생성은 OpenAI API 호출이 필요해 인터넷이 있어야 합니다. 로컬 갤러리 보기, 세션 정리, 스타일 시트 편집은 오프라인에서도 됩니다.

오픈소스인가요?

네. ima2-gen은 MIT 라이선스로 공개되어 있습니다. 코드는 GitHub에서 볼 수 있습니다.

github.com/lidge-jun/ima2-gen