Статус генерации Felo

Генерируйте презентацию асинхронно, затем экспортируйте файл PPTX. Разделяйте шаги генерации и экспорта: созданная задача — это еще не готовый файл.

Во всех примерах используется FELO_API_KEY из обзора. Вызовы используют баланс платформы, а не кредиты Felo Pro. Примеры ответов носят иллюстративный характер; фактический контент и необязательные поля могут отличаться.

Используйте идентификаторы, возвращенные при создании задачи. Установите TASK_ID в task_id и PPT_ID в ppt_business_id; {business_id} также означает ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

2. Опрашивайте статус генерации

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

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

В ответе есть корневая строка status, например RUNNING или COMPLETED. Опрашивайте с ограниченным интервалом (например, 2–5 секунд) и дедлайном. После завершения переходите к результатам; обрабатывайте сбой и неожиданные статусы, не предполагая успеха. Дедлайн опроса не отменяет задачу.

{"status":"COMPLETED"}

Срок жизни, владение и биллинг

• Презентации истекают через семь дней после создания. Запросы и экспорты не продлевают этот срок. expires_at презентации и expires_at подписанного URL загрузки описывают разные сроки жизни.
• Только API-аккаунт, создавший презентацию, может получать доступ к своим задачам и презентациям. Отсутствующий или недоступный ресурс может вернуть 404; просроченный или удаленный ресурс может вернуть 410, либо 404 после очистки.
• Генерация тарифицируется за каждую сгенерированную страницу (ppt.generate). При тарификации по страницам создание резервирует стоимость десяти страниц, затем окончательно учитывает фактически успешный результат и освобождает неиспользованный резерв. На вашем аккаунте должно быть достаточно доступного баланса для резерва, даже если в запросе указано меньше страниц.
• Экспорт имеет отдельную цену за запрос (ppt.export). Запросы статуса, запросы результатов, запросы статуса экспорта и удаление не создают нового списания.
• После тайм-аута запросите сохраненную задачу, а не создавайте другую презентацию. См. Биллинг и ошибки.