2Slides Logo
Automazione delle Slide per l'Educazione del Paziente con un'API Sanitaria (2026)
2Slides Team
18 min read

Automazione delle Diapositive per l’Educazione del Paziente con un’API Sanitaria (2026)

L’automazione delle diapositive per l’educazione del paziente significa che un processo backend legge il testo sorgente approvato e de-identificato (istruzioni di dimissione, spiegazioni di procedure, linee guida cliniche) dal tuo repository di contenuti e lo trasforma in presentazioni tramite l’API 2Slides. Fast PPT generate produce un PPTX modificabile per condizione e per lingua a 10 crediti per pagina, quindi una presentazione di 8 pagine costa 80 crediti, circa $0,20. create-pdf-slides più generate-narration producono presentazioni narrate per la formazione del personale. È pensato per team di educazione ospedaliera, aziende di salute digitale e agenzie di comunicazione medica.

Punti chiave

  • Un documento sorgente approvato diventa una presentazione per ogni lingua cambiando un solo valore responseLanguage; 2Slides supporta oltre 20 lingue tra cui spagnolo, vietnamita e arabo.
  • Una presentazione paziente Fast PPT di 8 pagine costa 80 crediti, circa $0,20 con il pacchetto starter da $5; 500 presentazioni al mese sono 40.000 crediti, esattamente il pacchetto da $80.
  • Una presentazione di formazione del personale narrata di 10 pagine costa 1.010 crediti per le diapositive con immagini più 2.100 crediti per la narrazione, circa $7,78 in totale.
  • Solo testo approvato e de-identificato va in userInput: niente nomi di pazienti, MRN o date di nascita. Ogni jobId, versione sorgente e decisione del revisore viene scritta in una tabella di audit.
  • 2Slides non dichiara certificazioni HIPAA e questo articolo non è consulenza legale; i controlli di conformità qui sono a carico tuo da implementare e documentare.

A chi è rivolto

Gestisci l’educazione del paziente in un sistema ospedaliero, possiedi i contenuti in un’azienda di salute digitale o produci materiali in un’agenzia di comunicazione medica. Il problema è lo stesso: una linea guida cambia e 40 presentazioni specifiche per condizione in 6 lingue diventano obsolete mentre chi potrebbe aggiornarle è impegnato nelle cliniche. Un processo backend che rigenera le presentazioni dal testo sorgente approvato e le invia a un revisore clinico elimina la ricostruzione manuale senza eliminare la revisione.

Non usare questa ricetta se il testo sorgente non è ancora approvato o se qualcosa di specifico del paziente dovrebbe entrare in un prompt. Pubblica contenuti controllati su larga scala; non genera piani di cura individualizzati.

Il flusso di lavoro in sintesi

PassoStrumentoCosa succedeEndpoint 2Slides / crediti
1Gestore segreti, servizio backendConserva la chiave API lato server, definisci quale testo può entrare in un promptGET /api/v1/echo (controllo autenticazione gratuito)
2Repository contenuti (Git, CMS, DAM)Testo sorgente approvato e de-identificato con timbro versione e checksumnessuno
3Job backendScegli un template clinico sobrio, genera una presentazione per condizione e linguaGET /api/v1/themes/search (gratuito), POST /api/v1/slides/generate (10 crediti/pagina)
4Job runner + database revisionePoll, scarica PPTX, salva con jobId e versione sorgente, marca come in attesa di revisioneGET /api/v1/jobs/{id} (gratuito)
5Stesso job, percorso formazionePresentazione di formazione con immagini, poi narrazione per video onboardingcreate-pdf-slides (10 + 100/pagina a 2K), generate-narration (210/pagina)
6Revisore clinico, publisherApprova o rifiuta, timbra versione, pubblica su portale o LMSdownload-slides-pages-voices (ZIP gratuito di PNG + WAV)

Passo 1: Definisci il confine di conformità e conserva la chiave API lato server

