Tự động hóa trình bày báo cáo marketing: Deck to Video API (2026)

Q: API thuyết minh giọng AI có thể dùng hai giọng khác nhau trong một deck không?

Có. generate-narration với mode: "multi" nhận speaker1Name, speaker2Name, speaker1Voice, và speaker2Voice, xen kẽ hai người nói qua các slide. Có 30 giọng chọn, gồm Kore, Puck, Zephyr, Charon, Aoede, và Leda. Dùng mode: "single" với speakerName và voice khi chỉ cần một người thuyết minh, cùng chi phí 210 credits mỗi trang.

Q: Pipeline API video thuyết minh cần những endpoint nào?

Ba endpoint theo thứ tự: POST /api/v1/slides/create-pdf-slides (hoặc create-like-this với referenceImageUrl) để thiết kế deck, POST /api/v1/slides/generate-narration trên jobId tạo âm thanh, và POST /api/v1/slides/download-slides-pages-voices để tải PNG và WAV. Kiểm tra trạng thái qua GET /api/v1/jobs/{jobId} mỗi 5-10 giây giữa các bước. Fast PPT generate không nằm trong chuỗi này vì không thể thuyết minh.

Q: Có thể gửi cùng báo cáo tuần bằng nhiều ngôn ngữ không?

Có. Đặt responseLanguage trên create-pdf-slides thành tên ngôn ngữ như "Spanish" hoặc "Japanese" để nội dung slide viết bằng ngôn ngữ đó; thuyết minh theo nội dung slide. Hỗ trợ hơn 20 ngôn ngữ. Mỗi ngôn ngữ là một job deck riêng, nên khách muốn video tiếng Anh và tiếng Tây Ban Nha trả tiền cho hai lần chạy 2,490 credits.

Để tự động hóa trình bày báo cáo marketing, chạy một cron vào thứ Hai để lấy số liệu chiến dịch, yêu cầu một LLM tạo câu chuyện 8 slide, và gọi ba endpoint của 2Slides: create-pdf-slides để tạo deck tóm tắt thiết kế hình ảnh tỷ lệ 16:9, generate-narration ở chế độ multi cho track giọng nói hai người, và download-slides-pages-voices để tải file PNG và WAV từng trang mà ffmpeg sẽ ghép thành MP4. Một deck 8 trang 2K tốn 810 credits (khoảng 2 đô), phần thuyết minh thêm 1,680 credits (khoảng 4.20 đô), nên một bản tóm tắt có thuyết minh hàng tuần khoảng 6 đô mỗi khách hàng. Dành cho marketing ops, kỹ sư tăng trưởng và agency.

Điểm chính

Một công việc theo lịch thay thế quy trình thứ Hai: xuất số liệu, deck tóm tắt 8 slide, thuyết minh hai người, và video MP4 1920×1080.
Ba endpoint 2Slides thực hiện công việc: create-pdf-slides (10 + 100 credits mỗi trang ở 2K), generate-narration (210 credits mỗi trang), và download-slides-pages-voices (miễn phí).
Một bản tóm tắt 8 slide có thuyết minh tốn 2,490 credits, khoảng 5 đến 6.25 đô tùy gói credit; riêng deck là 810 credits.
Mỗi endpoint ghi dữ liệu giới hạn 6 yêu cầu mỗi phút mỗi key, nên chạy 50 khách hàng phải xếp hàng, không chạy song song.
Fast PPT (generate) không thể thuyết minh; để làm video, bắt đầu từ create-pdf-slides hoặc create-like-this.

Dành cho ai

Trưởng nhóm marketing ops phải làm lại deck tóm tắt hàng tuần vào thứ Hai, kỹ sư tăng trưởng đã có số liệu trong kho dữ liệu, và agency phải gửi cập nhật hàng tuần cho 20, 50 hoặc nhiều khách hàng hơn. Vấn đề chung: số liệu sẵn lúc 6 giờ sáng, deck xong trước trưa, nhưng một nửa người liên quan không bao giờ mở.

