banana-slides 완벽 입문: 3단계 Fork 및 오픈소스 AI PPT 생성기 배포 (APIYI 설정 튜토리얼)

작성자 주: banana-slides는 nano banana pro를 기반으로 하는 오픈소스 AI PPT 생성 애플리케이션입니다. 이 글에서는 초보자 관점에서 전체 Fork 및 배포 과정을 소개하고, 기본 AIHubMix 프록시를 APIYI로 교체하여 더욱 안정적인 모델 호출을 구현하는 방법을 알려드립니다.

GitHub에서 최근 큰 인기를 끌고 있는 오픈소스 AI PPT 생성기 banana-slides를 소개합니다. 이 도구는 Google의 최신 nano banana pro 이미지 모델을 기반으로 하며, "한 문장으로 편집 가능한 PPT 생성, 영상 내보내기 지원, 자연어로 영역 수정" 기능을 내세워 현재 GitHub에서 14K 이상의 스타를 기록하고 있습니다.

이 도구는 단순한 AI PPT 래퍼(Wrapper)가 아닙니다. 로컬 배포가 가능하고 소스 코드가 완전히 공개된 진정한 "Vibe PPT" 시스템으로, Gemini, OpenAI, Anthropic, Vertex AI 등 다양한 모델 형식을 지원합니다. 공식 문서에서는 기본적으로 AIHubMix를 프록시로 사용할 것을 권장합니다.

핵심 가치: 이 글을 읽고 나면 banana-slides 프로젝트를 Fork하고 로컬에 배포하는 방법을 배우게 됩니다. 더 나아가, 기본 AIHubMix 프록시를 APIYI(apiyi.com) 중계 서비스로 교체하는 전체 설정 방법을 익혀 무제한 동시 접속, 네이티브 형식 지원, 100달러 충전 시 10% 추가 적립이라는 비용 효율성을 누릴 수 있습니다.

1. banana-slides란 무엇인가: 오픈소스 AI PPT 생성기의 3가지 핵심 포지셔닝

banana-slides는 개발자 Anionex가 주도하는 오픈소스 프로젝트로, nano banana pro 기반의 네이티브 AI PPT 생성 애플리케이션을 지향합니다. 핵심 철학은 "Vibe PPT"로, 대화형 언어를 통해 AI에게 슬라이드 생성, 수정, 반복 작업을 지시할 수 있습니다.

1.1 banana-slides의 핵심 포지셔닝

포지셔닝	banana-slides의 특징	기존 AI PPT 도구와의 차이점
기반 모델	nano banana pro 이미지 생성 기반	템플릿 조합 방식
배포 방식	완전 오픈소스 + 로컬 배포	클라우드 종속 SaaS
라이선스	AGPL-3.0 (상업적 이용 시 허가 필요)	폐쇄형 구독제
수정 방식	자연어 "Vibe 편집"	드래그 앤 드롭 수동 편집
입력 형식	PDF/DOCX/MD/TXT 등 자유	텍스트/개요만 지원
내보내기	편집 가능한 PPTX + PDF + MP4 (TTS 포함)	대부분 PPTX만 지원
API 제공자	다수 지원, 기본 AIHubMix 권장	단일 공급자 종속

1.2 왜 banana-slides가 초보자에게 주목받는가

AI PPT 생성 분야를 처음 접하신다면, banana-slides는 상용 SaaS보다 훨씬 "자유로운" 선택지를 제공합니다.

완전 오픈소스 코드: 2차 개발 및 프라이빗 배포 가능
뛰어난 이미지 품질: nano banana pro를 사용하여 기존 PPT 템플릿을 뛰어넘는 이미지 생성
다양한 모델 적응성: Gemini, OpenAI, Anthropic 등 원하는 모델을 백엔드로 사용 가능
유연한 API 교체: 기본값은 AIHubMix이지만, APIYI(apiyi.com)와 같은 호환 서비스로 쉽게 교체 가능

💡 초보자를 위한 조언: Google API 키나 OpenAI 키가 없다면, APIYI(apiyi.com)의 중계 서비스를 사용하는 것이 가장 간편합니다. 하나의 키로 Gemini, Claude, GPT 등 모든 모델을 사용할 수 있어 여러 곳에 계정을 신청하는 번거로움을 덜 수 있습니다.

