使用医疗保健 API 实现患者教育幻灯片自动化（2026）

患者教育幻灯片自动化指的是后台任务读取您内容库中已批准、去标识化的源文本（出院指导、手术说明、临床指南），并通过 2Slides API 将其转换为幻灯片。Fast PPT 的 generate 接口每页消耗 10 积分，生成每种病症和语言的可编辑 PPTX 文件，因此一套 8 页的幻灯片需 80 积分，约合 0.20 美元。create-pdf-slides 加上 generate-narration 可生成带旁白的员工培训幻灯片。该方案专为医院教育团队、数字健康公司和医学传播机构设计。

主要要点

一份已批准的源文档通过更改单个 responseLanguage 参数即可生成每种语言的一套幻灯片；2Slides 支持包括西班牙语、越南语和阿拉伯语在内的 20 多种语言。
一套 8 页的 Fast PPT 患者幻灯片费用为 80 积分，约 0.20 美元（基于 5 美元起步包）；每月 500 套幻灯片需 40,000 积分，正好对应 80 美元套餐。
一套带旁白的 10 页员工培训幻灯片，图像设计幻灯片费用为 1,010 积分，旁白费用为 2,100 积分，总计约 7.78 美元。
只有经批准且去标识化的文本才可传入 userInput，不包含患者姓名、病历号或出生日期。每个 jobId、源版本和审核决策均写入审计表。
2Slides 不声明 HIPAA 认证，本文非法律建议；合规控制由您自行实施和记录。

适用对象

您负责医院系统的患者教育、数字健康公司的内容管理，或医学传播机构的材料制作。痛点相同：指南更新后，40 个病症、6 种语言的幻灯片突然过时，而有能力更新的人正忙于门诊。后台任务从已批准的源文档重新生成幻灯片并发送给临床审核人员，消除了手动重建的繁琐，但不影响审核流程。

如果您的源文本尚未批准，或需要输入任何患者特定信息，请勿使用此方案。它适合大规模发布受控内容，不生成个性化护理方案。

工作流程概览

步骤	工具	发生内容	2Slides 接口 / 积分消耗
1	密钥管理器，后台服务	服务器端存储 API 密钥，定义允许进入提示的文本	`GET /api/v1/echo`（免费验证）
2	内容库（Git、CMS、DAM）	已批准、去标识化的源文本，带版本戳和校验和	无
3	后台任务	选择简洁临床模板，按病症和语言生成幻灯片	`GET /api/v1/themes/search`（免费），`POST /api/v1/slides/generate`（10 积分/页）
4	任务运行器 + 审核数据库	轮询，下载 PPTX，存储 jobId 和源版本，标记待审核	`GET /api/v1/jobs/{id}`（免费）
5	同一任务，培训路径	生成图像设计员工培训幻灯片，再生成旁白视频	`create-pdf-slides`（2K 分辨率每页 10+100 积分），`generate-narration`（210 积分/页）
6	临床审核人员，发布者	审核通过或拒绝，盖版本戳，发布到门户或 LMS	`download-slides-pages-voices`（免费获取 PNG + WAV 压缩包）

第 1 步：划定合规边界，API 密钥仅存服务器端

编写代码前，先明确边界：允许作为 userInput 发送的文本内容。患者教育内容应为已批准的面向大众的通用文本，描述病症、手术或指导，绝不涉及具体患者。HIPAA 隐私规则详见 hhs.gov/hipaa，隐私官负责判断第三方生成服务是否符合政策。本文不替代该合规审查。

然后在 2slides.com/api 获取 API 密钥。密钥在 API Keys 标签页发放，含 500 免费积分，足够生成约六套 8 页测试幻灯片。密钥应存于密钥管理器或服务器环境变量，绝不可放在浏览器、移动应用或共享笔记本中。

图 1：2slides.com 的 API 参考页，含密钥必须服务器端存储的安全提示。

在运行任务的服务器上验证密钥：

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

若返回认证响应，说明凭证有效，可继续下一步内容处理。

第 2 步：准备带版本戳的已批准去标识化源内容

生成任务从记录读取，而非聊天窗口。最简记录包含已批准文本、版本号和批准机构，确保每套幻灯片都可追溯到确切用词。

