

Automação de Slides para Educação do Paciente com uma API de Saúde (2026)
Automação de slides para educação do paciente significa que um trabalho backend lê texto-fonte aprovado e desidentificado (instruções de alta, explicações de procedimentos, diretrizes clínicas) do seu repositório de conteúdo e o transforma em apresentações através da API 2Slides. O Fast PPT generate produz um PPTX editável por condição e por idioma a 10 créditos por página, então uma apresentação de 8 páginas custa 80 créditos, cerca de US$ 0,20. create-pdf-slides junto com generate-narration produz apresentações narradas para treinamento de equipe. Foi criado para equipes de educação hospitalar, empresas de saúde digital e agências de comunicação médica.
Principais pontos
- Um documento fonte aprovado vira uma apresentação por idioma alterando um único valor
responseLanguage; o 2Slides gera em mais de 20 idiomas, incluindo espanhol, vietnamita e árabe. - Uma apresentação de paciente Fast PPT de 8 páginas custa 80 créditos, cerca de US$ 0,20 no pacote inicial de US$ 5; 500 apresentações por mês são 40.000 créditos, exatamente o pacote de US$ 80.
- Uma apresentação narrada de 10 páginas para treinamento de equipe custa 1.010 créditos pelas imagens das páginas mais 2.100 créditos pela narração, cerca de US$ 7,78 no total.
- Apenas texto aprovado e desidentificado entra em
userInput: sem nomes de pacientes, MRNs ou datas de nascimento. Cada jobId, versão da fonte e decisão do revisor são gravados em uma tabela de auditoria. - O 2Slides não faz nenhuma alegação de certificação HIPAA e este post não é aconselhamento legal; os controles de conformidade aqui são de sua responsabilidade implementar e documentar.
Para quem é isto
Você gerencia educação do paciente em um sistema hospitalar, é responsável pelo conteúdo em uma empresa de saúde digital ou produz materiais em uma agência de comunicação médica. A dor é a mesma: uma diretriz muda, e 40 apresentações específicas para condições em 6 idiomas ficam desatualizadas enquanto as pessoas que poderiam corrigir estão atendendo clínicas. Um trabalho backend que regenera as apresentações a partir da fonte aprovada e as encaminha para um revisor clínico elimina a reconstrução manual sem eliminar a revisão.
Não use esta receita se seu texto fonte ainda não estiver aprovado, ou se algo específico do paciente precisaria entrar em um prompt. Ela publica conteúdo controlado em escala; não gera planos de cuidado individualizados.
O fluxo de trabalho em resumo
| Passo | Ferramenta | O que acontece | Endpoint 2Slides / créditos |
|---|---|---|---|
| 1 | Gerenciador de segredos, serviço backend | Armazena a chave API no servidor, define que texto pode entrar no prompt | GET /api/v1/echo (verificação de autenticação gratuita) |
| 2 | Repositório de conteúdo (Git, CMS, DAM) | Texto fonte aprovado e desidentificado com carimbo de versão e checksum | nenhum |
| 3 | Trabalho backend | Escolhe um template clínico calmo, gera uma apresentação por condição e idioma | GET /api/v1/themes/search (grátis), POST /api/v1/slides/generate (10 créditos/página) |
| 4 | Executor do trabalho + banco de dados de revisão | Consulta, baixa PPTX, armazena com jobId e versão da fonte, marca como pendente de revisão | GET /api/v1/jobs/{id} (grátis) |
| 5 | Mesmo trabalho, trilha de treinamento | Apresentação para treinamento de equipe com design de imagens, depois narração para vídeos de integração | create-pdf-slides (10 + 100/página até 2K), generate-narration (210/página) |
| 6 | Revisor clínico, publicador | Aprova ou rejeita, carimba a versão, publica no portal ou LMS | download-slides-pages-voices (ZIP grátis de PNG + WAV) |
Passo 1: Defina o limite de conformidade e mantenha a chave API no servidor
Antes de qualquer código, escreva o limite: que texto pode sair da sua rede como userInput. Para educação do paciente, isso é conteúdo aprovado, para público geral, descrevendo uma condição, um procedimento ou uma instrução. Nunca descreve um paciente específico. A HIPAA Privacy Rule, documentada em hhs.gov/hipaa, regula informações de saúde protegidas; seu oficial de privacidade decide como um serviço de geração terceirizado se encaixa nas suas políticas. Nada neste artigo substitui essa revisão.
Depois, obtenha uma chave API em 2slides.com/api. As chaves são emitidas na aba API Keys com 500 créditos grátis, suficientes para cerca de seis apresentações de teste de 8 páginas. A chave fica em um gerenciador de segredos ou variável de ambiente no servidor, nunca em navegador, app móvel ou notebook compartilhado.