Prima di qualsiasi codice, definisci il confine: quale testo può uscire dalla tua rete come userInput. Per l’educazione del paziente, è contenuto approvato, destinato a un pubblico generale, che descrive una condizione, una procedura o un’istruzione. Non descrive mai un paziente specifico. La HIPAA Privacy Rule, documentata su hhs.gov/hipaa, regola le informazioni sanitarie protette; il tuo responsabile privacy decide come un servizio di generazione di terze parti si inserisce nelle tue politiche. Nulla in questo articolo sostituisce quella revisione.

Poi ottieni una chiave API su 2slides.com/api. Le chiavi si ottengono nella scheda API Keys con 500 crediti gratuiti, sufficienti per circa sei presentazioni di prova da 8 pagine. La chiave vive in un gestore segreti o in una variabile d’ambiente lato server, mai in un browser, app mobile o notebook condiviso.

Riferimento API 2Slides con nota di sicurezza per mantenere le chiavi API lato server

Figura 1: La pagina di riferimento API su 2slides.com, inclusa la nota di sicurezza che le chiavi devono restare lato server.

Verifica la chiave dal server che eseguirà il job:

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

Una risposta autenticata significa che la credenziale è a posto e puoi passare al contenuto.

Passo 2: Prepara contenuti sorgente approvati e de-identificati con timbro versione

Il job di generazione legge da un record, non da una finestra chat. Un record sorgente minimo contiene il testo approvato, una versione e l’ente che ha approvato, così ogni presentazione può essere tracciata alle parole esatte da cui è stata costruita.

{ "slug": "heart-failure-discharge", "title": "Ritorno a casa dopo un ricovero per insufficienza cardiaca", "version": "2026.09.1", "approved_by": "Comitato Educazione Clinica", "approved_on": "2026-09-03", "reading_level": "Classe 6", "approved_text": "L’insufficienza cardiaca significa che il cuore non pompa bene come dovrebbe. Dopo il ritorno a casa: pesati ogni mattina... Chiama il tuo team di cura se aumenti 3 libbre in un giorno o 5 libbre in una settimana..." }

Tre regole mantengono questo record sicuro da inviare:

  • Mai PHI. Niente nomi, MRN, date di nascita, date di appuntamenti o qualsiasi cosa descriva una persona. Un controllo regex per MRN e pattern di date viene eseguito prima di ogni invio, e un controllo fallito blocca il job.
  • Solo testo approvato. Il job legge il campo approved_text di un record con stato approved. Le bozze sono ignorate.
  • Testo in linguaggio semplice. Fast PPT adatta il tuo testo ai segnaposto del template, quindi un testo scritto a livello di lettura di classe 6 produce diapositive a quel livello.

Passo 3: Genera materiali educativi multilingue con Fast PPT

Scegli il template una volta sola. Cerca un aspetto clinico sobrio e memorizza il themeId restituito come configurazione:

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

Prova anche query=medical. Scegli alto contrasto, caratteri grandi e niente infografiche dense; le presentazioni paziente si leggono su telefoni in sala d’attesa e si stampano alla postazione infermieristica.

Poi genera una presentazione per ogni lingua. Il testo inglese resta lo stesso; cambia solo responseLanguage. Usa mode: "async" perché stai inviando più job in batch.

curl -s -X POST https://2slides.com/api/v1/slides/generate \ -H "Authorization: Bearer $SLIDES_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "userInput": "Ritorno a casa dopo un ricovero per insufficienza cardiaca. L’insufficienza cardiaca significa che il cuore non pompa bene come dovrebbe. Dopo il ritorno a casa: pesati ogni mattina prima di colazione. Prendi i tuoi farmaci esattamente come indicato nel foglio dei medicinali. Limita il sale alla quantità indicata dal tuo team di cura. Chiama il tuo team se aumenti 3 libbre in un giorno o 5 libbre in una settimana, se hai più difficoltà a respirare o se le gambe si gonfiano. Versione sorgente 2026.09.1, revisionata dal Comitato Educazione Clinica.", "themeId": "<themeId da themes/search>", "responseLanguage": "Spanish", "mode": "async" }'

La risposta è { "jobId": "..." }. Ripeti con "Vietnamese", "Arabic", "Simplified Chinese" e qualsiasi altra lingua supportata. Passa il nome della lingua, non un codice; "es" non funziona, "Spanish" sì.

