Результаты генерации 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"

3. Читайте результаты генерации

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

Это POST, 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
}

Сначала прочитайте task_status, прежде чем использовать history_data. Историческая полезная нагрузка может различаться по задаче и может быть null. ai_page_html и thread_short_id необязательны. Этот ответ не является гарантированным URL для загрузки PPTX; далее используйте экспорт.

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

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