Figura 1: Página de referência da API no 2slides.com, incluindo a nota de segurança que as chaves devem ficar no servidor.
Verifique a chave a partir do servidor que executará o trabalho:
curl -s https://2slides.com/api/v1/echo \
-H "Authorization: Bearer $SLIDES_API_KEY"Uma resposta autenticada significa que a credencial está no lugar e você pode prosseguir para o conteúdo.
Passo 2: Prepare conteúdo fonte aprovado e desidentificado com carimbo de versão
O trabalho de geração lê de um registro, não de uma janela de chat. Um registro fonte mínimo carrega o texto aprovado, uma versão e o órgão aprovador, para que qualquer apresentação possa ser rastreada até as palavras exatas de origem.
{
"slug": "heart-failure-discharge",
"title": "Indo para casa após internação por insuficiência cardíaca",
"version": "2026.09.1",
"approved_by": "Comitê de Educação Clínica",
"approved_on": "2026-09-03",
"reading_level": "6º ano",
"approved_text": "Insuficiência cardíaca significa que o coração não está bombeando tão bem quanto deveria. Depois que você for para casa: pese-se toda manhã... Ligue para sua equipe de cuidados se ganhar 3 libras em um dia ou 5 libras em uma semana..."
}Três regras mantêm este registro seguro para envio:
- Nunca PHI. Sem nomes, MRNs, datas de nascimento, datas de consultas ou qualquer coisa que descreva uma pessoa. Uma verificação regex para padrões de MRN e datas roda antes de cada envio, e uma falha bloqueia o trabalho.
- Apenas texto aprovado. O trabalho lê o campo
approved_textde um registro cujo status éapproved. Rascunhos são ignorados. - Fonte em linguagem simples. Fast PPT ajusta seu texto aos espaços reservados do template, então texto escrito no nível de leitura do 6º ano gera slides nesse nível.
Passo 3: Gere materiais multilíngues de educação do paciente com Fast PPT
Escolha o template uma vez. Busque um visual clínico calmo e armazene o themeId retornado como configuração:
curl -s "https://2slides.com/api/v1/themes/search?query=healthcare&limit=5" \
-H "Authorization: Bearer $SLIDES_API_KEY"Também experimente query=medical. Escolha alto contraste, tipografia grande e sem infográficos densos; apresentações para pacientes são lidas em celulares nas salas de espera e impressas na estação de enfermagem.
Depois gere uma apresentação por idioma. A fonte em inglês permanece a mesma; só muda responseLanguage. Use mode: "async" porque você está enviando vários trabalhos em lote.
curl -s -X POST https://2slides.com/api/v1/slides/generate \
-H "Authorization: Bearer $SLIDES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userInput": "Indo para casa após internação por insuficiência cardíaca. Insuficiência cardíaca significa que o coração não está bombeando tão bem quanto deveria. Depois que você for para casa: pese-se toda manhã antes do café. Tome seus remédios exatamente como listado na sua folha de medicamentos. Limite o sal à quantidade que sua equipe de cuidados indicou. Ligue para sua equipe se ganhar 3 libras em um dia ou 5 libras em uma semana, se estiver mais sem fôlego ou se suas pernas incharem. Versão da fonte 2026.09.1, revisado pelo Comitê de Educação Clínica.",
"themeId": "<themeId from themes/search>",
"responseLanguage": "Spanish",
"mode": "async"
}'A resposta é { "jobId": "..." }. Repita com "Vietnamese", "Arabic", "Simplified Chinese" e qualquer outro idioma da lista suportada. Passe o nome do idioma, não um código; "es" não funciona, "Spanish" funciona.