1.3 banana-slides는 어떤 사용자에게 적합한가

학생: 과제나 졸업 논문 발표용 PPT를 빠르게 제작해야 하는 분
교사: 수업 자료를 이미지와 텍스트가 풍부한 슬라이드로 변환하고 싶은 분
직장인: 비즈니스 제안서, 프로젝트 보고서, 분기별 실적 보고가 필요한 분
개발자: AI PPT 도구를 프라이빗 환경에 배포하고 싶은 팀
디자이너: AI가 생성한 레이아웃에서 영감을 얻고 싶은 분

2. banana-slides 핵심 기능: 4가지 주요 특성 상세 분석

banana-slides의 기능 설계는 "PPT 제작의 문턱을 낮춘다"는 핵심 목표를 중심으로, 크게 4가지 영역의 역량을 갖추고 있습니다.

2.1 다중 경로 콘텐츠 생성

banana-slides는 다양한 상황에 맞춰 세 가지 콘텐츠 입력 방식을 지원합니다.

입력 방식	사용 상황	출력 단위
한 문장 생성	즉석 발표, 아이디어 초안	AI가 개요 + 전체 페이지 자동 생성
개요 모드	명확한 구조가 있을 때	개요에 따라 페이지별 내용 자동 확장
페이지 설명 모드	정밀한 제어 필요 시	페이지별 텍스트 + 이미지 직접 지정

2.2 소재 지능형 해석

banana-slides는 다양한 형식의 소재 파일을 받아 핵심 정보를 자동으로 추출합니다.

PDF: 텍스트, 이미지, 차트 데이터 자동 추출
DOCX: 섹션 구조 및 삽입된 이미지 해석
Markdown: H1/H2 계층 구조 유지
TXT: 핵심 포인트 지능형 추출

즉, 기술 문서를 banana-slides에 드래그 앤 드롭하는 것만으로도 AI가 완성된 발표 자료로 변환해 줍니다.

2.3 자연어 기반 "바이브(Vibe) 편집"

이 기능은 banana-slides의 가장 혁신적인 부분입니다. PPT 생성 후, 자연어를 사용하여 페이지를 자유롭게 수정할 수 있습니다.

"3페이지를 사례 분석 스타일로 바꿔줘"
"제목에 주황색 배경을 넣어줘"
"이 페이지의 이미지가 너무 복잡해, 깔끔한 라인 스타일로 바꿔줘"

AI가 수정 위치를 정확히 파악하여 다시 생성합니다. 마치 실제 디자이너와 대화하는 듯한 경험을 제공하죠.

🎯 사용 팁: 바이브 편집은 여러 번의 모델 호출을 유발합니다(수정할 때마다 전체 프롬프트 + 이미지 생성 과정이 진행됨). 긴 PPT(20페이지 이상)를 작업할 때는 APIYI(apiyi.com)의 API 중계 서비스를 사용하여 공식 인터페이스의 속도 제한 문제를 피하는 것을 추천합니다.

2.4 다중 형식 내보내기

내보내기 형식	특징	추천 상황
편집 가능한 PPTX	텍스트, 이미지, 도형 수정 가능	후속 미세 조정이 필요할 때
이미지 기반 PPTX	페이지별 고화질 이미지	레이아웃 깨짐 방지
PDF	플랫폼 간 안정적인 표시	배포 및 인쇄용
MP4 영상	TTS 음성 + 자막 포함	녹화 강의, 자동 발표

MP4 내보내기는 한국어, 영어, 일본어 TTS 음성을 지원하며 다양한 음색을 선택할 수 있어 교육용으로 특히 유용합니다.

3. Fork 및 로컬 환경에 banana-slides 배포: 3단계 빠른 시작

3.1 시스템 환경 요구 사항

banana-slides를 배포하기 전에 로컬 환경이 다음 조건을 충족하는지 확인하세요:

의존성	버전 요구 사항	설명
Docker	20.x+	Docker Compose 배포 권장
Python	3.10+	소스 코드 배포 시 필요
Node.js	16+	프론트엔드 개발 시 필요
LibreOffice	선택 사항	PPTX 업로드 및 파싱용
Git	제한 없음	Fork 및 클론용

