시온 바나나 (Sion Banana) — 로컬 도구 버전

본인의 ChatGPT 구독 자격으로 PC에서 직접 돌리는 AI 이미지 + 스토리보드 워크플로우 도구다. Firebase 기반 멀티테넌트 백엔드나 별도 API 과금 없이 Codex OAuth 인증으로 ChatGPT Codex Responses 경로를 호출한다. 현재 코드 기본값은 텍스트·이미지 요청 모두 gpt-5.5이며, 이미지 요청에는 image_generation 도구를 붙인다. 모델은 환경변수로 재정의할 수 있다.

기술 스택

• Next.js 14 (App Router) + React 18 + TypeScript
• TailwindCSS + Radix UI
• React Query + Zustand
• OAuth: 로컬 웹 장치 로그인 결과 data/codex-auth.json을 우선 사용하고, Codex CLI의 auth.json을 폴백으로 읽어 chatgpt.com/backend-api/codex/responses 호출
• 데이터 저장: 생성 이미지·영상과 JSON 메타데이터는 로컬 파일시스템, 일부 캐릭터·스토리 편집 상태는 브라우저 localStorage; SQLite 통합은 후속 작업

시작하기

사전 준비

1. Node.js 18+ 설치
2. ChatGPT 구독 활성 상태
3. 필요하면 Codex CLI 로그인 (웹 장치 로그인 대신 사용할 폴백):

   npx @openai/codex login
   

   브라우저가 열리면 본인의 ChatGPT 계정으로 로그인. 이후 ~/.codex/auth.json에 토큰이 저장된다.

실행

git clone <레포 URL>
cd sionbanana
npm install
npm run dev

http://localhost:3000 에서 접속.

첫 실행에서는 /auth의 장치 로그인 흐름을 사용할 수 있다. 성공한 웹 인증은 로컬 데이터 디렉터리의 codex-auth.json에 권한 0600으로 저장된다. 웹 인증 파일이 없으면 CHATGPT_LOCAL_HOME, CODEX_HOME, ~/.chatgpt-local, ~/.codex 순으로 CLI 인증을 찾는다.

환경 변수 (모두 선택)

.env.local에 필요 시 작성. 항목은 .env.example 참고.

SIONBANANA_DATA_DIR=          # 데이터 디렉토리. 비워두면 ./data
CODEX_HOME=                    # ~/.codex 외 다른 위치를 쓸 때만
CHATGPT_LOCAL_HOME=            # 보조 인증 디렉토리
CODEX_RESPONSES_ENDPOINT=      # 보통 변경 불필요
DEFAULT_TEXT_MODEL=gpt-5.5
DEFAULT_IMAGE_MODEL=gpt-5.5      # image_generation 도구를 요청하는 모델

동작 확인

먼저 /api/health를 호출해서 인증 상태를 확인:

curl http://localhost:3000/api/health

응답에 codex.authenticated: true 가 보이면 OK. false면 npx @openai/codex login을 다시 실행.

테스트

pure 함수 단위 테스트는 Node.js 내장 test runner로 실행한다.

npm test

타입 정합성은 기존 TypeScript 설정으로 확인한다.

npm run typecheck

주요 페이지

• /studio — 단일 이미지 생성
• /studio/variations — 변형 생성
• /studio/batch — 배치 생성
• /studio/presets — 프리셋 기반 생성
• /studio/history — 생성 기록
• /studio/characters — 로컬 캐릭터 라이브러리
• /studio/story — 스토리 프로젝트
• /studio/motion — 모션 에셋 편집·내보내기
• /prompt — 스토리보드 / Sora 프롬프트 생성기
• /presets — 프리셋 둘러보기
• /usage — Codex 사용량 상태

주요 API 라우트

라우트	설명
GET/POST/DELETE /api/auth/*	웹 장치 로그인 상태·시작·poll·logout
POST /api/generate	Codex OAuth 이미지 생성 (gpt-5.5 기본 + image_generation)
POST /api/storyboard	스토리보드 텍스트 생성 (JSON / 자연어 / Sora 템플릿)
POST /api/prompt	프롬프트 최적화
GET /api/storyboard/styles	영상 스타일 목록
GET /api/images, GET/DELETE /api/images/[id]	파일시스템 이미지 목록·조회·삭제
POST /api/video, GET /api/videos/[id]	영상 생성·조회
GET/POST/PATCH/DELETE /api/motion/projects/*	모션 프로젝트·에셋·export
GET /api/usage	Codex 사용량 조회
GET /api/download	외부 이미지 프록시 다운로드
GET /api/health	Codex 인증 상태 확인

Webtoon Studio 로컬 WIP

현재 작업 디렉터리에는 /studio/webtoon 페이지, /api/webtoon/projects 라우트, 컴포넌트, lib/webtoon 저장·타입 모듈, 표적 테스트 등 untracked 16파일이 있다. 이 파일은 보존 중인 로컬 WIP이며 현재 canonical 후보 커밋이나 clean checkout에 포함된 구현이 아니다. 따라서 Webtoon Studio를 완료 기능으로 안내하거나 배포 대상으로 간주하지 않는다.

약관 / 면책

• 본 도구는 OpenAI Codex CLI의 OAuth 토큰을 직접 활용해 ChatGPT 백엔드 API를 호출한다. 약관상 회색 영역이며, 본인 ChatGPT 계정으로 본인 PC에서만 사용할 것을 권장.
• GitHub에 공개 배포 시 OpenAI가 차단할 가능성이 있다.
• ChatGPT 구독 사용 한도 (이미지 일일 한도 등)는 OpenAI 백엔드가 강제하므로, 별도 코드에서 분기하지 않는다.

마이그레이션 메모

이 레포는 Firebase 기반 SaaS 시온바나나에서 로컬 단일 사용자 도구로 전환된 결과물이다. 자세한 작업 지시서는 REDESIGN_PLAN.md 참고.

남은 후속 작업:

• lib/firebase/* stub 파일 완전 제거 (호출처 정리 후)
• SQLite 기반 메타데이터 통합. 현재 app/api/images는 파일시스템 JSON을 사용한다.
• 약관 변경 추적 + 모델 이름 업데이트 자동화

라이선스

내부용. 외부 배포 시 OpenAI 약관 검토 필요.