2Slides Team
9 min read
自动化营销报告演示：Deck 转视频 API（2026）
要自动化营销报告演示，请运行一个周一定时任务，拉取广告活动指标，调用大语言模型（LLM）生成 8 张幻灯片的叙述内容，然后调用三个 2Slides 端点：create-pdf-slides 生成图像设计的 16:9 汇总幻灯片，generate-narration 以 multi 模式生成双声道配音轨道，download-slides-pages-voices 下载每页的 PNG 和 WAV 文件，最后用 ffmpeg 拼接成 MP4。一个 8 页 2K 幻灯片包费用为 810 积分（约 2 美元），配音额外 1,680 积分（约 4.20 美元），因此带配音的每周汇报每客户成本约 6 美元。适合营销运营、增长工程师和代理机构。
关键要点
- 一个定时任务替代周一例行流程：指标导出、8 幻灯片汇总、双讲者配音和 1920×1080 MP4 视频。
- 三个 2Slides 端点完成工作：
create-pdf-slides（2K 分辨率每页 10 + 100 积分），generate-narration（每页 210 积分），download-slides-pages-voices（免费）。 - 一个带配音的 8 幻灯片汇报成本 2,490 积分，约 5 至 6.25 美元；仅幻灯片包为 810 积分。
- 每个写入端点限制每密钥每分钟 6 次请求，50 客户的批量运行应排队处理，避免并行触发。
- Fast PPT (
generate) 不支持配音；视频制作需从create-pdf-slides或create-like-this开始。
适用对象
适合每周一重建同一汇报幻灯片的营销运营负责人、已有仓库数据的增长工程师，以及需每周向 20、50 或更多客户汇报的代理机构。痛点一致：数据早上 6 点准备好，幻灯片中午完成，但半数利益相关者从未打开。
如果利益相关者需要后续在 PowerPoint 中编辑幻灯片，请勿使用此方案；图像设计流程输出的是完成的 PDF 和页面图片，不是原生 PPTX。若需可编辑的周报幻灯片，推荐使用 使用 Zapier 和 2Slides 自动化周报 中的 Fast PPT 路径。
工作流程概览
| 步骤 | 工具 | 发生内容 | 2Slides 端点 / 积分 |
|---|---|---|---|
| 1. 触发 | 定时任务（GitHub Actions、Cloud Scheduler、虚拟机上的 cron） | 在客户时区周一 06:00 触发 | 无 |
| 2. 拉取指标 | Google Ads、Meta、GA4 导出或仓库 SQL 查询 | 每客户一个 JSON 对象：花费、计划、转化、CPA、主要渠道、主要创意 | 无 |
| 3. 撰写叙述 | 你选择的 LLM | 返回 8 个带标题的部分：核心结果、花费 vs 计划、主要渠道、创意赢家、受众备注、测试、风险、下周计划 | 无 |
| 4. 生成幻灯片包 | 2Slides | 2K 分辨率、16:9 比例、品牌风格的图像设计幻灯片包 | POST /api/v1/slides/create-pdf-slides，8 页 810 积分 |
| 5. 添加配音 | 2Slides | 两个讲者交替配音整套幻灯片 | POST /api/v1/slides/generate-narration，8 页 1,680 积分 |
| 6. 获取素材 | 2Slides | ZIP 包含 pages/page_01.png、voices/page_01.wav 和 transcript.txt | POST /api/v1/slides/download-slides-pages-voices，免费 |
| 7. 拼接与交付 | 你的工作节点上的 ffmpeg，或 Workspace 导出 | H.264 MP4 上传至 Slack、邮件或客户门户 | ffmpeg 免费；Workspace 生成视频每页 20 积分 |
每个 2Slides 调用均使用相同的 Authorization: Bearer $SLIDES_API_KEY 头，异步任务通过 GET /api/v1/jobs/{jobId} 轮询状态。
步骤 1：获取 API 密钥并配置调度器
在 2slides.com/api 的 API Keys 标签页创建密钥。新账户免费赠送 500 积分，无需订阅，足够完整跑通一次流程再购买积分包。将密钥存储于调度器的密钥库，切勿放在浏览器或共享笔记本中，调度前用 echo 端点确认密钥有效。
curl -s https://2slides.com/api/v1/echo \
-H "Authorization: Bearer $SLIDES_API_KEY"
触发器方面，GitHub Actions 工作流配置 on: schedule: - cron: "0 6 * * 1" 适合少量客户。50 个及以上客户建议排队处理，单个工作线程顺序执行，避免超过每分钟 6 次请求限制并留有重试空间。
步骤 2：拉取指标并让 LLM 撰写 8 幻灯片叙述
2Slides API 不知道什么是好的周报叙述，这部分由你负责，决定幻灯片质量。将上周数据从广告平台或仓库拉取成每客户一个扁平 JSON 对象，再提示 LLM 返回恰好八个带标题的部分：
- 核心结果：一句话一个数字（如“CPA 环比下降 18%，花费持平”）。
- 花费 vs 计划：实际、计划、差异、月度节奏。
- 主要渠道：三大渠道的花费、转化、CPA 及变化。
- 创意赢家：两三个转化最佳广告及原因。
- 受众与地域备注：变化情况。
- 正在运行的测试：假设、状态、读取日期。
- 风险与阻碍：预算限制、跟踪缺口、季节性。
- 下周计划：三条要点及负责人。
要求用简洁句子，数字内嵌，单部分不超过 60 字。create-pdf-slides 以文本为排版和文案依据，400-500 字的精炼叙述比 3,000 字的指标堆砌效果更佳。
// narrative.mjs：在传给 2Slides 前整理 LLM 输出
export function toUserInput(client, sections) {
const header = `Weekly paid media recap for ${client.name}, week of ${client.week}. ` +
`Audience: ${client.stakeholders}. Tone: direct, numbers first.`;
const body = sections
.map((s, i) => `Slide ${i + 1}: ${s.title}\n${s.body}`)
.join("\n\n");
return `${header}\n\n${body}`;
}步骤 3：用 create-pdf-slides 自动生成广告报告幻灯片包
将叙述发送给 create-pdf-slides。设置 page: 8 保证幻灯片页数与叙述部分数一致，aspectRatio: "16:9" 适合屏幕显示，resolution: "2K" 保证 PNG 在 1920×1080 下清晰无放大。designStyle 定义品牌风格：颜色、字体感觉、布局规则及禁忌。
curl -s https://2slides.com/api/v1/slides/create-pdf-slides \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userInput": "Weekly paid media recap for Northwind Outdoor, week of 2026-09-01 to 2026-09-07. Audience: CMO and ecommerce lead. Tone: direct, numbers first.\n\nSlide 1: Headline result\nCPA fell 18% to $31.40 at flat spend of $48,200; 1,535 purchases vs. 1,301 the prior week.\n\nSlide 2: Spend vs. plan\nPlanned $50,000, spent $48,200 (-3.6%). Month pacing at 97% of plan.\n\nSlide 3: Top channels\nMeta $22,100 spend, 812 purchases, $27.20 CPA (-22%). Google Search $18,400, 571 purchases, $32.20 CPA (-9%). YouTube $7,700, 152 purchases, $50.66 CPA (+4%).\n\nSlide 4: Creative winners\n\"Trail-ready in 3 layers\" UGC video: 334 purchases, 3.1% CTR. \"Fall sale, free returns\" static: 218 purchases.\n\nSlide 5: Audience and geo notes\nPacific Northwest DMAs up 31% on purchases; 25-34 women now 41% of Meta conversions.\n\nSlide 6: Tests running\nBroad vs. interest targeting on Meta, day 9 of 14, read on Sept 12. Search brand exclusion test paused for tracking fix.\n\nSlide 7: Risks and blockers\nGA4 and Meta purchase counts diverge by 11%; YouTube CPA trending up two weeks straight.\n\nSlide 8: Next week plan\nShift $3,000 from YouTube to Meta UGC (owner: Priya). Launch two new UGC variants (owner: Sam). Close the GA4 tagging gap by Wednesday (owner: Dev).",
"designStyle": "Northwind Outdoor brand: deep forest green #1F3D2B, sand #E8DCC4, white; bold geometric sans-serif headlines; one large number per slide; clean data cards and simple bar comparisons; generous margins; no stock photography, no gradients",
"aspectRatio": "16:9",
"resolution": "2K",
"page": 8,
"contentDetail": "concise",
"imageModel": "gemini-3-pro-image",
"responseLanguage": "English",
"mode": "async"
}'响应为 { "jobId": "..." }。每 5 到 10 秒轮询 GET https://2slides.com/api/v1/jobs/{jobId}，直到 status 为 success（PDF 位于 downloadUrl）或 failed。8 页 2K 幻灯片包预计耗时数分钟。费用：10 积分规划费加每页 100 积分，共 810 积分。
create-pdf-slides API 所暴露的功能。
若想匹配已有品牌幻灯片而非文本描述，可改用 create-like-this，传入公开的品牌幻灯片图片 URL 作为 referenceImageUrl。其余参数、费用和限制相同。
步骤 4：双讲者配音视频演示 API
幻灯片任务 success 后，调用同一 jobId 的 generate-narration。使用 mode: "multi"，指定两个讲者名字和两种声音；Kore 和 Puck 声音差异明显，听众无需视觉辅助即可区分。includeIntro: true 添加简短开场介绍客户和周次。
curl -s https://2slides.com/api/v1/slides/generate-narration \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jobId": "<deck jobId from step 3>",
"mode": "multi",
"speaker1Name": "Maya",
"speaker2Name": "Theo",
"speaker1Voice": "Kore",
"speaker2Voice": "Puck",
"contentMode": "standard",
"includeIntro": true
}'端点返回 202，任务状态变为 processing。继续轮询同一 jobId，直至返回 success。配音费用为每页 210 积分（10 积分脚本，200 积分音频），8 页共 1,680 积分。脚本长度与节奏建议见 Slides narration and video best practices。
有人问对比：Gamma 开发者站点（https://developers.gamma.app）文档了一个串联 n8n、Synthesia、ElevenLabs 和其 Generate API 的配音视频方案，且其 API 密钥需 Pro 计划。上述 2Slides 方案只用一个供应商和密钥，自己用 ffmpeg 拼接；不生成 Synthesia 那样的虚拟主持人。声明：2Slides 是我们的产品。
步骤 5：用 ffmpeg 将周报转视频
调用 download-slides-pages-voices，传入同一 jobId。返回免费 ZIP，包含 pages/page_01.png 至 page_08.png，voices/page_01.wav 至 page_08.wav，以及带字幕或邮件摘要用的 transcript.txt。
curl -s https://2slides.com/api/v1/slides/download-slides-pages-voices \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "jobId": "<deck jobId>" }' \
-o recap.zip && unzip -q -o recap.zip -d recap然后将每张 PNG 与对应 WAV 拼接并合并。以下一行命令生成 1920×1080 H.264 MP4，幻灯片显示时长与配音完全同步：
cd recap && for i in $(seq -w 1 8); do ffmpeg -y -loop 1 -i pages/page_$i.png -i voices/page_$i.wav -c:v libx264 -tune stillimage -pix_fmt yuv420p -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:a aac -b:a 192k -shortest clip_$i.mp4; done && printf "file 'clip_%s.mp4'\n" $(seq -w 1 8) > list.txt && ffmpeg -y -f concat -safe 0 -i list.txt -c copy weekly-recap.mp4concat 解复用器详见 ffmpeg 格式参考。若需竖屏，将两个 1920:1080 改为 1080:1920，并用 aspectRatio: "9:16" 重新生成幻灯片包。
无 ffmpeg 工作节点？可在 2Slides Workspace 打开同一任务，使用导出功能生成视频，浏览器端渲染 1920×1080 或 1080×1920 H.264 MP4，每页 20 积分（8 页共 160 积分）。适合偶尔使用；ffmpeg 适合每周批量 50 客户。
步骤 6：Node.js 脚本自动化营销报告演示
以下是一个 Node 20 脚本示例，仅依赖 fetch。替换 loadMetrics 和 writeNarrative 为你的仓库查询和 LLM 调用。
// weekly-recap.mjs: Node 20+，从周一定时任务运行
import { writeFile } from "node:fs/promises";
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import { toUserInput } from "./narrative.mjs";
import { loadMetrics, writeNarrative } from "./your-data-layer.mjs";
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));
const run = promisify(execFile);
async function post(path, body) {
const res = await fetch(`${BASE}${path}`, { method: "POST", headers, body: JSON.stringify(body) });
if (!res.ok) throw new Error(`${path} -> ${res.status}: ${await res.text()}`);
return res.json();
}
async function waitForJob(jobId, everyMs = 8000) {
for (;;) {
const res = await fetch(`${BASE}/api/v1/jobs/${jobId}`, { headers });
const job = await res.json();
console.log(` job ${jobId}: ${job.status} ${job.progress ?? ""}`);
if (job.status === "success") return job;
if (job.status === "failed") throw new Error(`job ${jobId} failed: ${job.message ?? ""}`);
await sleep(everyMs); // 每 5–10 秒轮询；jobs/{id} 限制 10 次请求/分钟
}
}
export async function buildRecap(client) {
// 1) 指标 -> 8 部分叙述
const metrics = await loadMetrics(client);
const sections = await writeNarrative(client, metrics);
// 2) 图像设计幻灯片包：2K 分辨率每页 10 + 100 积分
const { jobId } = await post("/api/v1/slides/create-pdf-slides", {
userInput: toUserInput(client, sections),
designStyle: client.designStyle,
aspectRatio: "16:9",
resolution: "2K",
page: 8,
contentDetail: "concise",
responseLanguage: client.language ?? "English",
mode: "async",
});
const deck = await waitForJob(jobId);
console.log("deck PDF:", deck.downloadUrl);
// 3) 双讲者配音：每页 210 积分
await post("/api/v1/slides/generate-narration", {
jobId,
mode: "multi",
speaker1Name: "Maya",
speaker2Name: "Theo",
speaker1Voice: "Kore",
speaker2Voice: "Puck",
contentMode: "standard",
includeIntro: true,
});
await waitForJob(jobId);
// 4) 每页 PNG + WAV（免费）-> 用 ffmpeg 生成 MP4
const zipRes = await fetch(`${BASE}/api/v1/slides/download-slides-pages-voices`, {
method: "POST", headers, body: JSON.stringify({ jobId }),
});
if (!zipRes.ok) throw new Error(`download failed: ${zipRes.status}`);
const zipPath = `out/${client.slug}.zip`;
await writeFile(zipPath, Buffer.from(await zipRes.arrayBuffer()));
await run("bash", ["./stitch.sh", zipPath, `out/${client.slug}-recap.mp4`]); // 步骤 5 中的 ffmpeg 循环命令
return { jobId, pdf: deck.downloadUrl, video: `out/${client.slug}-recap.mp4` };
}
// 顺序处理客户：每客户 3 次 POST 请求，保持每分钟 6 次请求限制内
const clients = JSON.parse(process.env.CLIENTS_JSON ?? "[]");
for (const client of clients) {
try {
const out = await buildRecap(client);
console.log(`done ${client.name}`, out);
} catch (err) {
console.error(`FAILED ${client.name}:`, err.message); // 报警，不盲目重试
}
}每个客户需三次写请求（幻灯片包、配音、下载）及轮询读取请求，读取限额为每分钟 10 次。
选择参考风格
如果用 designStyle 描述品牌效果不理想，可用参考图片。2Slides Gallery 提供真实幻灯片包浏览，可用作方向参考或传给 create-like-this 的 referenceImageUrl。以下幻灯片来自 Gallery 中 Adobe Creative Trends 2026 幻灯片包，风格克制、数据导向，适合周报阅读。
referenceImageUrl 传入，create-like-this 会从中提取颜色、字体和布局。
代理机构可为每客户存储一个参考幻灯片 URL，配合指标配置，每周幻灯片包自动保持客户品牌风格。
费用说明
每个 8 幻灯片汇报：2K 幻灯片包 810 积分，配音 1,680 积分，ZIP 下载和本地 ffmpeg 拼接免费。积分包价格从 5 美元 2,000 积分（0.0025 美元/积分）到 80 美元 40,000 积分（0.002 美元/积分）不等。
| 数量 | 幻灯片包积分 | 配音积分 | 总积分 | 美元（$0.0025） | 美元（$0.002，80 美元包） |
|---|---|---|---|---|---|
| 1 个带配音汇报 | 810 | 1,680 | 2,490 | $6.23 | $4.98 |
| 20 个/月（每周 5 个活动） | 16,200 | 33,600 | 49,800 | $124.50 | $99.60 |
| 500 个/月（每周 125 客户） | 405,000 | 840,000 | 1,245,000 | 不适用 | $2,490 |
| 20 个幻灯片包/月，无配音 | 16,200 | 0 | 16,200 | $40.50 | $32.40 |
两点说明：降至 resolution: "1K" 不省积分（100 积分/页适用于 512px、1K 和 2K，只有 4K 翻倍），建议保持 2K。Workspace 生成视频代替 ffmpeg 拼接，每个汇报额外加 160 积分（0.32 至 0.40 美元）。
Fast PPT 还是图像设计幻灯片？
| 需求 | Fast PPT generate | create-pdf-slides / create-like-this |
|---|---|---|
| 利益相关者在 PowerPoint 中编辑幻灯片 | 支持，原生 PPTX，1500+ 模板 | 不支持，输出 PDF 和页面图片 |
| 带配音的观看视频 | 不支持配音 | 支持，先 generate-narration 再生成 MP4 |
| 8 页成本 | 80 积分（约 0.20 美元） | 幻灯片包 810 积分，配音后 2,490 积分 |
| 周转时间 | 约 30 秒，默认同步 | 几分钟，默认异步 |
| 品牌控制 | 选择 GET /api/v1/themes/search 的 themeId | 自由文本 designStyle 或 referenceImageUrl |
许多团队两者兼用：Fast PPT 供客户经理注释，带配音视频供客户手机观看。营销团队如何规模化生成 AI 演示幻灯片 深入讲解可编辑方案。
常见陷阱
- 并行触发 50 个客户。 每个写入端点限制每密钥每分钟 6 次请求。应排队顺序处理，或均匀分布提交。
- 对 Fast PPT 任务调用
generate-narration。 配音仅支持create-pdf-slides或create-like-this生成的任务，generate任务会被拒绝且无法转换。 - 将 API 密钥放在浏览器端。 保持
SLIDES_API_KEY在服务器或调度器密钥库中。若客户端页面需视频，提供已生成的 MP4。 - 使用
page: 0而非固定 8 页。0表示自动检测页数。应设置page: 8，保证每周视频形态和时长一致。 - 传递语言代码。
responseLanguage需传语言名称如"Spanish"，非"es"。每客户配置存储名称。 - 直接传入原始指标导出。 3000 行 CSV 粘贴到
userInput会导致幻灯片混乱。先总结，提供 400-500 字叙述，CSV 作为附件。
常见问题解答
自动化带配音的每周营销报告视频成本多少？
带配音的 8 幻灯片汇报成本 2,490 积分，约 4.98 至 6.23 美元，取决于积分包。包括 810 积分的 2K 图像设计幻灯片包（10 规划 + 100 每页）和 1,680 积分的双讲者配音（210 每页）。每页 PNG 和 WAV 下载免费，本地 ffmpeg 拼接无额外费用。
AI 配音幻灯片 API 能否在一套幻灯片中使用两种不同声音？
可以。generate-narration 的 mode: "multi" 支持 speaker1Name、speaker2Name、speaker1Voice 和 speaker2Voice，两讲者交替配音。30 种声音可选，包括 Kore、Puck、Zephyr、Charon、Aoede 和 Leda。单讲者用 mode: "single"，传 speakerName 和 voice，费用同样是每页 210 积分。
配音视频演示 API 流程需要哪些端点？
三个，顺序调用：POST /api/v1/slides/create-pdf-slides（或带 referenceImageUrl 的 create-like-this）生成幻灯片包，POST /api/v1/slides/generate-narration 添加音频，POST /api/v1/slides/download-slides-pages-voices 获取 PNG 和 WAV 文件。步骤间每 5-10 秒轮询 GET /api/v1/jobs/{jobId}。Fast PPT 的 generate 不支持配音，不在此链中。
可以用多语言交付同一周报吗？
可以。create-pdf-slides 设置 responseLanguage 为语言名称（如 "Spanish" 或 "Japanese"），幻灯片文案会用该语言，配音也跟随内容。支持 20 多种语言。每种语言为独立任务，客户想要英语和西班牙语视频需支付两次 2,490 积分。
周一流水线每客户耗时多久？
预计几分钟：8 页 2K 幻灯片包渲染需几分钟，配音再加几分钟，ffmpeg 拼接通常不到一分钟。每 5-10 秒轮询，客户顺序处理，保持每分钟 6 次请求限制。50 客户批量从 06:00 开始，通常在首次晨会前完成。
后续步骤
- 在 2slides.com/api 获取 API 密钥。500 免费积分足够跑通一次带配音的完整汇报，验证流程后购买积分包，按计划自动化所有客户的营销报告演示。
- 浏览中心文章中的其他团队方案，按团队划分的 AI 演示 API 用例。
- 财务版流程（用月末报表替代广告指标）见 用 AI 语音配音自动化财务报告演示；脚本和节奏规则详见 Slides narration and video best practices。
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