3.2 1단계: 내 계정으로 저장소 Fork 하기

브라우저에서 GitHub 프로젝트 페이지 github.com/Anionex/banana-slides를 열고, 오른쪽 상단의 Fork 버튼을 클릭하여 저장소를 내 계정으로 가져옵니다. Fork를 하면 다음과 같은 이점이 있습니다:

이후 나만의 수정 사항(특히 API 설정)을 커밋할 수 있음
상위 저장소 업데이트를 가져올 때 충돌 처리가 편리함
팀 단위 배포 및 협업에 용이함

Fork가 완료되면 로컬로 클론합니다:

# YOUR_USERNAME을 본인의 GitHub 사용자 이름으로 변경하세요
git clone https://github.com/YOUR_USERNAME/banana-slides.git
cd banana-slides

3.3 2단계: 설정 파일 생성

예제 설정 파일을 복사하여 실제 설정 파일로 만듭니다:

cp .env.example .env

.env 파일에는 모든 API 키, Base URL, 모델 선택 등의 설정 항목이 포함되어 있습니다. 다음 장에서 APIYI API 중계 서비스로 교체하는 방법을 자세히 설명합니다.

3.4 3단계: Docker Compose로 실행

가장 간단한 실행 방법은 Docker Compose를 사용하는 것입니다:

docker compose -f docker-compose.prod.yml up -d

실행 후 다음 주소로 접속하세요:

프론트엔드 인터페이스: http://localhost:3000
백엔드 API: http://localhost:5000

소스 코드에서 직접 실행하고 싶다면(2차 개발용), 백엔드와 프론트엔드를 각각 실행하세요:

# 백엔드
uv sync
uv run alembic upgrade head
uv run python app.py

# 프론트엔드 (새 터미널 창)
cd frontend
npm install
npm run dev

3.5 배포 성공 여부 확인

http://localhost:3000에 접속했을 때 다음이 확인되어야 합니다:

✅ banana-slides 홈페이지(노란색 바나나 테마)
✅ "새 PPT 만들기" 버튼 클릭 가능
✅ 주제를 입력했을 때 정상적으로 생성됨

생성 시 "API connection failed" 오류가 발생한다면, 보통 .env 파일의 API 키나 Base URL 설정이 잘못된 경우입니다. 다음 장의 APIYI 중계 서비스 설정 내용을 참고하여 해결하세요.

4. AIHubMix를 APIYI로 교체: banana-slides 설정 완벽 가이드

