시온 바나나 (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 통합은 후속 작업
시작하기
사전 준비
- Node.js 18+ 설치
- ChatGPT 구독 활성 상태
- 필요하면 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 약관 검토 필요.
