Felo API PlatformFelo API Platform

Felo Стан створення презентації

Провайдер: 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). Запити статусу, запити результатів, запити статусу експорту та видалення не створюють нового списання.
  • Після тайм-ауту запитуйте збережене завдання, а не створюйте ще одну презентацію. Дивіться Білінг і помилки.

Потрібна допомога?