{
  "slug": "heart-failure-discharge",
  "title": "心衰出院指导",
  "version": "2026.09.1",
  "approved_by": "临床教育委员会",
  "approved_on": "2026-09-03",
  "reading_level": "6年级",
  "approved_text": "心衰意味着心脏泵血功能不佳。出院后：每天早晨称体重……如果一天内体重增加3磅或一周内增加5磅，请联系您的护理团队……"
}

确保记录安全发送的三条规则：

绝无 PHI（受保护健康信息）。 不含姓名、病历号、出生日期、预约日期或任何个人信息。每次提交前用正则表达式检测病历号和日期格式，检测失败则阻止任务。
仅限已批准文本。 任务读取状态为 approved 的记录的 approved_text 字段，忽略草稿。
通俗易懂的文本。 Fast PPT 会将您的文字匹配到模板占位符，6 年级阅读水平的文本生成的幻灯片也符合该水平。

第 3 步：使用 Fast PPT 生成多语言患者教育材料

先选定模板。搜索简洁、临床风格，保存返回的 themeId 作为配置：

curl -s "https://2slides.com/api/v1/themes/search?query=healthcare&limit=5" \
  -H "Authorization: Bearer $SLIDES_API_KEY"

也可尝试 query=medical。选择高对比度、大字号、无复杂信息图的模板；患者幻灯片常在手机或护士站打印阅读。

然后按语言生成幻灯片。英文源文本不变，仅修改 responseLanguage。使用 mode: "async" 支持批量提交。

curl -s -X POST https://2slides.com/api/v1/slides/generate \
  -H "Authorization: Bearer $SLIDES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "心衰出院指导。心衰意味着心脏泵血功能不佳。出院后：每天早餐前称体重。按药单服药。限制盐摄入量。若一天内体重增加3磅或一周内增加5磅，呼吸加重或腿部肿胀，请联系护理团队。源版本 2026.09.1，临床教育委员会审核。",
    "themeId": "<themes/search 返回的 themeId>",
    "responseLanguage": "Spanish",
    "mode": "async"
  }'

响应为 { "jobId": "..." }。依次用 "Vietnamese"、"Arabic"、"Simplified Chinese" 等支持语言重复提交。传语言名称，不要用代码；"es" 无效，需用 "Spanish"。

2Slides generate 接口，含 responseLanguage 和 20 多种支持语言

图 2：generate 接口文档，展示 responseLanguage 和 20 多种支持输出语言。

每 5 到 10 秒轮询任务状态，直到 success 或 failed：

curl -s https://2slides.com/api/v1/jobs/<jobId> \
  -H "Authorization: Bearer $SLIDES_API_KEY"

完成后返回 PPTX 下载链接。generate 限制每密钥每分钟 6 次请求，jobs/{id} 限制每分钟 10 次。10 种语言对应 10 次提交，间隔 10 秒，每套幻灯片约 30 秒生成完毕。

第 4 步：用 Python 构建审核队列（生成、存储、审核）

下面示例脚本读取一条已批准源记录，按语言生成幻灯片，下载 PPTX，写入 deck_reviews 表，状态为 pending_review。脚本不负责发布。审核人员（双语临床医生或认证医学翻译）审核后调用 approve()。

import hashlib
import json
import os
import sqlite3
import time

import requests

API = "https://2slides.com/api/v1"
HEADERS = {
    "Authorization": f"Bearer {os.environ['SLIDES_API_KEY']}",
    "Content-Type": "application/json",
}
# 从 GET /api/v1/themes/search?query=healthcare 选定，存为配置
THEME_ID = os.environ["CLINICAL_THEME_ID"]
LANGUAGES = ["English", "Spanish", "Vietnamese", "Arabic"]

db = sqlite3.connect("patient_education.db")
db.execute("""
CREATE TABLE IF NOT EXISTS deck_reviews (
  job_id         TEXT PRIMARY KEY,
  condition_slug TEXT,
  language       TEXT,
  source_version TEXT,
  source_sha256  TEXT,
  theme_id       TEXT,
  file_path      TEXT,
  status         TEXT,
  reviewer       TEXT,
  reviewed_at    TEXT,
  created_at     TEXT
)""")


def now():
    return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())


