Felo API PlatformFelo API Platform

Estado de exportación de Felo

Proveedor: Felo · Pagado con saldo de la plataforma

Autenticación y configuraciónFacturación y erroresGuía completa de flujo de trabajo

Genera una presentación de forma asíncrona y luego exporta un archivo PPTX. Mantén separadas las fases de generación y exportación: una tarea creada todavía no es un archivo terminado.

Todos los ejemplos usan FELO_API_KEY de la vista general. Las llamadas usan saldo de la plataforma, no créditos Felo Pro. Los ejemplos de respuesta son ilustrativos; el contenido en vivo y los campos opcionales varían.

Usa los identificadores devueltos al crear la tarea. Establece TASK_ID en task_id y PPT_ID en ppt_business_id; {business_id} también significa ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. Consultar exportación y descargar

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"
EstadoPróxima acción
NOT_STARTEDEnvía la exportación una vez
PROCESSINGEspera y luego vuelve a consultar GET
COMPLETEDLee download_url y descarga el archivo
FAILEDInspecciona el error y el estado de la tarea antes de enviar una nueva exportación
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

La URL de ejemplo es ilustrativa. Usa la URL firmada real de la respuesta. Es válida durante 30 minutos; el estado de exportación GET puede devolver un enlace nuevo mientras la presentación siga disponible. Guarda el archivo dentro de su periodo de vida. No envíes tu clave API de Felo al host de descarga del archivo.

Vida útil, propiedad y facturación

  • Las presentaciones caducan siete días después de su creación. Las consultas y exportaciones no prolongan este periodo. El expires_at de la presentación y el expires_at de la URL firmada describen vidas útiles distintas.
  • Solo la cuenta API creadora puede acceder a sus tareas y presentaciones. Un recurso ausente o inaccesible puede devolver 404; un recurso caducado o eliminado puede devolver 410, o 404 después de la limpieza.
  • La generación se factura por página generada (ppt.generate). Con el precio por página, la creación reserva el precio de diez páginas y luego liquida la salida exitosa real y libera la reserva no utilizada. Tu cuenta necesita saldo disponible suficiente para la reserva incluso si el prompt solicita menos páginas.
  • La exportación tiene un precio de solicitud separado (ppt.export). Las consultas de estado, las consultas de resultados, las consultas de estado de exportación y la eliminación no crean ningún nuevo cargo.
  • Después de un tiempo de espera, consulta la tarea guardada en lugar de crear otra presentación. Consulta Facturación y errores.

¿Necesitas ayuda?