Không dùng công thức này nếu người liên quan cần chỉnh sửa slide trong PowerPoint sau đó; pipeline thiết kế hình ảnh tạo ra PDF hoàn chỉnh kèm ảnh từng trang, không phải PPTX gốc. Với deck tuần có thể chỉnh sửa, đường dẫn Fast PPT trong Tự động hóa báo cáo tuần với Zapier và 2Slides phù hợp hơn.

Quy trình tổng quan

Bước	Công cụ	Việc xảy ra	Endpoint 2Slides / credits
1. Kích hoạt	Cron (GitHub Actions, Cloud Scheduler, cron trên VM)	Chạy lúc 06:00 thứ Hai theo múi giờ khách hàng	không có
2. Lấy số liệu	Google Ads, Meta, GA4 export, hoặc truy vấn SQL kho dữ liệu	Một đối tượng JSON mỗi khách hàng: chi tiêu, kế hoạch, chuyển đổi, CPA, kênh hàng đầu, quảng cáo hàng đầu	không có
3. Viết câu chuyện	LLM bạn chọn	Trả về 8 phần có tiêu đề: kết quả chính, chi tiêu so với kế hoạch, kênh hàng đầu, quảng cáo thắng, ghi chú đối tượng, thử nghiệm, rủi ro, kế hoạch tuần tới	không có
4. Tạo deck	2Slides	Deck thiết kế hình ảnh tỷ lệ 16:9 2K với `designStyle` thương hiệu bạn	`POST /api/v1/slides/create-pdf-slides`, 810 credits cho 8 trang
5. Thêm thuyết minh	2Slides	Hai người nói xen kẽ qua deck	`POST /api/v1/slides/generate-narration`, 1,680 credits cho 8 trang
6. Lấy tài nguyên	2Slides	ZIP gồm `pages/page_01.png`, `voices/page_01.wav`, và `transcript.txt`	`POST /api/v1/slides/download-slides-pages-voices`, miễn phí
7. Ghép và gửi	ffmpeg trên worker của bạn, hoặc Workspace Export	MP4 H.264 đăng lên Slack, email hoặc cổng khách hàng	ffmpeg: miễn phí; Workspace Generate Video: 20 credits mỗi trang

Mỗi cuộc gọi 2Slides dùng header Authorization: Bearer $SLIDES_API_KEY giống nhau, và mỗi job bất đồng bộ được kiểm tra trạng thái qua GET /api/v1/jobs/{jobId}.

Bước 1: Lấy API key và kết nối bộ lập lịch

Tạo key tại 2slides.com/api trong tab API Keys. Tài khoản mới có 500 credits miễn phí không cần đăng ký, đủ chạy pipeline này một lần trước khi mua gói. Lưu key dưới tên SLIDES_API_KEY trong kho bí mật của bộ lập lịch, không lưu trong trình duyệt hay notebook chia sẻ, và kiểm tra bằng endpoint echo trước khi lên lịch.

curl -s https://2slides.com/api/v1/echo \
  -H "Authorization: Bearer $SLIDES_API_KEY"

2Slides API reference with Bearer authentication

Hình 1: Tham khảo API tại 2slides.com/api liệt kê mọi endpoint, header Bearer, và chi phí credits.

Với trigger, workflow GitHub Actions với on: schedule: - cron: "0 6 * * 1" đủ cho vài khách hàng. Với 50 khách hoặc hơn, xếp hàng khách và để một worker xử lý tuần tự, giữ dưới giới hạn 6 yêu cầu mỗi phút và có thể thử lại.

Bước 2: Lấy số liệu và để LLM viết câu chuyện 8 slide

API 2Slides không biết nội dung tóm tắt tuần tốt là gì; phần này do bạn quyết định, ảnh hưởng đến chất lượng deck. Lấy số liệu tuần trước từ nền tảng quảng cáo hoặc kho dữ liệu thành một đối tượng JSON phẳng mỗi khách hàng, rồi yêu cầu LLM trả về đúng tám phần có tiêu đề:

Kết quả chính: một số, một câu ("CPA giảm 18% tuần này so với tuần trước với chi tiêu không đổi").
Chi tiêu so với kế hoạch: thực tế, kế hoạch, sai lệch, tiến độ tháng.
Kênh hàng đầu: ba kênh với chi tiêu, chuyển đổi, CPA, và thay đổi.
Quảng cáo thắng: hai hoặc ba quảng cáo chuyển đổi tốt nhất và lý do.
Ghi chú đối tượng và địa lý: thay đổi gì.
Thử nghiệm đang chạy: giả thuyết, trạng thái, ngày đọc.
Rủi ro và cản trở: giới hạn ngân sách, thiếu sót theo dõi, tính mùa vụ.
Kế hoạch tuần tới: ba điểm với người chịu trách nhiệm.

Yêu cầu câu văn đơn giản, số liệu nằm trong câu, dưới 60 từ mỗi phần. create-pdf-slides coi văn bản bạn gửi là nguồn chính cho nội dung và bố cục, nên câu chuyện sạch, 400-500 từ tạo deck gọn hơn so với 3,000 từ tràn lan mọi số liệu.

// narrative.mjs: định dạng đầu ra LLM trước khi gửi 2Slides
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}`;
}

Bước 3: Tự động tạo deck báo cáo chiến dịch với create-pdf-slides

Gửi câu chuyện đến create-pdf-slides. Đặt page: 8 để số slide khớp tám phần, aspectRatio: "16:9" cho màn hình, và resolution: "2K" để PNG giữ chất lượng 1920×1080 không bị phóng to. designStyle là nơi thương hiệu bạn hiện diện: màu sắc, kiểu chữ, quy tắc bố cục, và điều cần tránh.

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"
  }'

Phản hồi là { "jobId": "..." }. Kiểm tra GET https://2slides.com/api/v1/jobs/{jobId} mỗi 5-10 giây đến khi status là success (PDF có tại downloadUrl) hoặc failed. Dự kiến vài phút cho 8 trang 2K. Chi phí: 10 credits lập kế hoạch cộng 100 credits mỗi trang, tổng 810 credits cho deck 8 trang.

2Slides Nano Banana image-designed slides page, the pipeline behind create-pdf-slides

Hình 2: Pipeline thiết kế hình ảnh phía sau Nano Banana presentation slides là thứ create-pdf-slides cung cấp qua API.

Để khớp với slide thương hiệu có sẵn thay vì mô tả văn bản, dùng create-like-this với referenceImageUrl trỏ tới ảnh công khai của một slide thương hiệu. Nội dung, chi phí và giới hạn giống hệt.

Bước 4: Hai người nói với API thuyết minh video trình bày

Khi job deck báo success, gọi generate-narration với cùng jobId. Dùng mode: "multi" với hai người nói có tên và hai trong 30 giọng có sẵn; Kore và Puck cách xa nhau đủ để người nghe phân biệt ai đang nói mà không cần hình ảnh. includeIntro: true thêm phần mở đầu ngắn giới thiệu khách hàng và tuần.

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
  }'

Endpoint trả về 202 và job trở lại trạng thái processing. Kiểm tra lại jobId đến khi success. Thuyết minh tốn 210 credits mỗi trang (10 cho kịch bản, 200 cho âm thanh), tổng 1,680 credits cho 8 slide. Hướng dẫn độ dài kịch bản và nhịp điệu xem Slides narration and video best practices.

So sánh nhanh, vì nhiều người hỏi: trang developer của Gamma (https://developers.gamma.app) có công thức video thuyết minh dùng chuỗi n8n, Synthesia, ElevenLabs, và API Generate riêng, yêu cầu key Pro. Đường dẫn 2Slides trên dùng một nhà cung cấp và một key cho mọi tài khoản, với ffmpeg bên bạn để ghép; không tạo avatar người thuyết trình như Synthesia. Tiết lộ: 2Slides là sản phẩm của chúng tôi.

Bước 5: Biến báo cáo marketing tuần thành video với ffmpeg

Gọi download-slides-pages-voices với cùng jobId. Nó trả về ZIP miễn phí chứa pages/page_01.png đến page_08.png, voices/page_01.wav đến page_08.wav, và transcript.txt kịch bản nói để làm phụ đề hoặc tóm tắt email.

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

Sau đó ghép từng PNG với WAV tương ứng và nối lại. Lệnh một dòng này tạo MP4 H.264 1920×1080, mỗi slide hiển thị đúng thời gian thuyết minh:

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.mp4

Concat demuxer cuối cùng được mô tả trong ffmpeg formats reference. Để cắt dọc, đổi cả hai giá trị 1920:1080 thành 1080:1920 và tạo lại deck với aspectRatio: "9:16".

Không có worker ffmpeg? Mở cùng job trong 2Slides Workspace, dùng Export rồi Generate Video. Nó tạo MP4 H.264 1920×1080 hoặc 1080×1920 trên trình duyệt với 20 credits mỗi trang (160 cho 8 slide). Phù hợp làm một lần; ffmpeg phù hợp cho 50 khách hàng mỗi thứ Hai.

Bước 6: Pipeline Node.js tự động trình bày báo cáo marketing

Toàn bộ dưới dạng script Node 20 không phụ thuộc ngoài fetch. Thay loadMetrics và writeNarrative bằng truy vấn kho dữ liệu và gọi LLM của bạn.

// weekly-recap.mjs: Node 20+, chạy từ cron thứ Hai
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}`, // chỉ server-side
  "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); // kiểm tra mỗi 5–10 giây; jobs/{id} cho phép 10 req/phút
  }
}