Endpoint generate di 2Slides con responseLanguage e le 20+ lingue supportate per materiali paziente

Figura 2: Documentazione dell’endpoint generate che mostra responseLanguage e le oltre 20 lingue di output supportate.

Fai polling ogni 5-10 secondi finché il job è success o failed:

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

Un job terminato restituisce un downloadUrl per il PPTX. Il limite di richieste è 6 al minuto per chiave su generate e 10 al minuto su jobs/{id}. Dieci lingue per una condizione significano dieci invii distanziati di 10 secondi, e ogni presentazione torna in circa 30 secondi.

Passo 4: Costruisci la coda di revisione in Python (genera, salva, approva)

Il job qui sotto legge un record sorgente approvato, genera una presentazione per lingua, scarica ogni PPTX e scrive una riga nella tabella deck_reviews con stato pending_review. Nulla viene pubblicato da questo script. Un revisore, un clinico bilingue o traduttore medico certificato per le versioni non inglesi, chiama approve() dopo aver controllato il file.

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", } # Scelto una volta da GET /api/v1/themes/search?query=healthcare, salvato come 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): # Controllo minimo; estendi con i tuoi pattern e un controllo umano a monte. 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("Il testo sorgente non ha superato il controllo 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} fallito") time.sleep(8) # polling ogni 5-10 secondi 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("Solo record sorgente approvati possono essere generati") 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) # sotto 6 richieste/min per chiave 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))

Due scelte progettuali sono importanti. Il percorso file e la riga del database contengono versione sorgente e jobId, così un revisore può sempre rispondere “quali parole hanno prodotto questa diapositiva?” E lo script non ha passaggi di pubblicazione: la pubblicazione legge solo righe con status = 'approved'.

Passo 5: Produci presentazioni di formazione clinica con narrazione

Le presentazioni paziente restano nel percorso Fast PPT perché infermieri ed educatori le modificano in PowerPoint. La formazione del personale richiede di solito un video che un nuovo assunto può guardare durante l’onboarding, quindi immagini più voce: la catena create-pdf-slides a generate-narration, con la stessa chiave e lo stesso confine di conformità.

Invia il testo del protocollo approvato. page: 0 lascia scegliere il numero di diapositive al planner; resolution: "2K" mantiene il costo a 100 crediti per pagina.

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": "In-service: sequenza di igiene delle mani e indossamento e rimozione DPI per reparti ospedalieri. Versione protocollo approvata 2026.09. <testo protocollo approvato qui>", "designStyle": "Presentazione di formazione clinica sobria, blu e bianco morbidi, caratteri grandi leggibili, icone lineari semplici, nessuna fotografia di pazienti", "aspectRatio": "16:9", "resolution": "2K", "page": 0, "contentDetail": "standard", "responseLanguage": "English" }'

Fai polling su jobs/{jobId} come prima. Quando la presentazione è success, richiedi la narrazione per quel 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 da create-pdf-slides>", "mode": "single", "speakerName": "Clinical Educator", "voice": "Kore", "contentMode": "standard", "includeIntro": true }'

La narrazione è solo async e costa 210 crediti per pagina. Quando finisce, POST /api/v1/slides/download-slides-pages-voices con { "jobId": "..." } restituisce uno ZIP gratuito di file PNG e WAV per pagina che la tua pipeline unisce in un MP4 con FFmpeg o passa al tuo LMS. Gli script di narrazione passano dallo stesso revisore delle diapositive; una dose sbagliata in audio è sempre una dose sbagliata. Per strutturare il contenuto, vedi come fare una presentazione di formazione con AI; se il protocollo è un PDF, il flusso PDF to slides copre il riassunto prima dell’invio.

Passo 6: Pubblica, timbra versione e audita l’automazione delle diapositive per l’educazione del paziente

