2Slides Team
11 min read
AI 프레젠테이션 API 활용 사례: 팀별 12가지 자동화 레시피 (2026)
AI 프레젠테이션 API는 트리거(새 CRM 행, 월요일 크론, 커리큘럼 스프레드시트, 승인된 임상 문서 등)를 받아 PowerPoint를 열지 않고 완성된 데크를 생성합니다. 이 허브는 이를 실행하는 팀별 12가지 제작 레시피를 매핑합니다: 영업, 고객 성공, 마케팅, 콘텐츠, 교육, 헬스케어, 컨설팅, 전자상거래, 재무, 인사, 그리고 AI 에이전트를 개발하는 엔지니어링 팀. 모든 레시피는 동일한 2Slides API의 7개 엔드포인트를 사용하며, 편집 가능한 PPTX 페이지당 예측 가능한 10 크레딧(약 $0.025), 이미지 디자인 페이지당 100~200 크레딧이 소요되고, Zapier, Make, n8n, 순수 Python 또는 Node, MCP를 통한 코딩 에이전트와 연동됩니다.
공개: 2Slides는 저희 제품입니다. 다른 공급업체가 레시피를 제공하는 경우 명시합니다. Gamma의 API 페이지도 유사한 자동화 레시피 세트(Make + Claude 캐러셀, n8n + HubSpot 온보딩 데크, Zapier + Sheets 제안서)를 공개하며, 두 API 간 개발자 수준 차이는 Gamma Generate API vs 2Slides API에서 확인할 수 있습니다.
핵심 요약
- 아래 모든 레시피는 하나의 패턴으로 축약됩니다: 트리거 → 구조화된 데이터로 프롬프트 생성 → 세 가지 생성 엔드포인트 중 하나에
POST→ 5~10초마다GET /api/v1/jobs/{id}폴링 → 파일 전달. - 편집 가능한 PPTX 데크는 페이지당 10 크레딧; 10페이지 제안서는 2,000 크레딧당 $5 요금 기준 약 $0.25, 40,000 크레딧 요금제에서는 $0.20.
- 이미지 디자인 데크(맞춤 아트 디렉션 또는 참조 이미지 기반 브랜드 매칭)는 10 크레딧 계획 비용에 페이지당 100 크레딧(2K 해상도)이며, 페이지당 210 크레딧으로 내레이션 가능하고 MP4로 내보낼 수 있음.
- API 키는 500 무료 크레딧이 포함된 모든 계정에 발급되므로 개념 증명 비용은 없음; 생성 엔드포인트는 키당 분당 6회 요청 제한, 작업 폴링은 분당 10회 제한.
- 동일한 7개 작업이 MCP 서버 및 Agent Skill로도 제공되어 Claude Code 또는 Codex 세션에서 자동화 전 인터랙티브하게 레시피 실행 가능.
대상 독자
이 허브는 운영 엔지니어, RevOps 및 마케팅 운영 책임자, 에듀테크 및 헬스테크 개발자, 그리고 데이터에서 콘텐츠를 생성하고 수동 디자인 단계를 제거하려는 에이전시 팀을 위한 것입니다. 주당 한 개의 데크를 수작업으로 만든다면 2slides.com/fast-ppt 웹 앱이 통합보다 빠르며, 반복적이거나 개인화되거나 시간 기반 트리거가 있는 데크에는 API가 효과적입니다.
12가지 레시피 개요
| # | 팀 | 트리거 | 엔드포인트 | 출력 | 10페이지 데크 비용 | 레시피 |
|---|---|---|---|---|---|---|
| 1 | 콘텐츠 | 주제 시트 또는 Notion 데이터베이스 새 행 | create-pdf-slides (4:5 또는 9:16), 선택적 generate-narration | 캐러셀 PDF + 페이지별 PNG, 선택적 MP4 | 약 1,010 크레딧 ($2.53) | 소셜 미디어 캐러셀 자동화 |
| 2 | 영업 | Google Sheets 또는 CRM 내 신규 잠재 고객 행 | themes/search + generate | 계정별 편집 가능한 PPTX 제안서 | 100 크레딧 ($0.25) | 대규모 개인화 영업 제안서 |
| 3 | 영업 | HubSpot 거래 단계 변경 | generate (비동기) | 거래에 첨부된 편집 가능한 PPTX 피치 데크 | 100 크레딧 ($0.25) | HubSpot 영업 데크 자동화 |
| 4 | 고객 성공 | Closed Won 웹훅; 85일 스케줄 | generate; 선택적 create-like-this 브랜드 매칭용 | 온보딩 시작 데크, 90일 리뷰 데크 | 100 크레딧 ($0.25) | 고객 온보딩 데크 자동화 |
| 5 | 마케팅 | 캠페인 지표 월요일 크론 | create-pdf-slides → generate-narration → download-slides-pages-voices | 요약 데크 + 2인 내레이션 MP4 | 약 3,110 크레딧 ($7.78) | 마케팅 보고서 데크 및 내레이션 비디오 |
| 6 | 재무 / 운영 | Sheets 주간 보고서 데이터 | Zapier를 통한 generate | 편집 가능한 PPTX 주간 보고서 | 100 크레딧 ($0.25) | Zapier로 주간 보고서 슬라이드 자동화 |
| 7 | 교육 | 커리큘럼 스프레드시트 또는 LMS 내보내기 | 수업별 generate; 선택적 내레이션 강의 경로 | 수업 및 언어별 수업 PPTX; 비디오 강의 | 수업당 100 크레딧 ($0.25) | 수업 슬라이드 프로그래밍 생성 |
| 8 | 교육 / 언어 | 레벨별 단어 목록 | 배치 generate | 100개 어휘 데크 | 100개 데크당 10,000 크레딧 ($22.50) | 어휘 데크 배치 생성 |
| 9 | 헬스케어 | 승인된 익명화 소스 문서 | 조건 및 언어별 generate; 직원 교육용 create-pdf-slides + 내레이션 | 20개 이상 언어의 환자 교육 데크; 내레이션 서비스 비디오 | 환자 데크당 100 크레딧 ($0.25) | 환자 교육 슬라이드 자동화 |
| 10 | 컨설팅 / 연구 | 주제 폼 또는 스케줄 | Tavily 또는 Exa → LLM → generate 또는 create-pdf-slides | 출처가 명확한 12슬라이드 브리프 | 편집 가능 120 크레딧 ($0.30); 이미지 디자인 약 1,210 크레딧 | 연구-데크 파이프라인 |
| 11 | 전자상거래 | 카탈로그 내 신규 SKU 또는 시즌 출시 | 판매 시트용 generate; 캠페인 키 비주얼로 create-like-this | 소매업체 데크 + 브랜드 일치 출시 데크 | 100 크레딧 ($0.25) / 약 1,010 크레딧 ($2.53) | 제품 카탈로그 → 영업 데크 |
| 12 | 엔지니어링 / AI 에이전트 | Claude Code, Codex, Cursor 또는 커스텀 에이전트 내 프롬프트 | MCP 도구 themes_search → slides_generate (동일 API, 동일 크레딧) | 위 모든 레시피를 인터랙티브하게 실행 | 사용한 엔드포인트와 동일 | Agent Skills vs MCP 서버 |
비용은 2,000 크레딧당 $5 요금제($0.0025/크레딧)를 기준으로 산출. 40,000 크레딧 팩은 크레딧당 $0.002. 이미지 디자인 데크는 2K 해상도, 10페이지 기준이며 4K는 페이지당 비용이 200 크레딧으로 두 배.
모든 레시피의 작동 방식
Authorization: Bearer <key> 헤더 포함; 키는 API Keys 탭에서 생성하며 서버 측에만 보관해야 함.
12개 레시피는 네 가지 핵심 요소를 공유합니다.
1. 구조화된 데이터가 있는 트리거. 스프레드시트 행, CRM 웹훅 페이로드, 데이터 웨어하우스 쿼리 크론 작업, 검토를 통과한 문서 등. 데크 품질은 입력 품질에 좌우되므로 대부분 팀은 API 호출보다 프롬프트 템플릿에 더 많은 시간을 투자합니다.
2. 해당 데이터로 구성된 프롬프트. 직접 필드를 요약해 간단한 개요를 만들거나(Company: Acme. Industry: logistics. Pain points: ...), LLM이 슬라이드별 개요를 먼저 작성하게 할 수 있습니다. 두 방법 모두 가능하며, 비정형 소스(연구 노트, 통화 기록)일 때는 LLM 단계가 특히 중요합니다.
3. 세 가지 생성 엔드포인트 중 하나.
| 엔드포인트 | 생성물 | 적합 용도 | 크레딧 |
|---|---|---|---|
POST /api/v1/slides/generate | 1,500개 이상의 템플릿(themeId) 중 하나로부터 네이티브 편집 가능한 PPTX | 사람이 이후 편집할 모든 것: 제안서, 보고서, 수업 데크 | 페이지당 10 |
POST /api/v1/slides/create-pdf-slides | designStyle 프롬프트 기반 이미지 디자인 슬라이드; 512px~4K; 모든 종횡비 | 시각 중심 출력: 캐러셀, 출시 데크, 비디오 소스 | 10 + 페이지당 100 (2K) |
POST /api/v1/slides/create-like-this | 동일하나 전체 디자인이 referenceImageUrl에서 유도됨 | 수백 개 데크에 걸친 엄격한 브랜드 일치 | 10 + 페이지당 100 (2K) |
responseLanguage는 "Spanish" 같은 언어명을 받으며 기본값은 Auto.
4. 폴링 후 전달. Fast PPT generate는 기본적으로 동기 실행되며 한 번의 호출로 다운로드 URL을 반환해 스크립트에서 편리함. 배치 시 mode: "async"를 전달하고, 트리거 레코드 옆에 jobId를 저장한 후 GET /api/v1/jobs/{id}를 폴링해 status가 success 또는 failed가 될 때까지 대기. 전달은 이메일, Slack, Drive 저장, CRM 레코드 첨부 등 기존 스택에 따라 수행.
모든 레시피에서 재사용 가능한 최소 Node.js 워커 예:
const API = "https://2slides.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.SLIDES_API_KEY}`,
"Content-Type": "application/json",
};
async function generateDeck({ userInput, themeId, responseLanguage = "Auto" }) {
const res = await fetch(`${API}/slides/generate`, {
method: "POST",
headers,
body: JSON.stringify({ userInput, themeId, responseLanguage, mode: "async" }),
});
const { jobId } = await res.json();
for (let i = 0; i < 60; i++) {
await new Promise((r) => setTimeout(r, 8000));
const job = await (await fetch(`${API}/jobs/${jobId}`, { headers })).json();
if (job.status === "success") return job.downloadUrl;
if (job.status === "failed") throw new Error(`Job ${jobId} failed`);
}
throw new Error(`Job ${jobId} timed out`);
}이 함수 앞에 큐를 두세요: 생성 엔드포인트는 키당 분당 6회 요청 허용, 따라서 200개 데크는 약 35분의 실제 시간 소요(사용자 시간은 아님).
사용 사례별 파이프라인 선택
모든 레시피에서 반복되는 질문은 "편집 가능한 PPTX인가, 이미지 디자인 슬라이드인가?"입니다. 답은 다음 데크를 누가 다루는지에 따라 달라집니다.
| 상황 | 선택 | 이유 |
|---|---|---|
| 사람이 이후 숫자, 가격, 문구를 편집할 예정 | generate (Fast PPT) | PPTX 내 실제 텍스트 박스와 레이아웃; 페이지당 10 크레딧 |
| 수백 개 데크가 단일 브랜드 슬라이드와 완벽히 동일해야 함 | create-like-this | 템플릿이 아닌 참조 이미지에서 디자인 시스템 유도 |
| 출력물이 캐러셀, 소셜 포스트, 비디오임 | create-pdf-slides | 종횡비 제어(4:5, 9:16, 1:1) 및 페이지별 PNG 내보내기 |
| 데크가 내레이션 비디오로 제공됨 | create-pdf-slides 또는 create-like-this → generate-narration | 내레이션 및 MP4 내보내기는 이미지 디자인 파이프라인에서만 가능 |
| 대량으로 가장 저렴한 단가가 필요함 | generate | 10페이지 100개 어휘 데크가 10,000 크레딧 ($22.50) |
GET /api/v1/themes/search의 시각적 버전. 테마를 한 번 선택해 themeId를 고정하면 모든 생성 데크가 해당 디자인을 상속.
create-like-this에 슬라이드 하나를 referenceImageUrl로 전달 가능.
워크플로우 도구 대신 AI 에이전트에서 레시피 실행하기
위 모든 엔드포인트는 MCP 도구(slides_generate, slides_create_pdf_slides, slides_create_like_this, slides_generate_narration, slides_download_slides_pages_voices, themes_search, jobs_get)로도 제공되며, 동일 작업이 코딩 에이전트를 위한 SKILL.md로 패키징됨. 실제로 팀은 Claude Code 또는 Codex 세션에서 레시피를 프로토타입("컨설팅 테마 검색, 연구 자료로 12슬라이드 브리프 독일어 생성")하고 프롬프트가 안정되면 n8n이나 크론 작업으로 이전합니다.
두 통합 스타일 간 트레이드오프는 Agent Skills vs MCP servers for presentations에서, Claude 전용 설정은 How to use Claude MCP to generate presentations에서 다룹니다.
현실적인 볼륨에서 레시피 비용
| 팀 및 볼륨 | 파이프라인 | 월별 크레딧 | 월별 USD ($0.0025 기준) |
|---|---|---|---|
| 영업: 200 제안서 × 10페이지 | generate | 20,000 | $50 (20,000 크레딧 팩 사용 시 $42.50) |
| 고객 성공: 60 온보딩 + 60 리뷰 데크 × 10페이지 | generate | 12,000 | $30 |
| 마케팅: 주간 4회 요약 × 8페이지, 내레이션 포함 | create-pdf-slides + 내레이션 | 약 10,000 | $25 |
| 콘텐츠: 30 캐러셀 × 7페이지, 2K 해상도 | create-pdf-slides | 21,300 | $53 |
| 교육: 40 수업 × 12페이지 | generate | 4,800 | $12 |
| 헬스케어: 25 조건 × 8페이지 × 6개 언어 | generate | 12,000 | $30 |
모든 행에 구독 필요 없음; 선택적 Pro 플랜은 고정 요금을 원하는 팀에 월 10,000 크레딧 추가 제공.
모든 레시피에서 흔한 실수
- 요청 제한. 키당 분당 6회 생성 요청. 큐와 대기 사용; 429 오류를 빠른 반복으로 재시도하지 말 것.
- 키 위치 오류. API 키는 서버, n8n 자격 증명, Zapier 웹훅 단계에만 있어야 하며, 브라우저나 공유된 시트에 노출 금지.
- 잘못된 파이프라인 내레이션.
generate-narration은create-pdf-slides또는create-like-this작업만 허용. Fast PPT 데크는 내레이션 불가. - 언어 코드.
responseLanguage는 "Japanese" 같은 언어명 사용, "ja" 같은 코드 아님. - 과도한 입력 크기. 40페이지 소스를 슬라이드 개요로 요약 후 생성; 데크 품질은 개요 품질에 의존.
- 자동 페이지 수 문제.
page: 0은 모델이 슬라이드 수 결정; 하위 템플릿이 고정 페이지 수를 요구하면 명시적으로 전달.
자주 묻는 질문
AI 프레젠테이션 API는 무엇에 사용되나요?
AI 프레젠테이션 API는 구조화된 데이터나 텍스트로부터 수동 디자인 없이 슬라이드 데크를 생성하며, 다른 시스템 이벤트에 의해 트리거됩니다. 가장 일반적인 용도는 CRM 데이터 기반 개인화 영업 제안서, 분석 기반 반복 보고서 데크, 온보딩 및 교육 데크, 수업별 강의 슬라이드, 콘텐츠 캘린더 기반 소셜 캐러셀입니다.
어떤 팀이 프레젠테이션 자동화로 가장 큰 혜택을 받나요?
유사한 데크를 많이 만드는 팀이 가장 유리합니다: 영업 및 고객 성공(계정별 1개 데크), 마케팅 및 에이전시(클라이언트별 주간 보고서), 교육(수업 또는 언어별 1개 데크), 헬스케어 커뮤니케이션(조건 및 언어별 1개 데크). 한 달에 한 번 맞춤형 데크를 만드는 팀은 웹 앱이 더 적합할 수 있습니다.
프레젠테이션 API를 사용하려면 Zapier, Make, n8n이 필요한가요?
아니요. HTTPS 요청을 보낼 수 있는 모든 언어에서 가능합니다. 위 Node.js 워커 예제가 완전한 예입니다. Zapier, Make, n8n은 트리거가 이미 해당 플랫폼에 존재(예: Sheets 행, HubSpot 단계 변경)하고, 코드 작성 없이 이메일, Slack, Drive 등 전달 단계를 자동화할 때 유용합니다.
API로 100개의 프레젠테이션을 생성하는 비용은 얼마인가요?
2Slides API 기준, 10페이지 편집 가능한 PPTX 100개는 10,000 크레딧이며, 10,000 크레딧 팩 가격으로 $22.50입니다. 2K 해상도 이미지 디자인 데크 100개는 약 101,000 크레딧, 40,000 크레딧 팩 가격($0.002/크레딧)으로 약 $202입니다. 작업 폴링, 테마 검색, 페이지별 내보내기는 무료입니다.
Claude Code 같은 AI 에이전트가 이 레시피를 실행할 수 있나요?
네. 7개 API 작업은 MCP 서버(호스팅 또는 npx -y 2slides-mcp@latest)와 Agent Skill로 노출되어 Claude Code, Codex, Cursor 등 유사 에이전트가 동일 키와 크레딧으로 테마 검색, 데크 생성, 내레이션 추가, 결과 다운로드를 할 수 있습니다.
다음 단계
- 2slides.com/api에서 API 키 생성; 500 무료 크레딧으로 약 50페이지 편집 가능, 모든 레시피 테스트 가능.
- 트리거에 가장 가까운 레시피부터 시작: Sheets 기반 영업 제안서, Closed Won 온보딩 데크, 커리큘럼 기반 수업 슬라이드.
- Gamma API와의 개발자 수준 비교 및 전체 엔드포인트 참조는 Gamma Generate API vs 2Slides API 및 Best AI presentation API for developers 참고.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
