Felo API PlatformFelo API Platform

Felo Status da Exportação

Provedor: Felo · Pago com saldo da plataforma

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

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. Consulte a exportação e baixe

GET /api/v1/data/ppts/{business_id}/export

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
StatusPróxima ação
NOT_STARTEDEnvie a exportação uma vez
PROCESSINGAguarde e consulte o GET novamente
COMPLETEDLeia download_url e baixe o arquivo
FAILEDInspecione o erro e o estado da tarefa antes de enviar uma nova exportação
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

A URL de exemplo é ilustrativa. Use a URL assinada real da resposta. Ela é válida por 30 minutos; o GET de status da exportação pode retornar um link novo enquanto a apresentação permanecer disponível. Salve o arquivo dentro do período de validade. Não envie sua chave da API Felo para o host de download do arquivo.

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.

Precisa de ajuda?