banana-slides 공식 문서에서는 기본적으로 AIHubMix를 API 프록시로 추천하지만(docs.bananaslides.online/configuration#aihubmix-recommended-proxy), 이를 APIYI(apiyi.com)로 교체하면 더 저렴한 가격, 무제한 동시 접속, 그리고 훨씬 안정적인 국내 중계망을 이용할 수 있습니다.

4.1 왜 APIYI를 선택해야 할까요?

AIHubMix는 banana-slides의 기본 추천 프록시이지만, 장기적으로 banana-slides를 사용하는 사용자에게 APIYI(apiyi.com)는 다음과 같은 확실한 장점을 제공합니다:

비교 항목	AIHubMix (기본)	APIYI apiyi.com (추천)
결제 방식	USD / 국내 원화	국내 원화 (위챗/알리페이)
가격 혜택	표준 가격	100달러 충전 시 10% 추가 증정 (공식 대비 약 15% 할인)
동시 접속 제한	요금제별 차등	동시 접속 제한 없음
API 형식	OpenAI/Gemini 호환	OpenAI/Gemini/Anthropic 원본 형식 완벽 호환
연동 난이도	base_url 변경	base_url 변경 (동일하게 간편함)
장애 조치	단일 채널	다중 데이터센터 로드 밸런싱
기술 지원	티켓 시스템	한국어 상담 + 커뮤니티 지원

4.2 .env 파일 수정: Gemini 형식 (nano banana pro용 권장)

banana-slides는 기본적으로 Gemini 형식을 사용하여 nano banana pro를 호출합니다. .env 파일을 열고 다음 설정을 찾으세요:

수정 전 (AIHubMix 기본 설정):

AI_PROVIDER_FORMAT=gemini
GOOGLE_API_KEY=your-aihubmix-key
GOOGLE_API_BASE=https://aihubmix.com/gemini

수정 후 (APIYI apiyi.com으로 교체):

AI_PROVIDER_FORMAT=gemini
GOOGLE_API_KEY=sk-your-apiyi-key-here
GOOGLE_API_BASE=https://vip.apiyi.com/gemini

🎯 핵심 설명: APIYI apiyi.com은 Gemini 원본 형식의 base_url 경로 설계를 완벽하게 지원하므로, 도메인 aihubmix.com을 vip.apiyi.com으로 바꾸기만 하면 되며, 경로 /gemini는 그대로 유지하면 됩니다.

4.3 .env 파일 수정: OpenAI 형식

GPT 시리즈 모델을 사용하여 PPT 텍스트를 생성하려면 OpenAI 형식으로 전환할 수 있습니다:

수정 전:

AI_PROVIDER_FORMAT=openai
OPENAI_API_KEY=your-aihubmix-key
OPENAI_API_BASE=https://aihubmix.com/v1

수정 후 (APIYI로 교체):

AI_PROVIDER_FORMAT=openai
OPENAI_API_KEY=sk-your-apiyi-key-here
OPENAI_API_BASE=https://vip.apiyi.com/v1

4.4 .env 파일 수정: Anthropic 형식

Claude 모델을 사용하여 더 높은 품질의 PPT 텍스트를 생성하고 싶다면, banana-slides의 Anthropic 형식 지원을 활용하세요:

수정 후 (APIYI로 교체):

AI_PROVIDER_FORMAT=anthropic
ANTHROPIC_API_KEY=sk-your-apiyi-key-here
ANTHROPIC_API_BASE=https://vip.apiyi.com

4.5 혼합 설정: 텍스트와 이미지에 서로 다른 모델 사용

banana-slides는 텍스트 생성과 이미지 생성에 서로 다른 모델 소스를 사용할 수 있습니다. 예를 들어, Claude Sonnet 4.5로 텍스트를 생성하고, nano banana pro로 이미지를 생성하는 설정입니다:

# 텍스트 생성 - Anthropic 형식으로 Claude 호출
TEXT_MODEL_PROVIDER=anthropic
TEXT_MODEL_NAME=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-your-apiyi-key-here
ANTHROPIC_API_BASE=https://vip.apiyi.com

# 이미지 생성 - Gemini 형식으로 nano banana pro 호출
IMAGE_MODEL_PROVIDER=gemini
IMAGE_MODEL_NAME=gemini-2.5-flash-image
GOOGLE_API_KEY=sk-your-apiyi-key-here
GOOGLE_API_BASE=https://vip.apiyi.com/gemini

💡 주요 장점: APIYI apiyi.com의 API 키 하나로 Gemini, OpenAI, Anthropic 세 가지 형식의 모든 모델을 동시에 호출할 수 있습니다. 각 서비스마다 별도의 계정을 신청할 필요가 없어 공식 직연결보다 훨씬 편리합니다.

4.6 서비스 재시작 및 확인

.env 수정 후, banana-slides를 재시작하여 설정을 적용하세요:

# Docker Compose 모드
docker compose -f docker-compose.prod.yml down
docker compose -f docker-compose.prod.yml up -d

# 소스 코드 모드
# uv run python app.py 재실행

프론트엔드에서 테스트 PPT를 생성해 봅니다. 예: "AI Agent에 관한 5페이지짜리 PPT 만들어줘". 터미널 로그를 확인하세요:

✅ Connecting to https://vip.apiyi.com/... 메시지가 보이면 APIYI 중계가 정상 작동 중입니다.
✅ 응답 시간 < 30초 (초기 생성 시)
✅ 429 / 503 오류 없음

4.7 내 Fork에 수정 사항 커밋 (팀 배포용)

팀 단위로 배포하는 경우, 수정된 .env.example을 본인의 Fork에 커밋할 수 있습니다(실제 .env 파일은 커밋하지 않도록 주의하세요):

# .env.example.apiyi 설정 템플릿 생성
cp .env .env.example.apiyi
# 파일을 편집하여 실제 API 키를 플레이스홀더로 교체
# 커밋
git add .env.example.apiyi
git commit -m "feat: add APIYI (apiyi.com) configuration template"
git push origin main

이렇게 하면 팀원들이 내 Fork를 클론한 후, 이 템플릿을 복사하여 바로 사용할 수 있어 설정을 찾는 시간을 절약할 수 있습니다.

5. banana-slides 실전 시나리오: 5가지 대표 활용 사례

5.1 시나리오 1: 학생의 빠른 수업 발표 PPT 제작

목표: 30분 이내에 10페이지 분량의 수업 발표 PPT 완성

작업 프로세스:

banana-slides를 열고 "한 문장 생성" 모드 선택
주제 입력 (예: "양자 컴퓨팅 원리에 대한 입문 강의")
AI가 자동으로 개요 생성 (약 30초 소요)
전체 페이지 생성 클릭 (약 5-8분 소요, 이미지 생성 속도에 따라 다름)
Vibe 편집기로 개별 페이지 미세 조정
PPTX로 내보내기

API 사용량 예상: 10페이지 PPT 기준 약 50-80K 토큰(텍스트) + 10-15회 이미지 생성. 속도 제한을 피하기 위해 APIYI(apiyi.com) API 중계 서비스를 사용하는 것을 권장합니다.

5.2 시나리오 2: 교사의 수업 계획안을 교육용 자료로 변환

목표: 기존 Word 수업 계획안을 이미지와 텍스트가 풍부한 교육용 PPT로 변환

작업 프로세스:

DOCX 수업 계획안 파일 업로드
banana-slides가 자동으로 섹션 구조 분석
"섹션별 페이지 생성" 선택
AI가 각 지식 포인트에 맞는 이미지 생성
MP4로 내보내기 (TTS 중국어 더빙 포함), 녹화 강의로 즉시 활용 가능

5.3 시나리오 3: 직장인의 비즈니스 제안서 작성

목표: 요구 사항 설명을 바탕으로 전문적인 비즈니스 제안서 PPT 생성

작업 프로세스:

"페이지 설명 모드"를 선택하여 각 페이지 내용을 세밀하게 제어
회사 로고와 브랜드 컬러를 템플릿 참조용으로 업로드
Vibe 편집기를 사용하여 각 페이지의 이미지 스타일 조정
편집 가능한 PPTX로 내보낸 후, 마지막 세부 사항 수정

5.4 시나리오 4: 기술 블로거의 제품 발표회 자료 제작

목표: 3시간 이내에 30페이지 분량의 제품 발표회 PPT 완성

작업 프로세스:

제품 기능 Markdown 문서 준비
banana-slides에 업로드하고 "H2/H3 태그로 페이지 분할" 선택
AI가 자동으로 시각적 이미지 생성
템플릿 이미지를 사용하여 시각적 스타일 통일
PDF + PPTX 이중 형식으로 내보내기

5.5 시나리오 5: 팀을 위한 프라이빗 배포

목표: 회사 내부망에 banana-slides를 배포하여 팀 전체가 사용하도록 설정

작업 프로세스:

저장소를 회사 GitHub 조직으로 Fork
.env 설정을 APIYI(apiyi.com) 중계 서비스로 수정
내부 서버에 배포 (Docker Compose 사용)
Nginx로 내부 도메인 설정
팀원들이 내부망을 통해 접속

💡 시나리오 공통 제안: 위 5가지 시나리오 모두 대량의 API 호출이 발생합니다(모든 PPT는 다수의 텍스트 생성 + 이미지 생성을 포함). PPT 생성 속도가 공식 인터페이스의 속도 제한에 영향을 받지 않도록, banana-slides를 APIYI(apiyi.com) 중계 서비스에 연결하여 무제한 동시 접속의 이점을 누리시길 권장합니다.

6. banana-slides 자주 묻는 질문 (FAQ)

Q1: banana-slides와 시중의 AI PPT 도구(Gamma, MindStudio 등)의 차이점은 무엇인가요?

핵심 차이는 오픈 소스 여부와 커스터마이징 가능성입니다. Gamma와 같은 상용 도구는 클라우드 기반 SaaS로 페이지당 또는 월간 구독료를 지불해야 합니다. 반면, banana-slides는 오픈 소스 프로젝트(AGPL-3.0 라이선스)로, 로컬 배포가 가능하며 소스 코드를 자유롭게 수정하고 원하는 AI 모델을 연동할 수 있습니다.

가끔 PPT를 만드는 정도라면 Gamma가 편리할 수 있지만, 다음과 같은 요구사항이 있다면 banana-slides가 더 나은 선택입니다.

팀 단위 프라이빗 배포
API 비용 제어
생성 로직 수정
국내에서 원활하게 접속 가능한 API 사용

APIYI(apiyi.com) 중계 서비스를 활용하면 완벽하게 자율적인 제어가 가능합니다.

Q2: Google API 키가 없는데, Gemini를 신청해야만 banana-slides를 쓸 수 있나요?

아닙니다. banana-slides는 세 가지 API 형식(Gemini / OpenAI / Anthropic)을 지원하므로, 어느 한 곳의 키만 있어도 바로 시작할 수 있습니다.

가장 쉬운 방법은 APIYI(apiyi.com)에 계정을 등록하는 것입니다. 하나의 키로 Gemini(nano banana pro 이미지 생성 포함), GPT, Claude를 모두 호출할 수 있어 각각 신청하는 번거로움을 덜 수 있습니다. 위안화 결제 및 위챗/알리페이를 지원합니다.

Q3: AIHubMix를 APIYI로 교체하면 기존 기능에 영향이 있나요?

전혀 없습니다. banana-slides는 환경 변수 GOOGLE_API_BASE 및 OPENAI_API_BASE를 통해 API 호출 주소를 결정합니다. 교체하려는 서비스 제공업체가 해당 API 프로토콜을 호환한다면(APIYI(apiyi.com)는 Gemini, OpenAI, Anthropic 원본 형식을 완벽하게 호환), nano banana pro 이미지 생성, TTS 더빙, Vibe 편집 등 모든 기능이 정상적으로 작동합니다.

Q4: APIYI에서 nano banana pro의 모델명은 무엇인가요?

APIYI(apiyi.com)에서 nano banana pro에 대응하는 공식 모델 ID는 gemini-2.5-flash-image(Google 공식 명칭)입니다. banana-slides의 .env 파일에 다음과 같이 설정할 수 있습니다.

IMAGE_MODEL_NAME=gemini-2.5-flash-image
GOOGLE_API_BASE=https://vip.apiyi.com/gemini

Q5: 30페이지 PPT 제작에 드는 API 비용은 어느 정도인가요?

예상 비용은 다음과 같습니다:

텍스트 생성(개요 + 내용): 약 100-200K 토큰
이미지 생성(페이지당 1-2장): 약 30-60회 호출
총비용: APIYI(apiyi.com) 충전 시 제공되는 10% 보너스(약 15% 할인 효과) 적용 시, 약 1-3달러 수준

Q6: 회사 서버에 배포하면 여러 명이 동시에 사용할 때 느려지지 않나요?

주요 병목 현상은 API 동시성에서 발생합니다. banana-slides 자체는 Flask + SQLite 아키텍처로, 단일 서버에서 10-20명이 동시에 사용할 수 있습니다. 병목 현상은 보통 API 호출 계층에서 발생합니다. 공식 API 인터페이스를 사용하면 속도 제한에 걸리지만, APIYI(apiyi.com) 중계 서비스를 사용하면 무제한 동시 접속 혜택을 누릴 수 있어 여러 명이 동시에 PPT를 생성해도 제한되지 않습니다.

Q7: banana-slides를 상업적으로 이용하려면 비용을 지불해야 하나요?

네, 그렇습니다. banana-slides는 AGPL-3.0 라이선스를 따르며, 개인 및 비상업적 용도로는 무료입니다. 상업적 배포 시에는 저자에게 연락하여 상업용 라이선스를 구매해야 합니다(문의 이메일: [email protected]). 상업용 라이선스를 구매하더라도 API 중계 부분은 APIYI(apiyi.com)를 계속 사용할 수 있으며, 두 사항은 서로 충돌하지 않습니다.

Q8: banana-slides의 업데이트를 지속적으로 확인하려면 어떻게 해야 하나요?

저장소를 Fork 하셨다면, 다음과 같이 정기적으로 상위 저장소의 업데이트를 동기화할 수 있습니다.

# 상위 저장소 추가
git remote add upstream https://github.com/Anionex/banana-slides.git

# 상위 업데이트 가져오기
git fetch upstream
git checkout main
git merge upstream/main

# 내 Fork 저장소로 푸시
git push origin main

수정한 .env 설정이 덮어쓰이지 않도록 주의하세요.

7. banana-slides 핵심 요약

✅ banana-slides는 오픈소스 AI PPT 생성기입니다. nano banana pro 이미지 모델을 기반으로 하며, GitHub에서 14K 이상의 스타를 받았습니다.
✅ 다양한 입력 방식 지원: 한 문장, 개요, 페이지 설명, PDF/DOCX/MD/TXT 자료 업로드 등.
✅ 3가지 내보내기 형식: 편집 가능한 PPTX, PDF, MP4 영상(TTS 더빙 포함).
✅ Fork + 배포 3단계: Fork → cp .env.example .env → docker compose up.
✅ 3가지 API 형식 지원: Gemini(기본값), OpenAI, Anthropic.
✅ AIHubMix를 APIYI로 교체 시 base_url만 변경: aihubmix.com을 vip.apiyi.com으로 바꾸기만 하면 됩니다.
✅ APIYI(apiyi.com)의 장점: 네이티브 형식 호환, 동시 접속 제한 없음, 100달러 충전 시 10% 추가 증정(약 15% 할인 효과), 위챗/알리페이 등 원화 충전 지원.
✅ API 키 하나로 3가지 형식 모두 사용: Gemini/OpenAI/Anthropic 모두 완벽 호환.

8. 결론

banana-slides는 장기적으로 주목할 만한 오픈소스 AI PPT 생성기입니다. nano banana pro의 이미지 생성 능력과 'Vibe 편집' 인터랙션 방식을 결합하여, 일반인도 30분 안에 전문가 수준의 프레젠테이션을 만들 수 있게 해줍니다.

직접 Fork하여 배포하려는 개발자에게는 API 서비스 제공업체 설정이 가장 중요한 단계입니다. 공식적으로 추천하는 AIHubMix도 좋지만, APIYI(apiyi.com)로 교체하면 다음과 같은 확실한 이점이 있습니다. Gemini/OpenAI/Anthropic 세 가지 네이티브 형식을 완벽하게 지원하여 비즈니스 코드를 수정할 필요가 없고, 동시 접속 제한이 없어 대규모 PPT 작업도 원활하며, 100달러 충전 시 10% 추가 제공으로 비용 절감 효과(공식 홈페이지 대비 약 15% 할인)와 국내 결제(위챗/알리페이)의 편리함까지 누릴 수 있습니다.

교체 과정도 매우 간단합니다. .env 파일 내 GOOGLE_API_BASE(또는 OPENAI_API_BASE, ANTHROPIC_API_BASE)를 https://aihubmix.com/...에서 https://vip.apiyi.com/...으로 변경하고 APIYI의 키를 입력하기만 하면 됩니다.

팀 단위의 AI PPT 생성 시스템을 구축하거나, 본인 또는 학생들을 위한 무료 입문용 PPT 도구를 찾고 있다면 banana-slides와 APIYI(apiyi.com) 조합은 현재 국내 개발자에게 가장 친화적인 솔루션입니다. 오늘 바로 프로젝트를 Fork 해보세요. 1시간 안에 AI로 생성된 첫 번째 PPT를 완성할 수 있습니다.

🎯 다음 단계 제안: 먼저 APIYI(apiyi.com)에 접속하여 계정을 생성하고 API 키를 발급받으세요. 그다음 github.com/Anionex/banana-slides를 본인의 GitHub으로 Fork 하고, 본 가이드 4장에 설명된 설정 방식에 따라 .env를 수정한 뒤 서비스를 시작해 보세요. 한 문장의 프롬프트로 첫 번째 PPT를 생성하며 전체 과정을 확인해 보시기 바랍니다.

참고 자료

banana-slides GitHub 저장소: 프로젝트 메인 저장소
- 링크: github.com/Anionex/banana-slides
- 설명: 전체 소스 코드, Docker Compose 설정, 영문 README 포함
banana-slides 공식 문서: 설정 및 배포 가이드
- 링크: docs.bananaslides.online/configuration
- 설명: AIHubMix 추천 프록시 섹션 포함, 본 가이드에서는 APIYI로 대체하는 방법을 다룹니다.
nano banana pro 모델 설명: Google 공식 이미지 생성 모델
- 링크: ai.google.dev/gemini-api/docs/image-generation
- 설명: 모델 ID는 gemini-2.5-flash-image입니다.
APIYI 공식 홈페이지: Claude / Gemini / OpenAI API 중계 서비스 플랫폼
- 링크: apiyi.com
- 설명: 네이티브 형식 호환, 동시 접속 제한 없음, 위안화 충전 지원, 100달러 충전 시 10% 추가 증정 혜택 제공

작성자: 기술 팀
최종 업데이트: 2026-05-01
APIYI 소개: APIYI(apiyi.com)는 전문적인 AI 대규모 언어 모델 API 중계 서비스 제공업체입니다. Gemini(nano banana pro 포함), Claude Sonnet 4.5, Claude Opus 4.7, GPT 시리즈 등 모든 모델에 대한 안정적인 액세스를 지원하며, Gemini/OpenAI/Anthropic의 네이티브 형식을 완벽하게 호환합니다. 100달러 충전 시 10% 추가 증정(공식 홈페이지 대비 약 15% 할인 효과) 혜택을 제공하며, 동시 접속 제한이 없고 기술 지원 응답이 빠릅니다.

1. banana-slides란 무엇인가: 오픈소스 AI PPT 생성기의 3가지 핵심 포지셔닝

1.1 banana-slides의 핵심 포지셔닝

1.2 왜 banana-slides가 초보자에게 주목받는가

1.3 banana-slides는 어떤 사용자에게 적합한가

2. banana-slides 핵심 기능: 4가지 주요 특성 상세 분석

2.1 다중 경로 콘텐츠 생성

2.2 소재 지능형 해석

2.3 자연어 기반 "바이브(Vibe) 편집"

2.4 다중 형식 내보내기

3. Fork 및 로컬 환경에 banana-slides 배포: 3단계 빠른 시작

3.1 시스템 환경 요구 사항

3.2 1단계: 내 계정으로 저장소 Fork 하기

3.3 2단계: 설정 파일 생성

3.4 3단계: Docker Compose로 실행

3.5 배포 성공 여부 확인

4. AIHubMix를 APIYI로 교체: banana-slides 설정 완벽 가이드

4.1 왜 APIYI를 선택해야 할까요?

4.2 .env 파일 수정: Gemini 형식 (nano banana pro용 권장)

4.3 .env 파일 수정: OpenAI 형식

4.4 .env 파일 수정: Anthropic 형식

4.5 혼합 설정: 텍스트와 이미지에 서로 다른 모델 사용

4.6 서비스 재시작 및 확인

4.7 내 Fork에 수정 사항 커밋 (팀 배포용)

5. banana-slides 실전 시나리오: 5가지 대표 활용 사례

5.1 시나리오 1: 학생의 빠른 수업 발표 PPT 제작

5.2 시나리오 2: 교사의 수업 계획안을 교육용 자료로 변환

5.3 시나리오 3: 직장인의 비즈니스 제안서 작성

5.4 시나리오 4: 기술 블로거의 제품 발표회 자료 제작

5.5 시나리오 5: 팀을 위한 프라이빗 배포

6. banana-slides 자주 묻는 질문 (FAQ)

Q1: banana-slides와 시중의 AI PPT 도구(Gamma, MindStudio 등)의 차이점은 무엇인가요?

Q2: Google API 키가 없는데, Gemini를 신청해야만 banana-slides를 쓸 수 있나요?

Q3: AIHubMix를 APIYI로 교체하면 기존 기능에 영향이 있나요?

Q4: APIYI에서 nano banana pro의 모델명은 무엇인가요?

Q5: 30페이지 PPT 제작에 드는 API 비용은 어느 정도인가요?

Q6: 회사 서버에 배포하면 여러 명이 동시에 사용할 때 느려지지 않나요?

Q7: banana-slides를 상업적으로 이용하려면 비용을 지불해야 하나요?

Q8: banana-slides의 업데이트를 지속적으로 확인하려면 어떻게 해야 하나요?

7. banana-slides 핵심 요약

8. 결론

참고 자료

Similar Posts