La pubblicazione è una query al database, non una chiamata di generazione. Il publisher sceglie righe con status = 'approved', copia il PPTX (o un PDF esportato) sul portale paziente, chiosco o LMS, e stampa il timbro versione sulla pagina pubblicata: versione sorgente, data approvazione, lingua. Quando il record sorgente cambia in 2026.10.1, il job rigenera ogni lingua, le righe vecchie sono marcate superseded e la coda revisione si riempie di nuovo.

La tabella deck_reviews è il tuo registro di audit. Per ogni presentazione risponde a cosa chiederà un team di qualità: quale versione sorgente, quale checksum, quale template, quale jobId, chi ha revisionato e quando. Conservala finché la tua policy lo richiede.

Scegliere uno stile di riferimento

Se nessun template Fast PPT corrisponde alla tua identità visiva, il percorso con immagini può derivare un sistema di design da un riferimento. La 2Slides Gallery ospita presentazioni reali che puoi passare come referenceImageUrl a create-like-this, o usare come ispirazione per un prompt designStyle. Sono presentazioni di riferimento, non output API di questo flusso.

The Future of Wellness 2025 reference deck from the 2Slides Gallery, a calm health-sector visual style

Figura 3: Diapositiva titolo di "The Future of Wellness 2025 Edition" dalla 2Slides Gallery, uno stile morbido e a basso contrasto per il settore sanitario adatto come referenceImageUrl.

The Future of Wellness 2025 reference deck from the 2Slides Gallery, a calm health-sector visual style

Figura 4: Una diapositiva di contenuto dalla stessa presentazione Gallery, che mostra come una palette contenuta mantenga leggibili le informazioni cliniche.

2Slides Gallery detail page for a health-sector deck with slide-by-slide preview and PPT/PDF download

Figura 5: Pagina dettaglio della Gallery, con anteprima diapositiva per diapositiva e download PPT/PDF; copia qui un URL immagine diapositiva da usare come riferimento.

Per la maggior parte dei team ospedalieri il miglior riferimento è la tua diapositiva brand approvata: ospitala a un URL pubblico, passala come referenceImageUrl e ogni presentazione del personale eredita quel sistema di design.

Quanto costa

Due volumi mensili realistici. Le presentazioni paziente sono file Fast PPT di 8 pagine; le presentazioni di formazione personale sono di 10 pagine con immagini 2K e narrazione.

VoceCrediti ciascunoTier A: 20 presentazioni paziente + 2 presentazioni formazione narrateTier B: 500 presentazioni paziente + 10 presentazioni formazione narrate
Presentazione paziente, 8 pagine, Fast PPT801.60040.000
Presentazione personale, 10 pagine, immagini 2K1.0102.02010.100
Narrazione, 10 pagine2.1004.20021.000
Totale crediti7.82071.100
Circa USD$19,55 a $0,0025/credito (pacchetto da 10.000 a $22,50)$142,20 a $0,002/credito (pacchetti da 40.000 a $80)

Tier A è una libreria di 10 condizioni in 2 lingue più due video in-service al mese. Tier B è una libreria di 50 condizioni in 10 lingue più dieci video, più o meno un sistema multisito. I crediti sono pay-as-you-go; il piano Pro opzionale aggiunge 10.000 crediti al mese ma non è necessario per l’accesso API.

Fast PPT o diapositive con immagini per questo caso d’uso?

EsigenzaUsaPerché
Materiali per pazienti che gli infermieri modificheranno e stamperannogenerate (Fast PPT)PPTX nativo modificabile, 10 crediti/pagina, circa 30 secondi per presentazione
Stesso contenuto in 10 linguegenerate con responseLanguageUna sorgente, un cambio parametro per lingua
Video di onboarding per il personalecreate-pdf-slides poi generate-narrationSolo i job con immagini possono essere narrati; ZIP di PNG + WAV costruisce l’MP4
Presentazioni che devono rispettare l’immagine di marca ospedalieracreate-like-this con referenceImageUrlDeriva il sistema di design dalla diapositiva approvata

Fast PPT non può essere narrato. Una presentazione paziente che necessita audio per utenti con bassa alfabetizzazione segue il percorso con immagini a 100 crediti per pagina più 210 per pagina per la narrazione, e torna come PDF più immagini invece che PPTX modificabile.

