# Stato generazione Felo

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

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](https://openapi.felo.ai/it/docs/data-api/guides/felo-overview.md). 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`.

```bash
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`

```bash
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.

```json
{"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](https://openapi.felo.ai/it/docs/data-api/guides/felo-billing.md).