Figura 2: Documentação do endpoint generate mostrando responseLanguage e os mais de 20 idiomas de saída suportados.
Consulte a cada 5 a 10 segundos até o trabalho estar success ou failed:
curl -s https://2slides.com/api/v1/jobs/<jobId> \
-H "Authorization: Bearer $SLIDES_API_KEY"Um trabalho finalizado retorna um downloadUrl para o PPTX. O limite de requisições é 6 por minuto por chave em generate e 10 por minuto em jobs/{id}. Dez idiomas para uma condição significam dez envios espaçados por 10 segundos, e cada apresentação retorna em cerca de 30 segundos.
Passo 4: Construa a fila de revisão em Python (gerar, armazenar, aprovar)
O trabalho abaixo lê um registro fonte aprovado, gera uma apresentação por idioma, baixa cada PPTX e grava uma linha na tabela deck_reviews com status pending_review. Nada é publicado por este script. Um revisor, um clínico bilíngue ou tradutor médico certificado para versões não inglesas, chama approve() após checar o arquivo.
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",
}
# Escolhido uma vez via GET /api/v1/themes/search?query=healthcare, armazenado como config
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):
# Guarda mínima; estenda com seus próprios padrões e uma checagem humana a montante.
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("Texto fonte falhou na verificação de padrão 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 {job_id} falhou")
time.sleep(8) # consulta a cada 5 a 10 segundos
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("Apenas registros fonte aprovados podem ser gerados")
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) # fique abaixo de 6 requisições/min por chave
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))Duas escolhas de design importam. O caminho do arquivo e a linha do banco carregam a versão da fonte e o jobId, para que um revisor sempre possa responder "quais palavras produziram este slide?" E o script não tem passo de publicação: publicar lê apenas linhas onde status = 'approved'.
Passo 5: Produza apresentações de treinamento clínico com narração
Apresentações para pacientes seguem o caminho Fast PPT porque enfermeiros e educadores as editam no PowerPoint. Treinamento de equipe geralmente precisa de um vídeo que um novo funcionário possa assistir na integração, o que significa slides com design de imagem mais voz: a cadeia create-pdf-slides para generate-narration, com a mesma chave e o mesmo limite de conformidade.
Envie o texto do protocolo aprovado. page: 0 deixa o planejador escolher a contagem de slides; resolution: "2K" mantém o custo em 100 créditos por página.
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": "Treinamento: higiene das mãos e sequência de colocação e retirada de EPI para unidades de internação. Versão do protocolo aprovada 2026.09. <texto do protocolo aprovado aqui>",
"designStyle": "Apresentação de treinamento clínico calma, azul suave e branco, tipografia grande e legível, ícones simples de linha, sem fotografias de pacientes",
"aspectRatio": "16:9",
"resolution": "2K",
"page": 0,
"contentDetail": "standard",
"responseLanguage": "English"
}'Consulte jobs/{jobId} como antes. Quando a apresentação estiver success, solicite a narração para esse job:
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": "<jobId from create-pdf-slides>",
"mode": "single",
"speakerName": "Clinical Educator",
"voice": "Kore",
"contentMode": "standard",
"includeIntro": true
}'A narração é apenas assíncrona e custa 210 créditos por página. Quando terminar, POST /api/v1/slides/download-slides-pages-voices com { "jobId": "..." } retorna um ZIP gratuito com arquivos PNG e WAV por página que seu pipeline monta em MP4 com FFmpeg ou entrega ao LMS. Scripts de narração passam pelo mesmo revisor dos slides; uma dose errada no áudio ainda é uma dose errada. Para estruturar o conteúdo, veja como fazer uma apresentação de treinamento com IA; se o protocolo estiver em PDF, o fluxo PDF para slides cobre o resumo antes do envio.
Passo 6: Publique, carimbe a versão e audite sua automação de slides para educação do paciente
Publicar é uma consulta ao banco, não uma chamada de geração. O publicador escolhe linhas com status = 'approved', copia o PPTX (ou PDF exportado) para o portal do paciente, quiosque ou LMS, e imprime o carimbo da versão na página publicada: versão da fonte, data de aprovação, idioma. Quando o registro fonte muda para 2026.10.1, o trabalho regenera todos os idiomas, linhas antigas são marcadas como superseded e a fila de revisão se enche novamente.
A tabela deck_reviews é seu log de auditoria. Por apresentação responde o que a equipe de qualidade perguntará: qual versão da fonte, qual checksum, qual template, qual jobId, quem revisou e quando. Mantenha conforme sua política de registros exigir.
Escolhendo um estilo de referência
Se nenhum template Fast PPT combina com sua identidade visual, o caminho de design por imagem pode derivar um sistema de design a partir de uma referência. A Galeria 2Slides hospeda apresentações reais que você pode passar como referenceImageUrl para create-like-this, ou usar como inspiração para um prompt designStyle. São apresentações de referência, não saídas da API deste fluxo.