def assert_no_phi(text):
    # 最简检测；可根据需求扩展正则和人工审核
    import re
    if re.search(r"\bMRN\b|\b\d{7,10}\b|\b\d{1,2}/\d{1,2}/\d{2,4}\b", text):
        raise ValueError("源文本包含 PHI 模式，检测失败")


def submit(source, language):
    body = {
        "userInput": source["approved_text"],
        "themeId": THEME_ID,
        "responseLanguage": language,
        "mode": "async",
    }
    r = requests.post(f"{API}/slides/generate", headers=HEADERS, json=body, timeout=60)
    r.raise_for_status()
    return r.json()["jobId"]


def wait(job_id):
    while True:
        r = requests.get(f"{API}/jobs/{job_id}", headers=HEADERS, timeout=30)
        r.raise_for_status()
        job = r.json()
        if job["status"] == "success":
            return job["downloadUrl"]
        if job["status"] == "failed":
            raise RuntimeError(f"任务 {job_id} 失败")
        time.sleep(8)  # 每 5-10 秒轮询一次


def download(url, path):
    os.makedirs(os.path.dirname(path), exist_ok=True)
    with requests.get(url, stream=True, timeout=120) as r:
        r.raise_for_status()
        with open(path, "wb") as f:
            for chunk in r.iter_content(65536):
                f.write(chunk)


def enqueue_for_review(source):
    if source.get("status") != "approved":
        raise ValueError("仅允许生成已批准的源记录")
    assert_no_phi(source["approved_text"])
    digest = hashlib.sha256(source["approved_text"].encode("utf-8")).hexdigest()

    for language in LANGUAGES:
        job_id = submit(source, language)
        url = wait(job_id)
        path = f"decks/{source['slug']}/{source['version']}/{language}_{job_id}.pptx"
        download(url, path)
        db.execute(
            "INSERT INTO deck_reviews VALUES (?,?,?,?,?,?,?,?,?,?,?)",
            (job_id, source["slug"], language, source["version"], digest,
             THEME_ID, path, "pending_review", None, None, now()),
        )
        db.commit()
        time.sleep(10)  # 保持每密钥每分钟请求不超过 6 次


def approve(job_id, reviewer):
    db.execute(
        "UPDATE deck_reviews SET status='approved', reviewer=?, reviewed_at=? WHERE job_id=?",
        (reviewer, now(), job_id),
    )
    db.commit()


def reject(job_id, reviewer):
    db.execute(
        "UPDATE deck_reviews SET status='rejected', reviewer=?, reviewed_at=? WHERE job_id=?",
        (reviewer, now(), job_id),
    )
    db.commit()


if __name__ == "__main__":
    with open("sources/heart-failure-discharge.json", encoding="utf-8") as f:
        enqueue_for_review(json.load(f))

两个设计要点：文件路径和数据库行均包含源版本和 jobId，方便审核人员追溯“哪些文字生成了此幻灯片”；脚本无发布步骤，发布仅针对 status = 'approved' 的记录。

第 5 步：生成带旁白的临床员工培训幻灯片

患者幻灯片走 Fast PPT 路径，护士和教育者可在 PowerPoint 中编辑打印。员工培训通常需制作新员工入职视频，即图像设计幻灯片加语音旁白，使用 create-pdf-slides 到 generate-narration 链路，使用相同密钥和合规边界。

提交已批准的协议文本。page: 0 让规划者选择幻灯片页数；resolution: "2K" 保持每页 100 积分费用。

curl -s -X POST https://2slides.com/api/v1/slides/create-pdf-slides \
  -H "Authorization: Bearer $SLIDES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "入职培训：住院病区手卫生及个人防护装备穿脱顺序。已批准协议版本 2026.09。<此处填写已批准协议文本>",
    "designStyle": "简洁临床培训幻灯片，柔和蓝白色调，大字号易读，简约线条图标，无患者照片",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 0,
    "contentDetail": "standard",
    "responseLanguage": "English"
  }'

按前述方式轮询 jobs/{jobId}。任务成功后请求旁白：

curl -s -X POST https://2slides.com/api/v1/slides/generate-narration \
  -H "Authorization: Bearer $SLIDES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "<create-pdf-slides 返回的 jobId>",
    "mode": "single",
    "speakerName": "Clinical Educator",
    "voice": "Kore",
    "contentMode": "standard",
    "includeIntro": true
  }'

