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