Errori comuni

  • PHI che entra da un campo secondario. Un paragrafo “caso clinico” in una linea guida può contenere un dettaglio reale di un paziente. Esegui il controllo pattern su ogni campo che concateni in userInput e mantieni un passaggio umano di de-identificazione a monte.
  • Limite di richieste superato durante un picco di rigenerazione. generate, create-pdf-slides e generate-narration consentono 6 richieste al minuto per chiave. Invia i job distanziati di 10 secondi; una ricostruzione 50 condizioni per 10 lingue sono 500 job e circa 84 minuti di invii, adatto a un job notturno.
  • Chiave API in front-end o notebook. Le chiavi restano in variabili d’ambiente lato server. Ruota la chiave se appare in un documento condiviso.
  • Tentare di narrare un job Fast PPT. generate-narration rifiuta jobId da generate. Usa create-pdf-slides o create-like-this per tutto ciò che richiede voce.
  • Lingua passata come codice. responseLanguage prende un nome come "Vietnamese" o "Traditional Chinese". Codici come "vi" falliscono.
  • Incollare una linea guida di 40 pagine intera. Input lunghi producono diapositive dense e affollate. Riassumi prima ai 6-10 punti per pazienti, o imposta page: 0 nel percorso con immagini e lascia scegliere il numero al planner.

Domande Frequenti

È sicuro inviare contenuti di educazione del paziente a un’API di presentazioni AI?

È appropriato quando il contenuto è approvato, destinato a un pubblico generale e non contiene informazioni sanitarie protette. Le istruzioni di dimissione per “pazienti con insufficienza cardiaca” non contengono PHI; una nota su un paziente nominato sì. Mantieni il controllo PHI automatizzato e a monte e coinvolgi il tuo responsabile privacy. 2Slides non dichiara certificazioni HIPAA e questo articolo non è consulenza legale.

In quali lingue possono essere generate le presentazioni educative multilingue?

2Slides supporta oltre 20 lingue di output tramite responseLanguage, inclusi inglese, spagnolo, arabo, portoghese, vietnamita, cinese semplificato, cinese tradizionale, hindi, coreano, russo, francese e tedesco. Passa il nome della lingua, non un codice ISO. Considera l’output come una prima bozza da far revisionare a un clinico bilingue o traduttore medico certificato prima della pubblicazione.

Le presentazioni per pazienti possono essere narrate come quelle per la formazione del personale?

Sì, ma solo nel percorso con immagini. Genera la presentazione paziente con create-pdf-slides (100 crediti per pagina a 2K) invece di Fast PPT, poi chiama generate-narration a 210 crediti per pagina. Un explainer narrato di 6 pagine costa 10 + 600 + 1.260 = 1.870 crediti, circa $4,68. I job Fast PPT non possono essere narrati.

Come gestiamo un aggiornamento di linea guida in tutte le lingue?

Aggiorna la versione del record sorgente, marca le righe vecchie come superseded e rilancia il job. Ogni lingua riceve un nuovo jobId, un percorso file con la nuova versione e una nuova riga pending_review. Il timbro pubblicato cambia solo quando un revisore approva, così i pazienti non vedono mai un aggiornamento non revisionato, e il registro audit mostra quando ogni lingua è stata aggiornata.

Come si confronta con altre API per generatori di presentazioni mediche?

L’API di Gamma, documentata su developers.gamma.app, offre automazione simile ma richiede un piano Pro per ottenere chiavi API, mentre le chiavi 2Slides funzionano su qualsiasi account, incluso il livello gratuito con 500 crediti. Questo rende possibile un pilot IT ospedaliero prima di qualsiasi acquisto. Entrambi sono servizi di terze parti, quindi valgono le stesse regole di de-identificazione, e questo confronto è scritto dal team 2Slides.

Prossimi passi

L’automazione delle diapositive per l’educazione del paziente è soprattutto un esercizio di governance con poco codice: un record sorgente approvato, un job che genera una presentazione per lingua e una coda di revisione che regola la pubblicazione.

About 2Slides

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

Try For Free