개발자 문서

ima2-gen 개발자 문서

ima2-gen은 npx로 실행하는 로컬 이미지 생성 스튜디오입니다. Classic에서 만들고, Node 그래프에서 분기하고, Multimode 배치로 후보를 펼치고, Canvas Mode에서 마음에 든 컷을 정리하세요 — 전부 내 컴퓨터에서, 기본 OAuth·설정된 API key·번들 Grok/progrok 중 필요한 경로로.

npx ima2-gen serve # 그다음 http://localhost:3333 열기

여기서 시작

빠른 시작 →
설치하고, 인증 방식을 고르고, 바로 만들기 시작.
아키텍처 →
CLI, 서버, 라우트 모듈, UI가 어떻게 맞물리는지.
CLI 레퍼런스 →
대부분의 라우트 그룹에 CLI 래퍼가 있고, Agent Mode는 웹 UI 전용입니다.

무엇을 하나

  • Classic 모드 — 한 프롬프트, 한 장의 강한 프레임. 생성·편집하고 어떤 결과에서든 이어갑니다.
  • Node 모드 — 기준 이미지를 고정하고 색감·구도·카피로 자식을 그래프로 펼칩니다.
  • Multimode — 하나의 프롬프트에서 여러 Classic 후보를 슬롯별 진행과 함께 실행합니다.
  • Canvas Mode — 확대·주석·배경 정리 후 투명(alpha) 또는 matte 버전으로 export합니다.
  • Video — 텍스트, 이미지, 또는 최대 7장의 레퍼런스에서 Grok Video로 짧은 영상을 만듭니다.
  • 프롬프트 라이브러리 — 파일·GitHub 폴더·추천 소스에서 prompt pack을 가져와 로컬에 인덱싱합니다.

각각 언제 쓰는지는 생성 모드를 보세요.

설계부터 로컬 & 오픈

무료 ChatGPT OAuth, Grok OAuth(SuperGrok), OpenAI API 키, 또는 조합으로 생성합니다. 만든 이미지, 영상, 작업 기록은 외부 서버가 아니라 내 컴퓨터(~/.ima2)에 남습니다. ima2-gen은 MIT 라이선스입니다.

더 알아보려면 프로바이더 & 모델과 설정을 참고하세요.