Skip to main content

L'API Felo PPT ora esporta veri file PPTX

· 8 minuti di lettura
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

L'API Task PPT di Felo OpenAPI ora esporta i deck generati come file .pptx modificabili. Una chiave API, un flusso asincrono in quattro passaggi e un link per il download.

Il tuo agente può ricercare un argomento, costruire una scaletta e generare un deck di slide finito senza usare uno strumento di design. L'unica cosa che non poteva fare era consegnarti un file che il tuo team potesse aprire in PowerPoint.

Ora quel limite non esiste più. Felo OpenAPI esporta i deck generati come veri file .pptx. L'API Task PPT produceva già slide modificabili all'interno di Felo; i nuovi endpoint di esportazione li trasformano in un file PowerPoint che puoi scaricare, modificare e condividere. Stessa chiave API, stesso schema asincrono, una chiamata in più.

Provalo ora: https://openapi.felo.ai/docs/api-reference/ppt-tasks

L'API Task PPT di Felo ora esporta veri file .pptx: dalla ricerca al deck in un unico flusso, POST /v2/ppts/{id}/export, download_url valido 30 minuti

Cosa è cambiato​

Prima di questo aggiornamento, l'API Task PPT si fermava a un URL di slide Felo. Ricevevi un deck, ma il passaggio si interrompeva lì: per mostrarlo a un cliente, una classe o un consiglio, qualcuno doveva ricostruirlo manualmente in PowerPoint.

Ora il flusso si completa. Quando un task di generazione PPT raggiunge COMPLETED, chiami un endpoint di esportazione e ne interroghi un secondo. L'API restituisce un download_url firmato che punta a un vero file .pptx — lo stesso deck, nel formato che tutti già usano.

Due aspetti rendono questa funzione più di una semplice conversione di formato:

  • Il deck è modificabile. Non un PDF, non un set di immagini piatte. Testo, layout e struttura del tema rimangono in PowerPoint, così un collega può correggere un numero o riordinare una sezione senza rigenerare nulla.
  • La ricerca è già svolta. La generazione PPT di Felo non si limita a inserire il prompt sulle slide. Ricerca l'argomento, raccoglie fonti, struttura l'argomentazione e applica un tema. Ricevi un deck pronto per la presentazione, non una bozza da riscrivere.

Questa combinazione è il punto centrale. La maggior parte degli strumenti ricerca bene e consegna testo, oppure formatta bene e consegna una struttura vuota. Felo fa entrambe le cose e ora spedisce il risultato come file.

Come funziona l'esportazione​

L'esportazione è asincrona, in linea con il resto dell'API Task PPT. Invia un job, interroghi finché non termina e scarichi il risultato.

Passaggio 1 — Genera il deck​

Crea un task PPT con un prompt. Se vuoi un aspetto specifico, elenca prima i temi disponibili e passa l'ID del tema.

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

La risposta restituisce un task_id e un ppt_business_id. Conserva entrambi — ti servono il task ID per interrogare la generazione e il business ID per esportare.

Passaggio 2 — Interroga finché il deck è pronto​

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY

Interroga ogni 2–5 secondi. Quando task_status indica COMPLETED, il deck esiste e puoi esportarlo. Un ppt_url viene restituito insieme se vuoi visualizzare le slide in Felo prima.

Passaggio 3 — Invia l'esportazione​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

Questo è tutto il corpo della richiesta: {}. L'esportazione viene eseguita come job in background.

Passaggio 4 — Interroga l'esportazione e scarica​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

Interroga ogni 2–5 secondi. data.status passa da NOT_STARTED, PROCESSING a COMPLETED. Solo COMPLETED contiene il payload che ti serve:

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

Scarica il file da download_url e hai finito.

Flusso di esportazione PPTX: POST /v2/ppts crea il deck, GET /v2/tasks/{task_id}/historical interroga finché COMPLETED, POST /v2/ppts/{id}/export avvia l'esportazione, GET /v2/ppts/{id}/export restituisce download_url valido 30 minuti

Quattro dettagli utili prima di spedire​

