Stato generazione Felo

Genera una presentazione in modo asincrono, poi esporta un file PPTX. Mantieni separati i passaggi di generazione ed esportazione: un task creato non è ancora un file completato.

Tutti gli esempi usano FELO_API_KEY dalla panoramica. Le chiamate usano il saldo della piattaforma, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.

Usa gli identificatori restituiti quando crei il task. Imposta TASK_ID su task_id e PPT_ID su ppt_business_id; anche {business_id} significa ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

2. Interroga lo stato della generazione

GET /api/v1/data/tasks/{task_id}/status

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/status" \
  -H "Authorization: Bearer $FELO_API_KEY"

La risposta ha una stringa status alla radice, ad esempio RUNNING o COMPLETED. Interroga con un intervallo limitato (ad esempio 2–5 secondi) e una scadenza. Continua ai risultati dopo il completamento; gestisci fallimenti e stati inattesi senza presumere il successo. Una scadenza di polling non annulla il task.

{"status":"COMPLETED"}

Durata, proprietà e fatturazione

• Le presentazioni scadono sette giorni dopo la creazione. Le query e le esportazioni non estendono questo periodo. L'expires_at della presentazione e l'expires_at dell'URL di download firmato descrivono durate diverse.
• Solo l'account API che ha creato la presentazione può accedere ai propri task e presentazioni. Una risorsa mancante o non accessibile può restituire 404; una risorsa scaduta o eliminata può restituire 410, oppure 404 dopo la pulizia.
• La generazione è fatturata per pagina generata (ppt.generate). Con la tariffazione per pagina, la creazione riserva il prezzo di dieci pagine, poi effettua il saldo dell'output effettivamente riuscito e libera la riserva inutilizzata. Il tuo account deve avere saldo disponibile sufficiente per la riserva anche se il prompt richiede meno pagine.
• L'esportazione ha un prezzo separato per richiesta (ppt.export). Le query di stato, le query di risultato, le query di stato esportazione e l'eliminazione non creano nuovi addebiti.
• Dopo un timeout, interroga il task salvato invece di creare un'altra presentazione. Vedi Fatturazione ed errori.