2Slides Logo
Automação de Slides para Educação do Paciente com API de Saúde (2026)
2Slides Team
18 min read

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

PassoFerramentaO que aconteceEndpoint 2Slides / créditos
1Gerenciador de segredos, serviço backendArmazena a chave API no servidor, define que texto pode entrar no promptGET /api/v1/echo (verificação de autenticação gratuita)
2Repositório de conteúdo (Git, CMS, DAM)Texto fonte aprovado e desidentificado com carimbo de versão e checksumnenhum
3Trabalho backendEscolhe um template clínico calmo, gera uma apresentação por condição e idiomaGET /api/v1/themes/search (grátis), POST /api/v1/slides/generate (10 créditos/página)
4Executor do trabalho + banco de dados de revisãoConsulta, baixa PPTX, armazena com jobId e versão da fonte, marca como pendente de revisãoGET /api/v1/jobs/{id} (grátis)
5Mesmo trabalho, trilha de treinamentoApresentação para treinamento de equipe com design de imagens, depois narração para vídeos de integraçãocreate-pdf-slides (10 + 100/página até 2K), generate-narration (210/página)
6Revisor clínico, publicadorAprova ou rejeita, carimba a versão, publica no portal ou LMSdownload-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.

Referência da API 2Slides com a nota de segurança para manter as chaves API no servidor

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_text de 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.

Endpoint generate do 2Slides com responseLanguage e os 20+ idiomas suportados para materiais de paciente

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.

Apresentação de referência The Future of Wellness 2025 da Galeria 2Slides, estilo visual calmo para setor de saúde

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.

Apresentação de referência The Future of Wellness 2025 da Galeria 2Slides, estilo visual calmo para setor de saúde

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.

Página de detalhe da Galeria 2Slides para uma apresentação do setor de saúde com pré-visualização slide a slide e download PPT/PDF

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.

ItemCréditos cadaNível A: 20 apresentações para pacientes + 2 treinamentos narradosNível B: 500 apresentações para pacientes + 10 treinamentos narrados
Apresentação para paciente, 8 páginas, Fast PPT801.60040.000
Apresentação para equipe, 10 páginas, imagens 2K1.0102.02010.100
Narração, 10 páginas2.1004.20021.000
Total de créditos7.82071.100
USD aproximadoUS$ 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?

NecessidadeUsePor quê
Folhetos para pacientes que enfermeiros editarão e imprimirãogenerate (Fast PPT)PPTX editável nativo, 10 créditos/página, cerca de 30 segundos por apresentação
Mesmo conteúdo em 10 idiomasgenerate com responseLanguageUma fonte, uma alteração de parâmetro por idioma
Vídeo de integração para equipecreate-pdf-slides e depois generate-narrationApenas trabalhos com design por imagem podem ser narrados; ZIP de PNG + WAV monta o MP4
Apresentações que devem combinar com a marca hospitalarcreate-like-this com referenceImageUrlDeriva 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 userInput e mantenha uma etapa humana de desidentificação a montante.
  • Limite de taxa atingido durante um pico de regeneração. generate, create-pdf-slides e generate-narration permitem 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-narration rejeita jobIds de generate. Use create-pdf-slides ou create-like-this para qualquer coisa que precise de voz.
  • Idioma passado como código. responseLanguage aceita 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: 0 no 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.

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free