Il download URL scade 30 minuti dopo la generazione. Si tratta di un URL firmato, non di un link permanente. Se scade, richiama l'endpoint GET di esportazione — questo genera un nuovo URL senza rigenerare il PPTX, quindi non ha costi.

Ripetere l'esportazione dopo il completamento consuma un credito. Ripetere il POST mentre un'esportazione è ancora in corso è sicuro e non avvia un secondo job. Ma chiamare POST di nuovo dopo che l'esportazione è terminata rigenera il file e applica il costo di credito per esportazione PPT. Se serve solo un nuovo link, usa GET.

La chiave API deve possedere il deck. L'esportazione è limitata alla chiave che ha creato il PPT. Una chiave che non ha generato il deck non può esportarlo, così i deck rimangono nell'account che li ha creati.

I fallimenti possono essere ritentati. Un'esportazione FAILED può essere inviata di nuovo con lo stesso POST. Crediti insufficienti restituiscono HTTP 402; i limiti di rate restituiscono HTTP 429 e conviene ritentare dopo una breve attesa.

Perché è importante per gli agenti​

La parte interessante non è il formato del file. È ciò che sblocca una pipeline completa dalla ricerca al file.

Un agente che può ricercare ed esportare ora gestisce l'intero ciclo senza supervisione:

  • Revisioni settimanali di business — raccoglie i dati della settimana, ricerca il contesto dietro i numeri, genera il deck, lo esporta e inserisce il .pptx nel drive condiviso prima della riunione del lunedì.
  • Consegne ai clienti — trasforma un brief in un deck con fonti e tema, consegna un file modificabile che il cliente può personalizzare.
  • Materiale per la forza vendita — genera un deck su misura per ogni potenziale cliente dalla ricerca sull'account, esporta ciascuno e lo allega automaticamente al record CRM.
  • Materiale didattico e formativo — ricerca un argomento, lo struttura come lezione, esporta slide che un docente può modificare prima della lezione.

In ogni caso il compito umano si riduce a revisione e rifinitura. Nessuno parte da una slide vuota.

Se preferisci non scrivere tu il ciclo di polling, la Skill PPT di Felo lo gestisce. Installa il pacchetto agente Felo AI e il tuo agente acquisisce la capacità di creare, interrogare ed esportare deck come funzione unica — lo stesso flusso descritto sopra, incapsulato così l'agente può chiamarlo direttamente.

Per iniziare​

L'esportazione è attiva sull'API Task PPT, disponibile per ogni chiave Felo OpenAPI.

  1. Recupera la tua chiave API dalla dashboard Felo OpenAPI.
  2. Leggi la documentazione API Task PPT — la sezione Export PPTX mostra le richieste e risposte esatte.
  3. Genera un deck, esportalo e apri il file in PowerPoint.

Se vuoi il percorso rapido, installa la Skill PPT di Felo e lascia che il tuo agente gestisca l'intero flusso.

Inizia a costruire con Felo OpenAPI: https://openapi.felo.ai

Domande frequenti​

Il file esportato è davvero modificabile in PowerPoint? Sì. L'esportazione produce un file .pptx standard. Testo, layout e struttura del tema vengono trasferiti, così il deck può essere modificato in PowerPoint, Google Slides o Keynote.

L'esportazione ha un costo aggiuntivo? Inviare un'esportazione dopo che il deck è generato usa il credito di esportazione PPT esistente. Crediti insufficienti restituiscono HTTP 402. Recuperare un nuovo link di download con GET non rigenera il file e non aggiunge costi.

Quanto dura il link di download? 30 minuti dalla generazione. Richiama l'endpoint GET di esportazione per un nuovo link.

Posso esportare un deck creato con una chiave API diversa? No. La chiave API che invia la richiesta di esportazione deve possedere il PPT.

Cosa succede se l'esportazione fallisce? data.status restituisce FAILED. Invia di nuovo la richiesta POST di esportazione per ritentare.

Questo articolo è disponibile anche in English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, ไทย, Español, বাংলা and Português.