export async function buildRecap(client) {
  // 1) số liệu -> câu chuyện 8 phần
  const metrics = await loadMetrics(client);
  const sections = await writeNarrative(client, metrics);

  // 2) deck thiết kế hình ảnh: 10 + 100 credits/trang ở 2K
  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) thuyết minh hai người: 210 credits/trang
  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 từng trang (miễn phí) -> MP4 qua ffmpeg
  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`]); // vòng lặp ffmpeg bước 5

  return { jobId, pdf: deck.downloadUrl, video: `out/${client.slug}-recap.mp4` };
}

// Xử lý khách hàng lần lượt: 3 POST mỗi khách giữ dưới 6 req/phút
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); // cảnh báo, không thử lại mù quáng
  }
}

Mỗi khách hàng tốn ba yêu cầu ghi (deck, thuyết minh, tải xuống) cộng với đọc kiểm tra trạng thái, có giới hạn 10 req/phút riêng.

Chọn phong cách tham khảo

Nếu mô tả thương hiệu trong designStyle chưa đủ, dùng ảnh tham khảo. 2Slides Gallery có các deck thực tế bạn có thể duyệt để lấy ý tưởng hoặc dùng làm referenceImageUrl cho create-like-this. Đây là deck tham khảo, không phải đầu ra API: các slide dưới đây từ deck Adobe Creative Trends 2026 trong Gallery, thể hiện phong cách đơn giản, tập trung dữ liệu, dễ đọc trong tóm tắt tuần.

Adobe Creative Trends 2026 reference deck from the 2Slides Gallery, a style reference for marketing recap decks

Hình 3: Slide bìa deck Adobe Creative Trends 2026 trong 2Slides Gallery.

Hình 4: Một slide bên trong cùng deck. Gửi slide này làm referenceImageUrl để create-like-this lấy màu sắc, kiểu chữ, bố cục.

2Slides Gallery of ready-to-download slide decks

Hình 5: 2Slides Gallery. Mở deck và sao chép URL ảnh slide bạn muốn kế thừa phong cách.

Với agency, lưu một URL slide tham khảo mỗi khách bên cạnh cấu hình số liệu, và mỗi deck thứ Hai giữ phong cách hình ảnh của khách đó.

Chi phí

Cho mỗi bản tóm tắt 8 slide: 810 credits cho deck 2K, 1,680 cho thuyết minh, miễn phí ZIP và ffmpeg trên máy bạn. Gói credit từ 5 đô cho 2,000 credits (0.0025 đô mỗi credit) đến 80 đô cho 40,000 credits (0.002 đô mỗi credit).

Khối lượng	Credits deck	Credits thuyết minh	Tổng credits	USD theo $0.0025	USD theo $0.002 (gói $80)
1 bản tóm tắt có thuyết minh	810	1,680	2,490	$6.23	$4.98
20 bản/tháng (5 chiến dịch mỗi tuần)	16,200	33,600	49,800	$124.50	$99.60
500 bản/tháng (125 khách hàng mỗi tuần)	405,000	840,000	1,245,000	không áp dụng	$2,490
20 deck/tháng, không thuyết minh	16,200	0	16,200	$40.50	$32.40

Hai lưu ý. Giảm xuống resolution: "1K" không tiết kiệm gì (100 credits mỗi trang áp dụng cho 512px, 1K, và 2K; chỉ 4K tăng gấp đôi), nên giữ 2K. Tạo MP4 trong Workspace thay vì ffmpeg thêm 160 credits (0.32 đến 0.40 đô) mỗi bản tóm tắt.

Fast PPT hay slide thiết kế hình ảnh cho trường hợp này?

Nhu cầu	Fast PPT `generate`	`create-pdf-slides` / `create-like-this`
Người liên quan chỉnh sửa deck trong PowerPoint	Có, PPTX gốc từ 1,500+ mẫu	Không, đầu ra là PDF và ảnh trang
Video xem thay vì đọc có thuyết minh	Không, không có thuyết minh	Có, `generate-narration` rồi MP4
Chi phí 8 trang	80 credits (khoảng $0.20)	810 credits deck, 2,490 có thuyết minh
Thời gian hoàn thành	Khoảng 30 giây, đồng bộ mặc định	Vài phút, bất đồng bộ mặc định
Kiểm soát thương hiệu	Chọn `themeId` từ `GET /api/v1/themes/search`	`designStyle` văn bản tự do hoặc `referenceImageUrl`

Nhiều đội dùng cả hai: deck Fast PPT cho quản lý tài khoản chú thích, và video có thuyết minh cho khách xem trên điện thoại. Cách đội marketing tạo deck trình bày AI quy mô lớn nói kỹ về phần chỉnh sửa.

Những lỗi thường gặp

Chạy 50 khách hàng song song. Mỗi endpoint ghi dữ liệu cho phép 6 yêu cầu mỗi phút mỗi key. Xếp hàng khách và xử lý tuần tự, hoặc phân bổ đều trong giờ.
Gọi generate-narration trên job Fast PPT. Thuyết minh chỉ nhận job từ create-pdf-slides hoặc create-like-this; job generate bị từ chối và không thể chuyển đổi.
Đặt API key trong dashboard trình duyệt. Giữ SLIDES_API_KEY trên server hoặc kho bí mật bộ lập lịch. Nếu trang khách cần video, phục vụ MP4 đã tạo sẵn.
Dùng page: 0 khi muốn đúng 8 slide. 0 nghĩa là tự động phát hiện số trang. Đặt page: 8 để video tuần nào cũng có độ dài và hình dạng giống nhau.
Truyền mã ngôn ngữ. responseLanguage nhận tên như "Spanish", không phải "es". Lưu tên trong cấu hình mỗi khách.
Gửi thẳng số liệu thô. CSV 3,000 dòng dán vào userInput tạo deck lộn xộn. Tóm tắt trước, giao câu chuyện 400-500 từ, giữ CSV làm file đính kèm.

Câu hỏi thường gặp

Chi phí tự động hóa báo cáo marketing hàng tuần dưới dạng video có thuyết minh là bao nhiêu?

Một bản tóm tắt 8 slide có thuyết minh tốn 2,490 credits, từ 4.98 đến 6.23 đô tùy gói credit. Gồm 810 credits cho deck 2K thiết kế hình ảnh (10 lập kế hoạch + 100 mỗi trang) và 1,680 credits cho thuyết minh hai người (210 mỗi trang). Tải PNG và WAV từng trang miễn phí, ghép với ffmpeg trên máy bạn không tốn thêm.

API thuyết minh giọng AI có thể dùng hai giọng khác nhau trong một deck không?

Có. generate-narration với mode: "multi" nhận speaker1Name, speaker2Name, speaker1Voice, và speaker2Voice, xen kẽ hai người nói qua các slide. Có 30 giọng chọn, gồm Kore, Puck, Zephyr, Charon, Aoede, và Leda. Dùng mode: "single" với speakerName và voice khi chỉ cần một người thuyết minh, cùng chi phí 210 credits mỗi trang.

Pipeline API video thuyết minh cần những endpoint nào?

Ba endpoint theo thứ tự: POST /api/v1/slides/create-pdf-slides (hoặc create-like-this với referenceImageUrl) để thiết kế deck, POST /api/v1/slides/generate-narration trên jobId tạo âm thanh, và POST /api/v1/slides/download-slides-pages-voices để tải PNG và WAV. Kiểm tra trạng thái qua GET /api/v1/jobs/{jobId} mỗi 5-10 giây giữa các bước. Fast PPT generate không nằm trong chuỗi này vì không thể thuyết minh.

Có thể gửi cùng báo cáo tuần bằng nhiều ngôn ngữ không?

Có. Đặt responseLanguage trên create-pdf-slides thành tên ngôn ngữ như "Spanish" hoặc "Japanese" để nội dung slide viết bằng ngôn ngữ đó; thuyết minh theo nội dung slide. Hỗ trợ hơn 20 ngôn ngữ. Mỗi ngôn ngữ là một job deck riêng, nên khách muốn video tiếng Anh và tiếng Tây Ban Nha trả tiền cho hai lần chạy 2,490 credits.

Pipeline thứ Hai mất bao lâu cho mỗi khách hàng?

Dự kiến vài phút mỗi khách: deck 8 trang 2K mất vài phút render, thuyết minh thêm vài phút, và ghép ffmpeg thường dưới một phút cho 8 clip. Kiểm tra trạng thái mỗi 5-10 giây và xử lý khách lần lượt giữ giới hạn 6 yêu cầu mỗi phút, chạy 50 khách bắt đầu 06:00 thường xong trước cuộc họp đầu tiên.

Bước tiếp theo

Lấy API key tại 2slides.com/api. 500 credits miễn phí đủ cho một bản tóm tắt có thuyết minh hoàn chỉnh để bạn kiểm tra pipeline trước khi mua gói, rồi tự động hóa trình bày báo cáo marketing cho mọi khách hàng cùng lịch.
Xem các công thức theo nhóm khác trong bài tổng hợp, AI presentation API use cases by team.
Phiên bản tài chính của quy trình này, với báo cáo cuối tháng thay vì số liệu quảng cáo, có trong Automate financial report presentations with AI voice narration; xem thêm quy tắc kịch bản và nhịp điệu tại Slides narration and video best practices.

Tự động hóa trình bày báo cáo marketing: Deck to Video API (2026)

Dành cho ai

Quy trình tổng quan

Bước 1: Lấy API key và kết nối bộ lập lịch

Bước 2: Lấy số liệu và để LLM viết câu chuyện 8 slide

Bước 3: Tự động tạo deck báo cáo chiến dịch với create-pdf-slides

Bước 4: Hai người nói với API thuyết minh video trình bày

Bước 5: Biến báo cáo marketing tuần thành video với ffmpeg

Bước 6: Pipeline Node.js tự động trình bày báo cáo marketing

Chọn phong cách tham khảo

Chi phí

Fast PPT hay slide thiết kế hình ảnh cho trường hợp này?

Những lỗi thường gặp

Câu hỏi thường gặp

Chi phí tự động hóa báo cáo marketing hàng tuần dưới dạng video có thuyết minh là bao nhiêu?

API thuyết minh giọng AI có thể dùng hai giọng khác nhau trong một deck không?

Pipeline API video thuyết minh cần những endpoint nào?

Có thể gửi cùng báo cáo tuần bằng nhiều ngôn ngữ không?

Pipeline thứ Hai mất bao lâu cho mỗi khách hàng?

Bước tiếp theo

About 2Slides

Summarize with AI

Products

Features

Gallery

Templates

Integrations

Resources

Comparison