旁白仅支持异步，费用为每页 210 积分。完成后调用 POST /api/v1/slides/download-slides-pages-voices，传 { "jobId": "..." }，可免费获取每页 PNG 和 WAV 文件压缩包，您的流程可用 FFmpeg 合成 MP4，或交由 LMS 使用。旁白脚本需同幻灯片一起审核，音频错误仍属错误。内容结构参考如何用 AI 制作培训幻灯片；若协议为 PDF，参考PDF 转幻灯片工作流，先摘要再提交。

第 6 步：发布、版本盖章及审计患者教育幻灯片自动化

发布是数据库查询，不是生成调用。发布者筛选 status = 'approved' 的行，将 PPTX（或导出 PDF）复制到患者门户、信息亭或 LMS，并在发布页盖上版本戳：源版本、批准日期、语言。源记录版本更新为 2026.10.1 时，任务重新生成所有语言，旧记录标记为 superseded，审核队列重新填充。

deck_reviews 表即审计日志。每套幻灯片记录质量团队关心的信息：源版本、校验和、模板、jobId、审核人及时间。根据您的记录保留政策妥善保存。

选择参考样式

若无 Fast PPT 模板符合您的视觉识别，图像设计路径可从参考样式派生设计系统。2Slides Gallery 提供真实参考幻灯片，您可将其作为 referenceImageUrl 传给 create-like-this，或用作 designStyle 提示灵感。它们是参考幻灯片，不是本工作流的 API 输出。

2Slides Gallery 中的“2025 健康未来”参考幻灯片，简洁医疗行业视觉风格

图 3：“2025 健康未来”参考幻灯片封面，柔和低对比度医疗行业风格，适合作为 referenceImageUrl。

图 4：同一参考幻灯片内容页，克制色彩保持临床信息易读。

2Slides Gallery 详情页，含幻灯片逐页预览和 PPT/PDF 下载

图 5：Gallery 详情页，含逐页预览和 PPT/PDF 下载；复制幻灯片图片 URL 用作参考。

对大多数医院团队而言，更佳参考是您自有的已批准品牌幻灯片：将其托管于公开 URL，传入 referenceImageUrl，每套员工幻灯片均继承该设计系统。

费用估算

两个现实月度用量示例。患者幻灯片为 8 页 Fast PPT 文件；员工培训幻灯片为 10 页 2K 图像设计幻灯片，含旁白。

项目	单个积分	A 档：20 套患者幻灯片 + 2 套带旁白培训幻灯片	B 档：500 套患者幻灯片 + 10 套带旁白培训幻灯片
患者幻灯片，8 页，Fast PPT	80	1,600	40,000
员工幻灯片，10 页，2K 图像设计	1,010	2,020	10,100
旁白，10 页	2,100	4,200	21,000
总积分		7,820	71,100
约合美元		19.55 美元（0.0025 美元/积分，适用 10,000 积分 22.50 美元套餐）	142.20 美元（0.002 美元/积分，适用 40,000 积分 80 美元套餐）

A 档为 10 个病症、2 种语言库加每月两套入职视频；B 档为 50 个病症、10 种语言库加十套视频，适合多站点系统。积分按用量付费；可选 Pro 计划每月赠送 10,000 积分，但非 API 访问必需。

本用例选择 Fast PPT 还是图像设计幻灯片？

需求	方案	原因
护士编辑打印的患者手册	`generate`（Fast PPT）	原生可编辑 PPTX，10 积分/页，约 30 秒生成一套
同一内容多语言版本	`generate` + `responseLanguage`	一份源文本，语言参数切换
员工入职视频	`create-pdf-slides` + `generate-narration`	仅图像设计支持旁白；获取 PNG + WAV 压缩包合成 MP4
幻灯片需符合医院品牌形象	`create-like-this` + `referenceImageUrl`	从已批准幻灯片派生设计系统

Fast PPT 不支持旁白。需要音频的患者面向幻灯片应走图像设计路径，费用为每页 100 积分加 210 积分旁白，返回 PDF 和图片而非可编辑 PPTX。

常见陷阱

