# Felo Resultados da Geração

POST /api/v1/data/tasks/{task_id}/historical

Gere uma apresentação de forma assíncrona e depois exporte um arquivo PPTX. Mantenha as etapas de geração e exportação separadas: uma tarefa criada ainda não é um arquivo concluído.

Todos os exemplos usam `FELO_API_KEY` a partir da [visão geral](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-overview.md). As chamadas usam **saldo da plataforma**, não créditos Pro da Felo. Os exemplos de resposta são ilustrativos; o conteúdo ao vivo e os campos opcionais variam.



Use os identificadores retornados ao criar a tarefa. Defina `TASK_ID` como `task_id` e `PPT_ID` como `ppt_business_id`; `{business_id}` também significa `ppt_business_id`.

```bash
TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"
```



## 3. Leia os resultados da geração

`POST /api/v1/data/tasks/{task_id}/historical`

Este é um **POST**, sem necessidade de corpo JSON.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/historical" \
  -H "Authorization: Bearer $FELO_API_KEY"
```

```json
{
  "task_id":"example-task-id",
  "task_status":"COMPLETED",
  "history_data":{},
  "error_message":null
}
```

Leia `task_status` antes de usar `history_data`. A carga do histórico pode variar conforme a tarefa e pode ser nula. `ai_page_html` e `thread_short_id` são opcionais. Esta resposta não é uma URL garantida para download do PPTX; use a exportação em seguida.



## Vida útil, propriedade e cobrança

- As apresentações expiram **sete dias após a criação**. Consultas e exportações não estendem esse período. O `expires_at` da apresentação e o `expires_at` da URL assinada de download descrevem durações diferentes.
- Apenas a conta de API que criou a apresentação pode acessar suas tarefas e apresentações. Um recurso ausente ou inacessível pode retornar 404; um recurso expirado ou excluído pode retornar 410, ou 404 após a limpeza.
- A geração é cobrada por página gerada (`ppt.generate`). No preço por página, a criação reserva o preço de dez páginas, depois acerta a saída real bem-sucedida e libera a reserva não utilizada. Sua conta precisa de saldo disponível suficiente para a reserva, mesmo que o prompt solicite menos páginas.
- A exportação tem um preço de solicitação separado (`ppt.export`). Consultas de status, consultas de resultado, consultas de status de exportação e exclusão não criam nova cobrança.
- Após um timeout, consulte a tarefa salva em vez de criar outra apresentação. Veja [Cobrança e Erros](https://openapi.felo.ai/pt-BR/docs/data-api/guides/felo-billing.md).