Figura 3: Slide de título da "The Future of Wellness 2025 Edition" da Galeria 2Slides, estilo suave e de baixo contraste para setor de saúde, adequado como referenceImageUrl.

Figura 4: Slide de conteúdo da mesma apresentação da Galeria, mostrando como uma paleta contida mantém a informação clínica legível.

Figura 5: Página de detalhe da Galeria, com pré-visualização slide a slide e download PPT/PDF; copie a URL da imagem de um slide aqui para usar como referência.
Para a maioria das equipes hospitalares, a melhor referência é seu próprio slide de marca aprovado: hospede-o em uma URL pública, passe como referenceImageUrl e toda apresentação de equipe herda esse sistema de design.
Quanto custa
Dois volumes mensais realistas. Apresentações para pacientes são arquivos Fast PPT de 8 páginas; apresentações de treinamento de equipe são de 10 páginas, design 2K com narração.
| Item | Créditos cada | Nível A: 20 apresentações para pacientes + 2 treinamentos narrados | Nível B: 500 apresentações para pacientes + 10 treinamentos narrados |
|---|---|---|---|
| Apresentação para paciente, 8 páginas, Fast PPT | 80 | 1.600 | 40.000 |
| Apresentação para equipe, 10 páginas, imagens 2K | 1.010 | 2.020 | 10.100 |
| Narração, 10 páginas | 2.100 | 4.200 | 21.000 |
| Total de créditos | 7.820 | 71.100 | |
| USD aproximado | US$ 19,55 a US$ 0,0025/crédito (cabe no pacote de 10.000 por US$ 22,50) | US$ 142,20 a US$ 0,002/crédito (pacotes de 40.000 por US$ 80) |
Nível A é uma biblioteca de 10 condições em 2 idiomas mais dois vídeos de treinamento por mês. Nível B é uma biblioteca de 50 condições em 10 idiomas mais dez vídeos, aproximadamente um sistema multi-site. Créditos são pay-as-you-go; o plano Pro opcional adiciona 10.000 créditos por mês, mas não é obrigatório para acesso à API.
Fast PPT ou slides com design por imagem para este caso?
| Necessidade | Use | Por quê |
|---|---|---|
| Folhetos para pacientes que enfermeiros editarão e imprimirão | generate (Fast PPT) | PPTX editável nativo, 10 créditos/página, cerca de 30 segundos por apresentação |
| Mesmo conteúdo em 10 idiomas | generate com responseLanguage | Uma fonte, uma alteração de parâmetro por idioma |
| Vídeo de integração para equipe | create-pdf-slides e depois generate-narration | Apenas trabalhos com design por imagem podem ser narrados; ZIP de PNG + WAV monta o MP4 |
| Apresentações que devem combinar com a marca hospitalar | create-like-this com referenceImageUrl | Deriva o sistema de design do seu slide aprovado |
Fast PPT não pode ser narrado. Uma apresentação para paciente que precisa de áudio para públicos com baixa alfabetização vai pelo caminho de design por imagem a 100 créditos por página mais 210 por página para narração, e retorna como PDF mais imagens em vez de PPTX editável.
Armadilhas comuns
- PHI entra por um campo secundário. Um parágrafo "exemplo de caso" numa diretriz pode conter dado real de paciente. Rode a verificação de padrão em todo campo concatenado em
userInpute mantenha uma etapa humana de desidentificação a montante. - Limite de taxa atingido durante um pico de regeneração.
generate,create-pdf-slidesegenerate-narrationpermitem 6 requisições por minuto por chave. Enfileire envios a cada 10 segundos; uma reconstrução de 50 condições por 10 idiomas são 500 trabalhos e cerca de 84 minutos de envios, adequado para um trabalho noturno. - Chave API no front-end ou notebook. Chaves ficam em variáveis de ambiente no servidor. Roteie a chave se ela aparecer em documento compartilhado.
- Tentando narrar um trabalho Fast PPT.
generate-narrationrejeita jobIds degenerate. Usecreate-pdf-slidesoucreate-like-thispara qualquer coisa que precise de voz. - Idioma passado como código.
responseLanguageaceita nomes como"Vietnamese"ou"Traditional Chinese". Códigos como"vi"falham. - Diretriz de 40 páginas colada inteira. Entradas longas produzem slides densos e confusos. Resuma para os 6 a 10 pontos para paciente primeiro, ou defina
page: 0no caminho de design por imagem e deixe o planejador escolher a quantidade.
Perguntas Frequentes
É seguro enviar conteúdo de educação do paciente para uma API de apresentação de IA?
É apropriado quando o conteúdo é aprovado, para público geral e não contém informações de saúde protegidas. Instruções de alta para "pacientes com insuficiência cardíaca" não carregam PHI; uma nota sobre paciente nomeado sim. Mantenha a checagem de PHI automatizada e a montante e envolva seu oficial de privacidade. O 2Slides não declara certificação HIPAA, e este artigo não é aconselhamento legal.
Em quais idiomas podem ser gerados materiais multilíngues de educação do paciente?
O 2Slides suporta mais de 20 idiomas de saída via responseLanguage, incluindo inglês, espanhol, árabe, português, vietnamita, chinês simplificado, chinês tradicional, hindi, coreano, russo, francês e alemão. Passe o nome do idioma, não um código ISO. Trate a saída como um rascunho inicial para revisão por clínico bilíngue ou tradutor médico certificado antes da publicação.
Apresentações para pacientes podem ser narradas assim como as de treinamento de equipe?
Sim, mas apenas no caminho de design por imagem. Gere a apresentação do paciente com create-pdf-slides (100 créditos por página em 2K) em vez de Fast PPT, depois chame generate-narration a 210 créditos por página. Um explicador narrado de 6 páginas custa 10 + 600 + 1.260 = 1.870 créditos, cerca de US$ 4,68. Trabalhos Fast PPT não podem ser narrados.
Como lidamos com uma atualização de diretriz em todos os idiomas?
Atualize a versão do registro fonte, marque as linhas antigas como superseded e reexecute o trabalho. Cada idioma recebe um novo jobId, um caminho de arquivo com a nova versão e uma nova linha pending_review. O carimbo publicado muda só quando um revisor aprova, então pacientes nunca veem atualização sem revisão, e o log de auditoria mostra quando cada idioma mudou.
Como isso se compara com outras APIs para gerador de apresentações médicas?
A API da Gamma, documentada em developers.gamma.app, oferece automação similar, mas requer plano Pro para emitir chaves API, enquanto chaves 2Slides funcionam em qualquer conta, inclusive gratuita com 500 créditos. Isso torna possível um piloto de TI hospitalar antes de qualquer compra. Ambas são serviços de terceiros, então as mesmas regras de desidentificação se aplicam, e esta comparação foi escrita pela equipe 2Slides.
Próximos passos
Automação de slides para educação do paciente é principalmente um exercício de governança com pouco código: um registro fonte aprovado, um trabalho que gera uma apresentação por idioma e uma fila de revisão que controla a publicação.
- Obtenha uma chave API em 2slides.com/api; os 500 créditos grátis cobrem cerca de seis apresentações de teste de 8 páginas.
- Navegue pelas outras receitas por equipe no post central, Casos de uso da API de apresentação de IA por equipe.
- Leitura relacionada: Apresentações de IA para saúde e slides médicos para o fluxo manual que este trabalho substitui, e vídeos corporativos de treinamento com narração por IA para o lado de produção das apresentações narradas de treinamento.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free