PHI 通过次要字段泄露。 指南中的“病例示例”段落可能含真实患者信息。对所有拼接入 userInput 的字段运行模式检测，并在上游保留人工去标识化步骤。
重生成时触发速率限制。 generate、create-pdf-slides 和 generate-narration 每密钥每分钟限 6 次请求。提交间隔 10 秒；50 个病症、10 种语言共 500 个任务，约 84 分钟，适合夜间批处理。
API 密钥出现在前端或笔记本。 密钥应仅存服务器环境变量。若泄露，立即更换。
尝试为 Fast PPT 任务生成旁白。 generate-narration 拒绝 generate 任务的 jobId。需用 create-pdf-slides 或 create-like-this。
语言参数传代码。 responseLanguage 需传语言名称，如 "Vietnamese" 或 "Traditional Chinese"，代码如 "vi" 会失败。
整篇 40 页指南直接粘贴。 输入过长导致幻灯片密集杂乱。先摘要至 6-10 个患者重点，或图像设计路径设置 page: 0 让规划者选择页数。

常见问题解答

发送患者教育内容到 AI 幻灯片 API 是否安全？

只要内容已批准、面向大众且不含受保护健康信息（PHI），即适用。针对“心衰患者”的出院指导不含 PHI；涉及具体患者的备注则含 PHI。请保持自动化 PHI 检测并在上游执行，且咨询您的隐私官。2Slides 不声明 HIPAA 认证，本文非法律建议。

多语言患者教育材料支持哪些语言？

2Slides 通过 responseLanguage 支持 20 多种输出语言，包括英语、西班牙语、阿拉伯语、葡萄牙语、越南语、简体中文、繁体中文、印地语、韩语、俄语、法语和德语。传语言名称，不用 ISO 代码。输出视为初稿，需双语临床医生或认证医学翻译审核后发布。

患者面向幻灯片能否像员工培训幻灯片一样带旁白？

可以，但仅限图像设计路径。患者幻灯片用 create-pdf-slides（2K 分辨率每页 100 积分）生成，再调用 generate-narration（210 积分/页）。一套 6 页带旁白患者说明费用为 10 + 600 + 1,260 = 1,870 积分，约 4.68 美元。Fast PPT 任务不支持旁白。

如何处理多语言的指南更新？

更新源记录版本，标记旧记录为 superseded，重新运行任务。每种语言生成新 jobId，文件路径含新版本，新增 pending_review 记录。发布时仅当审核通过才更新版本戳，患者不会看到未经审核的更新，审计日志记录每种语言切换时间。

与其他医疗幻灯片生成 API 比较如何？

Gamma API（详见 developers.gamma.app）也支持自动生成，但需 Pro 计划才能获取 API 密钥；2Slides 密钥适用于任何账户，包括免费层的 500 积分，便于医院 IT 试点。两者均为第三方服务，去标识化规则相同。此比较由 2Slides 团队撰写。

后续步骤

患者教育幻灯片自动化主要是治理工作，代码量少：一条已批准源记录、一批按语言生成的任务和一个审核队列控制发布。

在 2slides.com/api 获取 API 密钥；500 免费积分足够生成约六套 8 页测试幻灯片。
浏览中心文章中的其他团队方案，按团队划分的 AI 幻灯片 API 用例。
相关阅读：医疗保健与医学幻灯片的 AI 演示（手动工作流替代方案），以及带 AI 语音的企业培训视频（带旁白入职幻灯片制作）。

使用医疗保健 API 实现患者教育幻灯片自动化（2026）

适用对象

工作流程概览

第 1 步：划定合规边界，API 密钥仅存服务器端

第 2 步：准备带版本戳的已批准去标识化源内容

第 3 步：使用 Fast PPT 生成多语言患者教育材料

第 4 步：用 Python 构建审核队列（生成、存储、审核）

第 5 步：生成带旁白的临床员工培训幻灯片

第 6 步：发布、版本盖章及审计患者教育幻灯片自动化

选择参考样式

费用估算

本用例选择 Fast PPT 还是图像设计幻灯片？

常见陷阱

常见问题解答

发送患者教育内容到 AI 幻灯片 API 是否安全？

多语言患者教育材料支持哪些语言？

患者面向幻灯片能否像员工培训幻灯片一样带旁白？

如何处理多语言的指南更新？

与其他医疗幻灯片生成 API 比较如何？

后续步骤

About 2Slides

Summarize with AI

Products

Features

Gallery

Templates

Integrations

Resources

Comparison