2Slides Team
13 min read
AI Slides API로 소셜 미디어 캐러셀 자동화하기 (2026)
소셜 미디어 캐러셀을 자동화하려면, 주제를 Google Sheets, Notion 데이터베이스 또는 Airtable 베이스에 보관하고, Claude 또는 OpenAI가 각 새 행을 7슬라이드 개요와 캡션으로 변환하게 하세요. 그런 다음 n8n 또는 Make가 2Slides API 엔드포인트 create-pdf-slides를 aspectRatio: "4:5" 또는 "9:16"으로 호출합니다. jobs/{id}를 폴링한 후 PDF와 페이지별 PNG를 다운로드합니다. 7페이지 2K 캐러셀은 710 크레딧(약 $1.42~$1.78)이며, 이 레시피는 디자이너 없이도 주당 여러 캐러셀을 게시하는 콘텐츠 팀에 적합합니다.
핵심 요약
- 한 번의
create-pdf-slides호출로 7페이지 캐러셀 PDF와 페이지별 2K PNG를 710 크레딧(기획 10 크레딧 + 페이지당 100 크레딧)으로 생성. aspectRatio는 임의의w:h문자열을 받으며, LinkedIn 및 Instagram 피드용 4:5, Stories, Reels, TikTok용 9:16, 정사각형 게시물용 1:1 사용 가능.create-like-this는 브랜드 슬라이드 하나의referenceImageUrl을 받아 전체 디자인 시스템을 유도해 시리즈 내 모든 캐러셀의 일관성 유지.- 음성 내레이션은 페이지당 210 크레딧 추가, Workspace 내보내기 → Generate Video는 페이지당 20 크레딧으로 1080×1920 H.264 MP4 생성.
- API 키당 분당 6회 요청 제한, 6개 이상의 주제 배치는 대기 노드와 큐 필요.
대상 사용자
이 레시피는 이미 n8n, Make, Zapier를 운영 중이며, 스프레드시트에 30~300개의 캐러셀 아이디어가 쌓여 있고, 매달 디자이너 작업 시간을 많이 소모하는 콘텐츠 마케터 및 마케팅 운영 엔지니어를 위한 것입니다. 또한 여러 클라이언트 브랜드용 캐러셀을 제작하며 각 브랜드별 고유 스타일을 유지해야 하는 에이전시에도 적합합니다.
제품 스크린샷이나 Figma에서 디자이너가 편집하는 차트가 매 캐러셀마다 필요하다면 사용하지 마세요. 이 경우 자동화는 초안 작성에만 도움을 주며, Fast PPT에서 편집 가능한 PPTX를 시작점으로 사용하는 것이 더 낫습니다.
전체 워크플로우 개요
| 단계 | 도구 | 수행 작업 | 2Slides 엔드포인트 / 크레딧 |
|---|---|---|---|
| 1 | Google Sheets, Notion, Airtable | topic, channel (LinkedIn, Instagram, Stories), status = queued가 포함된 새 행 생성 | 없음 |
| 2 | Claude 또는 OpenAI 노드 | 7슬라이드 개요(후킹, 본문 5장, CTA)와 캡션, 해시태그를 JSON으로 작성 | 없음 |
| 3 | HTTP Request 노드 | 개요와 aspectRatio "4:5" 또는 "9:16", page: 7, resolution: "2K", mode: "async" 전송 | POST /api/v1/slides/create-pdf-slides, 7페이지당 710 크레딧 |
| 4 | 대기 노드 + HTTP Request 노드 | 8초마다 status가 success 또는 failed가 될 때까지 폴링 | GET /api/v1/jobs/{id}, 무료, 분당 10회 제한 |
| 5 | HTTP Request 노드 | downloadUrl에서 PDF 및 페이지별 PNG ZIP 다운로드 | POST /api/v1/slides/download-slides-pages-voices, 무료 |
| 6 | 선택 사항 | 내레이터 음성 추가 후 Workspace에서 9:16 MP4 렌더링 | generate-narration, 페이지당 210 크레딧; 비디오 내보내기 페이지당 20 크레딧 |
| 7 | Google Drive, Slack | 자산 업로드, 검토용 게시, 링크 및 status = ready 행에 기록 | 없음 |
1단계: 소셜 미디어 캐러셀 자동화 파이프라인 선택
2Slides API는 두 가지 슬라이드 생성 방식을 제공합니다. generate(Fast PPT)는 디자인된 템플릿을 채워 약 30초 내에 편집 가능한 PPTX를 반환합니다. create-pdf-slides(Nano Banana 이미지 디자인 파이프라인)는 프롬프트에서 각 페이지를 직접 그려 PDF와 페이지별 이미지를 반환합니다.
캐러셀에는 세 가지 이유로 두 번째 파이프라인이 필요합니다. Fast PPT는 사용자 지정 aspectRatio를 지원하지 않으며, LinkedIn과 Instagram이 사용하는 페이지별 PNG를 반환하지 않고, 내레이션과 MP4 변환이 불가능하기 때문입니다.
연결하기 전에 Nano Banana 제품 페이지에서 두세 번 직접 프롬프트를 실행해 보세요. API가 사용하는 프롬프트 박스와 페이지 수 조절기가 노출되어 있어, 사람이 개입해 designStyle 문구를 확정한 후 자동화할 수 있습니다.
공정한 비교를 위해: Gamma 개발자 문서는 유사한 Make + Claude 캐러셀 레시피를 제공하지만, API 키는 Pro 플랜이 필요합니다. 반면 2Slides API 키는 신규 계정 포함 모든 계정에서 작동하며 500 무료 크레딧이 제공됩니다. 2Slides는 저희 제품이므로, 두 제품을 직접 브랜드와 예산에 맞춰 테스트해 보세요.
2단계: 각 주제 행을 개요와 캡션으로 변환
LLM 단계에서 주제 목록이 캐러셀로 변환됩니다. Claude 또는 OpenAI에 구조화된 JSON을 요청하세요. 산문이 아니라 JSON이어야 다음 노드가 정규식 없이 읽을 수 있습니다:
You write LinkedIn and Instagram carousels for {{brand}}.
Topic: {{topic}}
Audience: {{audience}}
Return JSON only:
{
"slides": [
{ "n": 1, "title": "<hook, max 8 words>", "body": "<one line>" },
... exactly 7 slides; slide 7 is the call to action ...
],
"caption": "<120 to 200 words, no hashtags>",
"hashtags": ["<5 to 8 tags>"]
}
Rules: one idea per slide, no bullet lists inside a slide, plain language.그런 다음 슬라이드를 2Slides가 기대하는 userInput 문자열로 평탄화합니다. 각 슬라이드는 제목과 한 줄 설명으로 유지하세요; 4:5 비율의 7장 슬라이드는 금방 빽빽해집니다. 같은 이유로 contentDetail: "concise"를 설정하세요.
// n8n Code 노드(또는 Node 20 스크립트): LLM JSON에서 2Slides 페이로드 생성
const plan = JSON.parse($json.llmOutput);
const userInput = plan.slides
.map((s) => `Slide ${s.n}: ${s.title}\n${s.body}`)
.join("\n\n");
const aspectRatio = $json.channel === "Stories" ? "9:16" : "4:5";
return [{ json: { userInput, aspectRatio, caption: plan.caption, hashtags: plan.hashtags } }];caption과 hashtags는 행에 다시 저장하세요. 게시 일정을 잡는 사람이 PNG 옆에 필요합니다.
3단계: 2Slides API 호출 설정
2slides.com/api에서 API 키를 생성하세요. 신규 계정은 500 무료 크레딧이 제공됩니다. 자동화 도구의 자격 증명 저장소에 키를 넣고 Authorization: Bearer $SLIDES_API_KEY 헤더로 전송하세요. 브라우저 측 스크립트나 공개 Sheet 셀에 절대 넣지 마세요.
responseLanguage에 언어 코드를 아닌 "Spanish" 같은 언어 이름을 전달하세요.
LinkedIn 피드 캐러셀 제출 호출 예시는 다음과 같습니다. designStyle은 자유 텍스트이며, 배경, 강조 색상, 타이포그래피, 피해야 할 점을 구체적으로 명시하세요.
curl -X POST https://2slides.com/api/v1/slides/create-pdf-slides \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userInput": "Slide 1: 5 onboarding emails every SaaS should send\nMost trials churn before day 3. These five fix that.\n\nSlide 2: Day 0, the welcome\nOne job: get them to the first aha moment.\n\nSlide 3: Day 1, the quick win\nShow one feature, one outcome, one button.\n\nSlide 4: Day 3, the social proof\nA customer quote and a number.\n\nSlide 5: Day 5, the blocker check\nAsk what stopped them. Reply personally.\n\nSlide 6: Day 7, the decision\nRestate value, then the price.\n\nSlide 7: Save this carousel\nFollow for the full sequence templates.",
"designStyle": "Bold editorial carousel for LinkedIn. Off-white background, one deep navy accent, oversized serif headline on each slide, small sans-serif body line, thin page counter top-right, brand mark bottom-left. No stock photos, no gradients.",
"aspectRatio": "4:5",
"resolution": "2K",
"page": 7,
"contentDetail": "concise",
"imageModel": "gemini-3-pro-image",
"responseLanguage": "English",
"mode": "async"
}'응답은 { "jobId": "..." }입니다. Stories 또는 TikTok 버전은 aspectRatio를 "9:16"으로 바꾸고, 플랫폼 UI가 제목을 가리지 않도록 designStyle에서 제목을 위쪽에 배치하세요. 기본 해상도 resolution: "2K"는 512px, 1K와 동일하게 페이지당 100 크레딧이며, 4K는 페이지당 200 크레딧으로 두 배입니다.
4단계: n8n에서 Instagram 캐러셀 자동화 연결
n8n에서는 전체 흐름이 8개 노드로 구성됩니다. Make의 HTTP 및 Sleep 모듈(자세한 내용은 Make 도움말 센터)에서도 동일한 구조가 작동하며, n8n 문서에서 HTTP Request 자격 증명 설정법을 참고하세요.
- 트리거: Google Sheets, Notion, Airtable 새 행 트리거 또는
status = queued인 행을 읽는 스케줄 트리거 - Claude 또는 OpenAI 노드: 2단계 프롬프트, JSON 출력
- 코드 노드:
userInput생성,channel열에서aspectRatio선택 - HTTP Request 노드:
POST /api/v1/slides/create-pdf-slides에mode: "async"로 호출,jobId행에 저장 - 대기 노드: 8초 대기
- HTTP Request 노드:
GET /api/v1/jobs/{jobId}호출; IF 노드가status가pending또는processing일 때 대기 노드로 루프 - HTTP Request 노드:
downloadUrl에서 PDF 다운로드, 이어서POST /api/v1/slides/download-slides-pages-voices로 PNG ZIP 다운로드 - 전달: Google Drive에 업로드, Slack에 캡션 게시,
status = ready설정
코드로 루프를 직접 제어하고 싶다면, 다음은 의존성 없는 Node 20 스크립트 예시입니다.
// Node 20+. 서버 측 실행; 키는 환경 밖으로 절대 노출되지 않음.
import { writeFile } from "node:fs/promises";
const BASE = "https://2slides.com";
const headers = {
Authorization: `Bearer ${process.env.SLIDES_API_KEY}`,
"Content-Type": "application/json",
};
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
async function submitCarousel(row) {
const res = await fetch(`${BASE}/api/v1/slides/create-pdf-slides`, {
method: "POST",
headers,
body: JSON.stringify({
userInput: row.userInput,
designStyle: row.designStyle,
aspectRatio: row.aspectRatio, // "4:5" 또는 "9:16"
resolution: "2K",
page: 7,
contentDetail: "concise",
responseLanguage: "English",
mode: "async",
}),
});
if (!res.ok) throw new Error(`submit failed: ${res.status} ${await res.text()}`);
const { jobId } = await res.json();
return jobId;
}
async function waitForJob(jobId) {
for (;;) {
const res = await fetch(`${BASE}/api/v1/jobs/${jobId}`, { headers });
const job = await res.json();
if (job.status === "success") return job;
if (job.status === "failed") throw new Error(`job ${jobId} failed`);
await sleep(8000); // 5~10초 간격으로 jobs/{id} 요청 제한(분당 10회) 준수
}
}
async function downloadAssets(jobId, job, slug) {
const pdf = await fetch(job.downloadUrl);
await writeFile(`${slug}.pdf`, Buffer.from(await pdf.arrayBuffer()));
const zip = await fetch(`${BASE}/api/v1/slides/download-slides-pages-voices`, {
method: "POST",
headers,
body: JSON.stringify({ jobId }),
});
await writeFile(`${slug}-pages.zip`, Buffer.from(await zip.arrayBuffer()));
}
// 행은 LLM 단계 후 Sheet/Notion/Airtable에서 가져옴
for (const row of rows) {
const jobId = await submitCarousel(row);
const job = await waitForJob(jobId);
await downloadAssets(jobId, job, row.slug);
await sleep(10_000); // 키당 분당 6회 제출 제한 준수
}페이지 ZIP을 풀면 요청한 4:5 또는 9:16 비율의 7개 PNG가 생성됩니다. 이 파일들을 순서대로 LinkedIn 문서 게시물이나 Instagram 다중 이미지 게시물에 업로드하세요.
5단계: Reels, Stories, TikTok용 내레이션 9:16 비디오(선택 사항)
캐러셀을 생성한 동일 작업에 내레이션을 추가할 수 있습니다. generate-narration은 create-pdf-slides 또는 create-like-this의 jobId를 받아 각 페이지별 스크립트와 음성 트랙을 생성합니다. 30개 음성(Zephyr, Puck, Charon, Kore, Aoede, Leda 등) 중 선택하고 contentMode: "concise"로 설정해 각 페이지가 몇 초간 재생되도록 하세요.
curl -X POST https://2slides.com/api/v1/slides/generate-narration \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jobId": "JOB_ID_FROM_STEP_3",
"mode": "single",
"speakerName": "Host",
"voice": "Kore",
"contentMode": "concise",
"includeIntro": false
}'내레이션도 비동기 처리이므로 jobs/{id}를 동일하게 폴링하세요. 완료되면 download-slides-pages-voices는 페이지별 PNG와 WAV가 포함된 ZIP을 반환하며, FFmpeg로 세로 비디오로 합칠 수 있습니다. FFmpeg를 사용하지 않으려면 2Slides Workspace에서 작업을 열고 Export → Generate Video를 사용해 브라우저에서 1080×1920 MP4를 페이지당 20 크레딧으로 렌더링할 수 있습니다.
세로 비디오의 페이싱, 후킹, 캡션 타이밍에 관해서는 얼굴 없는 교육용 숏츠 플레이북과 내레이션 및 비디오 모범 사례를 참고하세요.
참조 스타일 선택: 브랜드에 맞는 LinkedIn 캐러셀 생성기 API
designStyle 텍스트는 브랜드 룩에 근접하지만 모호할 수 있습니다. 팀 내에서 모두가 올바르다고 동의하는 슬라이드가 하나 있다면 제출을 create-like-this로 바꾸고 referenceImageUrl로 전달하세요. 2Slides는 참조 이미지에서 전체 디자인 시스템(팔레트, 타입 스케일, 레이아웃 그리드)을 유도해 캐러셀 40도 캐러셀 1과 일치시킵니다. 비용과 제한은 create-pdf-slides와 동일합니다.
curl -X POST https://2slides.com/api/v1/slides/create-like-this \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userInput": "Slide 1: 5 onboarding emails every SaaS should send ... Slide 7: Save this carousel",
"referenceImageUrl": "https://assets.yourbrand.com/carousel-style-reference.png",
"aspectRatio": "4:5",
"resolution": "2K",
"page": 7,
"contentDetail": "concise",
"mode": "async"
}'참조 이미지는 공개 URL이어야 합니다: CDN, 공개 읽기 권한이 있는 S3 또는 R2 버킷, 로그인 없이 접근 가능한 공유 링크 등. 주제 시트의 열에 브랜드별 참조를 하나씩 보관해 코드 노드가 행별로 선택할 수 있게 하세요.
브랜드 슬라이드가 없다면 2Slides 갤러리에서 실제 데크를 디자인 영감이나 referenceImageUrl로 직접 사용할 수 있습니다. 아래 이미지는 갤러리 데크 두 개에서 가져온 것으로, 이 워크플로우의 API 출력물이 아니라 API가 참조할 수 있는 스타일 예시입니다.
명확한 제목, 단순한 배경, 눈에 띄는 브랜드 마크가 있는 참조를 선택하세요. 사진과 여러 차트가 많은 복잡한 참조는 휴대폰 크기에서 읽기 어렵습니다.
비용
7페이지 2K 캐러셀은 기획 10 크레딧 + 7 × 100 크레딧 = 710 크레딧입니다. 크레딧 가격은 $5 팩(2,000 크레딧)에서 개당 $0.0025, $80 팩(40,000 크레딧)에서 개당 $0.002입니다. PNG 다운로드와 폴링은 무료입니다.
| 사용량 | 월별 크레딧 | 적합한 팩 | 월별 USD | 캐러셀당 USD |
|---|---|---|---|---|
| 20개 캐러셀, 7페이지, 2K, 내레이션 없음 | 14,200 | 20,000 크레딧에 $42.50 | 약 $30.18 | 약 $1.51 |
| 500개 캐러셀, 7페이지, 2K, 내레이션 없음 | 355,000 | 40,000 크레딧 $80 팩 9개 | 약 $710 ($0.002/크레딧) | 약 $1.42 |
| 7페이지 캐러셀 하나에 내레이션 추가 | +1,470 | 약 $2.94~$3.68 | ||
| 7페이지 캐러셀 하나에 Workspace 비디오 내보내기 추가 | +140 | 약 $0.28~$0.35 |
선택적 Pro 구독은 월 10,000 크레딧($12.50 프로모션가, 정가 $25) 포함으로 월 14개 캐러셀을 커버합니다. 500 무료 가입 크레딧은 7페이지 전체 데크를 커버하지 않으므로, 먼저 3페이지 실행(310 크레딧)으로 테스트하세요. 여러 브랜드용 규모 산정을 위해 마케팅 팀용 배치 플레이북을 참고하세요.
이 사용 사례에 Fast PPT 또는 이미지 디자인 슬라이드 중 무엇을 사용할까?
| 필요 | 사용 | 이유 |
|---|---|---|
| 4:5 또는 9:16 출력, 페이지별 PNG, 내레이션, MP4 | create-pdf-slides 또는 create-like-this | 이미지 디자인 파이프라인은 aspectRatio를 지원하고 내레이션 가능; Fast PPT는 불가 |
| 웹세미나 또는 영업 데크용 편집 가능한 PPTX | generate (Fast PPT) | 페이지당 10 크레딧, 1,500+ 템플릿에서 네이티브 PPTX 생성(themes/search) |
| 수백 개 캐러셀에 걸쳐 고정된 브랜드 룩 유지 | create-like-this + referenceImageUrl | 텍스트 해석 대신 이미지 하나에서 디자인 시스템 유도 |
| 디자인 검토 전 빠른 내부 초안 | create-pdf-slides + resolution: "512px" | 2K와 동일하게 페이지당 100 크레딧, 승인 후 2K로 재생성 가능 |
흔한 실수
- 30개 행을 한꺼번에 제출해 429 오류 발생. 생성 엔드포인트는 키당 분당 6회,
jobs/{id}는 분당 10회 제한. 제출 사이에 대기 노드 추가, 폴링은 5초 이상 간격 유지. - API 키를 Sheet나 클라이언트 스크립트에 저장. 키는 크레딧을 소모하므로 n8n, Make 자격 증명 또는 서버 환경 변수에 보관하고, 브라우저 노출 시 즉시 교체.
- Fast PPT 작업에 내레이션 시도.
generate-narration은generate작업을 거부. 내레이션과 MP4는create-pdf-slides와create-like-this작업만 지원. page: 0전달 후 7슬라이드 기대.page: 0은 내용 기반 자동 감지로 4~12페이지 반환 가능. 비용과 레이아웃 예측을 위해page: 7명시.- 언어 코드 전달.
responseLanguage는"es"나"zh-CN"이 아닌"Spanish"또는"Simplified Chinese"같은 언어 이름을 받음. - 2,000단어 기사 전체를
userInput으로 전달. 이미지 모델이 맞추려 시도함. LLM 단계에서 7개 제목과 한 줄 설명으로 줄인 후 제출.
자주 묻는 질문
디자이너 없이 소셜 미디어 캐러셀을 자동화할 수 있나요?
네, 초안 작성과 대부분 반복 포맷에 가능합니다. LLM이 7슬라이드 개요를 작성하고, create-pdf-slides가 designStyle 또는 referenceImageUrl 기반 슬라이드를 그리며, n8n이 PNG를 검토 채널로 전달합니다. 게시 전에는 사람이 최종 승인하지만, 디자인과 레이아웃 작업은 이미 완료된 상태입니다.
LinkedIn과 Instagram 캐러셀에 어떤 종횡비를 사용해야 하나요?
LinkedIn 피드와 Instagram 피드 캐러셀에는 aspectRatio: "4:5"를 사용하세요. Instagram Stories, Reels 커버, TikTok 슬라이드쇼에는 "9:16"을 사용합니다. 모든 플랫폼에 정사각형 세트를 원하면 "1:1"도 가능합니다. 이 매개변수는 임의의 w:h 문자열을 받아 워크플로우 변경 없이 비율 추가가 가능합니다.
AI 캐러셀 메이커 API 호출 비용은 얼마인가요?
7페이지 2K 캐러셀은 710 크레딧(기획 10 크레딧 + 페이지당 100 크레딧)이며, $5 팩 기준 약 $1.78, $80 팩 기준 약 $1.42입니다. 폴링과 PNG 다운로드는 무료입니다. 내레이션은 페이지당 210 크레딧, Workspace 비디오 렌더링은 페이지당 20 크레딧 추가입니다.
워크플로우에서 내레이션 비디오 버전을 만들 수 있나요?
네. 캐러셀의 jobId로 generate-narration을 호출하고 30개 음성 중 선택한 후 완료될 때까지 폴링하세요. 완료되면 download-slides-pages-voices에서 PNG와 WAV ZIP을 다운로드해 FFmpeg로 세로 비디오를 만들거나, 2Slides Workspace에서 Export → Generate Video를 사용해 1080×1920 MP4를 생성할 수 있습니다. 내레이션은 create-pdf-slides와 create-like-this 작업만 지원합니다.
Instagram 캐러셀 자동화가 n8n 대신 Make 또는 Zapier에서도 작동하나요?
네. 모든 단계가 Bearer 토큰을 사용하는 HTTPS 호출이므로 Make의 HTTP 모듈과 Zapier의 Webhooks 액션으로 제출, 폴링, 다운로드가 가능합니다. 단, jobs/{id} 체크 사이에 5~10초 대기 루프가 필요합니다. n8n과 Make는 이를 기본 지원하며, Zapier에서는 Delay 단계와 별도 Zap으로 폴링을 구현하는 것이 좋습니다.
다음 단계
- 2slides.com/api에서 API 키 생성. 신규 계정은 500 무료 크레딧 제공, 3페이지 캐러셀 테스트 가능하며 구독 없이 사용 가능.
- 팀별 AI 프레젠테이션 API 활용 사례 허브 포스트를 읽어 동일한 제출, 폴링, 다운로드 루프가 영업, HR, 교육 데크에 어떻게 활용되는지 확인.
- 다른 데크와 함께 소셜 미디어 캐러셀을 자동화하려면 무료 n8n + 2Slides 워크플로우 튜토리얼과 마케팅 팀용 배치 플레이북에서 시작하고, Reels용 내레이션은 내레이션 및 비디오 모범 사례를 참고해 추가하세요.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
