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"

5. Періодично перевіряти експорт і завантажити

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"
СтатусНаступна дія
NOT_STARTEDНадішліть експорт один раз
PROCESSINGЗачекайте, потім знову виконайте GET
COMPLETEDПрочитайте download_url і завантажте файл
FAILEDПеревірте помилку та стан завдання перед надсиланням нового експорту
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

URL у прикладі наведено лише для ілюстрації. Використовуйте фактичний підписаний URL із відповіді. Він дійсний 30 хвилин; GET статусу експорту може повернути нове посилання, поки презентація ще доступна. Збережіть файл протягом строку його дії. Не надсилайте свій ключ Felo API на хост завантаження файлу.

Життєвий цикл, право доступу та білінг

  • Презентації закінчують термін дії через сім днів після створення. Запити та експорти не подовжують цей період. expires_at презентації та expires_at підписаного URL для завантаження описують різні терміни дії.
  • Доступ до своїх завдань і презентацій має лише той API-обліковий запис, який їх створив. Відсутній або недоступний ресурс може повертати 404; ресурс із закінченим терміном дії або видалений ресурс може повертати 410, або 404 після очищення.
  • Генерація оплачується за згенеровану сторінку (ppt.generate). За ціною сторінки створення резервує ціну десяти сторінок, потім проводить розрахунок за фактично успішний вихід і звільняє невикористаний резерв. Вашому обліковому запису потрібно мати достатньо доступного балансу для резервування, навіть якщо запит передбачає менше сторінок.
  • Експорт має окрему ціну за запит (ppt.export). Запити статусу, запити результатів, запити статусу експорту та видалення не створюють нового списання.
  • Після тайм-ауту запитуйте збережене завдання, а не створюйте ще одну презентацію. Дивіться Білінг і помилки.

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