Resultados de generación de Felo

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"

3. Leer resultados de generación

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

Este es un POST, y no requiere cuerpo JSON.

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

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

Lee task_status antes de usar history_data. La carga histórica puede variar según la tarea y puede ser null. ai_page_html y thread_short_id son opcionales. Esta respuesta no es una URL de descarga PPTX garantizada; usa exportación a continuación.

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.