Open Generative Studio

오픈소스, 자체 호스팅 가능한 AI 제작 스튜디오. 하나의 캔버스에서 이미지, 비디오, 립싱크, 시네마틱 클립, 마케팅/UGC 광고를 생성하세요 - 노드 기반 워크플로우 빌더, 사용자별 크레딧 지갑, 호스팅 MCP 서버를 갖추고 있어 AI 에이전트(Claude, ChatGPT, Cursor)가 내 인스턴스를 통해 미디어를 생성할 수 있습니다.

모델 추론은 Atlas Cloud 가 제공합니다 - API 키 하나로 최신 이미지, 비디오, 오디오 및 LLM 모델(FLUX, Qwen-Image, Kling, Seedream, DeepSeek 등)에 접근할 수 있습니다.

기능

• 이미지 스튜디오 - 참조 이미지가 포함된 텍스트-이미지 및 이미지-이미지 생성, 멀티 모델 선택기, 생성별 실시간 비용 표시.

• 비디오 스튜디오 - 텍스트-비디오, 이미지-비디오, 참조-비디오 생성, 멀티 이미지/비디오/오디오 참조 지원.

• 립싱크 - 초상화 + 오디오(업로드 또는 브라우저에서 녹음)로 말하는 비디오 생성.

• 마케팅 스튜디오 - 템플릿 기반 UGC/제품 광고 비디오 생성.

• Flow - 노드 기반 워크플로우 빌더(React Flow): LLM, 이미지, 비디오, 오디오 노드를 연결하고, 하나의 프롬프트를 N개의 변형으로 확장하며, 예제 미디어가 포함된 사전 구축 커뮤니티 템플릿 라이브러리에서 시작할 수 있습니다.

• MCP 서버 - OAuth 2.1 원클릭 연결을 지원하는 호스팅 Model Context Protocol 엔드포인트로, 에이전트가 내 인스턴스에서 generate_image, generate_video, get_balance 등을 호출할 수 있습니다.

• 크레딧 지갑 - 원자적 Postgres 크레딧 연산(차감/환불/정산), 추가 전용 트랜잭션 원장, 선택적 Razorpay 충전, 프로모션 코드, 2단계 제휴 프로그램.

• 프로덕션 강화 - 실패 시 환불 생성 파이프라인, 장시간 비디오 작업을 위한 비동기 제출 및 조정, Supabase Storage로의 결과 재호스팅, 속도 제한, 관리자 비즈니스 메트릭 대시보드.

아키텍처 (60초 요약)

Browser (studio canvas)
   |  POST /api/generate { model, prompt, ... }
   v
Next.js API route - Supabase auth -> atomic credit deduction -> dispatch
   |
   |  model_costs.source drives the dispatcher:
   |    'atlascloud' -> lib/atlascloud/client.js  (primary provider)
   |    'kie.ai' / 'muapi.ai' -> optional secondary adapters
   v
Atlas Cloud  (async prediction -> polled by the reconciler -> result re-hosted
              into Supabase Storage -> row completed / auto-refunded on failure)

• 프론트엔드: Next.js 15 (App Router) + React + Tailwind.

• 백엔드: Next.js API 라우트 + Supabase (Postgres, Auth, Storage).

• 추론: Atlas Cloud - 앱은 서버 측에서만 https://api.atlascloud.ai와 통신하며, API 키는 브라우저에 절대 노출되지 않습니다.

빠른 시작

git clone https://github.com/nextgentrainingacademy88-max/open-generative-studio.git
cd open-generative-studio
cp .env.local.example .env.local   # paste your Supabase + Atlas Cloud keys
npm install
npm run build:packages
npm run dev                        # http://localhost:3000

전체 가이드(Supabase 마이그레이션, 스토리지 버킷, 모델 등록): SETUP.md.

Atlas Cloud 제공

이 프로젝트는 모델 추론 제공자로 Atlas Cloud를 사용합니다:

• LLM - OpenAI 호환 POST /v1/chat/completions 엔드포인트를 통해.

• 이미지 - POST /api/v1/model/generateImage를 통해 (FLUX, Qwen-Image, Seedream, ...).

• 비디오 - POST /api/v1/model/generateVideo를 통해 (Kling, Vidu, ...).

• 비동기 예측은 GET /api/v1/model/prediction/{id}에서 폴링되며 내장 조정기(reconciler)가 최종 처리합니다.

환경에 ATLASCLOUD_API_KEY를 설정하고 원하는 모델을 model_costs 테이블 (source = 'atlascloud')에 등록하세요 - 주석이 포함된 예시는 supabase/migrations/0052_atlascloud_provider.sql를 참조하세요. 키는 서버 측에서만 읽히며 이 저장소에 커밋되지 않습니다.

저장소 둘러보기

app/                    Next.js App Router - marketing pages, studio, wallet,
                        affiliate portal, blog, /api routes (generate, workflow,
                        razorpay, mcp, cron)
components/             App shell, marketing sections, admin charts, UI primitives
lib/                    Server-side core: credit ops, pricing, dispatch
  atlascloud/client.js  Atlas Cloud adapter (images, video, chat)
  generate-core.js      Auth -> deduct -> dispatch -> refund-on-failure pipeline
  generation-reconcile.js  Async poll + re-host + true-up
  flow/                 Workflow engine (poll-driven, fan-out, CAS-claimed ticks)
  mcp/                  MCP tools + auth (API keys + OAuth via Supabase)
packages/               Vendored studio UI + workflow-builder (React Flow)
supabase/migrations/    Full schema: wallet, generations, model catalog, promo,
                        affiliate program, security hardening
scripts/                Template seeders + maintenance scripts
skills/                 Agent skill bundle for the MCP server

크레딧 및 계보

Anil-matcha/Open-Generative-AI (MIT)에서 시작하여 대대적으로 재구축되었습니다: 크레딧 지갑 SaaS 백엔드, 서버 측 제공자 디스패치, Flow 워크플로우 엔진 + 빌더 UX, OAuth가 포함된 MCP 서버, 제휴 프로그램, 관리자 분석, 보안 강화, 마케팅 사이트.

라이선스

MIT - 자유롭게 사용, 자체 호스팅, 수정 및 재배포할 수 있습니다.