Skip to main content

Felo PPT API теперь экспортирует настоящие файлы PPTX

· 7 минут чтения
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

PPT Task API от Felo OpenAPI теперь экспортирует созданные презентации как редактируемые файлы .pptx. Один API-ключ, асинхронный процесс из четырех шагов и ссылка для скачивания.

Ваш агент может исследовать тему, строить структуру и создавать готовую презентацию без работы в дизайнерских инструментах. Раньше он не мог выдать файл, который команда откроет в PowerPoint.

Теперь этот пробел закрыт. Felo OpenAPI теперь экспортирует созданные презентации как настоящие .pptx файлы. PPT Task API уже создавал редактируемые слайды внутри Felo; новые эндпоинты экспорта превращают их в файл PowerPoint, который можно скачать, изменить и отправить. Тот же API-ключ, тот же асинхронный процесс, один дополнительный вызов.

Попробуйте сейчас: https://openapi.felo.ai/docs/api-reference/ppt-tasks

Felo PPT Task API теперь экспортирует настоящие .pptx файлы: от исследования до презентации в одном процессе, POST /v2/ppts/{id}/export, download_url действует 30 минут

Что изменилось​

До этого обновления PPT Task API заканчивал работу на ссылке на слайды Felo. Презентация создавалась, но дальше процесс останавливался: чтобы показать её клиенту, классу или руководству, кто-то вручную переносил её в PowerPoint.

Теперь процесс завершается полностью. Когда задача генерации презентации получает статус COMPLETED, вызывается один эндпоинт экспорта и опрашивается второй. API возвращает подписанный download_url, ведущий к настоящему .pptx файлу — та же презентация, в привычном для всех формате.

Здесь не просто конвертация формата:

  • Презентация редактируется. Это не PDF и не набор изображений. Текст, макеты и структура темы переходят в PowerPoint, поэтому коллега может изменить число или переставить раздел без повторной генерации.
  • Исследование уже проведено. Генерация PPT в Felo не просто переносит ваш запрос на слайды. Система исследует тему, собирает источники, строит аргументацию и применяет тему оформления. Получается презентация, готовая к показу, а не черновик для доработки.

В этом и суть. Большинство инструментов либо хорошо исследуют и выдают текст, либо хорошо оформляют и создают пустую структуру. Felo делает и то, и другое, а теперь ещё и сохраняет результат в файл.

Как работает экспорт​

Экспорт происходит асинхронно, как и остальной PPT Task API. Отправляется задача, опрашивается её статус, скачивается результат.

Шаг 1 — Сгенерировать презентацию​

Создайте задачу PPT с запросом. Если нужен определённый стиль, сначала получите список тем и передайте ID темы.

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

В ответе возвращаются task_id и ppt_business_id. Сохраните оба — task ID нужен для опроса генерации, business ID — для экспорта.

Шаг 2 — Опросить статус до готовности презентации​

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY

Опросите каждые 2–5 секунд. Когда task_status станет COMPLETED, презентация создана и её можно экспортировать. Вместе с этим возвращается ppt_url, если нужно предварительно просмотреть слайды в Felo.

Шаг 3 — Запустить экспорт​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

Это весь запрос: {}. Экспорт запускается как фоновая задача.

Шаг 4 — Опросить экспорт и скачать файл​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

Опросите каждые 2–5 секунд. data.status проходит через NOT_STARTED, PROCESSING и COMPLETED. Только при COMPLETED возвращается нужная информация:

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

Скачайте файл по download_url — процесс завершён.

Процесс экспорта PPTX: POST /v2/ppts создаёт презентацию, GET /v2/tasks/{task_id}/historical опрашивает до COMPLETED, POST /v2/ppts/{id}/export запускает экспорт, GET /v2/ppts/{id}/export возвращает download_url, действующий 30 минут

Четыре важных детали перед запуском​

Ссылка для скачивания действует 30 минут после выдачи. Это подписанная ссылка, не постоянная. Если срок истёк, вызовите GET-эндпоинт экспорта ещё раз — получите новую ссылку без повторной генерации PPTX, это не расходует лимит.

Повторный экспорт после завершения расходует кредит. Повторный POST во время обработки экспорта безопасен и не запускает новую задачу. Но если вызвать POST после завершения экспорта, файл пересоздаётся и списывается кредит экспорта PPT. Для новой ссылки используйте GET.

API-ключ должен владеть презентацией. Экспорт доступен только ключу, который создал PPT. Ключ, не создавший презентацию, не сможет её экспортировать — это сохраняет презентации внутри аккаунта.

Ошибки можно повторить. Экспорт со статусом FAILED можно отправить повторно тем же POST. Недостаток кредитов возвращает HTTP 402; лимиты возвращают HTTP 429, повторите попытку через короткое время.

Почему это важно для агентов​

Главное не в формате файла, а в том, что даёт полный цикл от исследования до файла.

Агент, который исследует и экспортирует, теперь выполняет весь процесс без участия человека:

  • Еженедельные бизнес-обзоры — собирает метрики недели, исследует контекст, создаёт презентацию, экспортирует и выкладывает .pptx в общий диск до планёрки в понедельник.
  • Материалы для клиента — превращает бриф в презентацию с источниками и темой, отдаёт редактируемый файл, который клиент может оформить под свой бренд.
  • Продажи — создаёт индивидуальную презентацию для каждого клиента на основе исследования, экспортирует и прикрепляет к CRM автоматически.
  • Учебные материалы — исследует тему, структурирует как урок, экспортирует слайды, которые преподаватель может доработать перед занятием.

В каждом случае человеку остаётся только проверить и доработать. Никто не начинает с пустого слайда.

Если не хочется писать цикл опроса самому, Felo PPT Skill берёт это на себя. Установите пакет агента Felo AI — агент сможет создавать, опрашивать и экспортировать презентации как одну функцию, весь описанный выше процесс, обёрнутый для прямого вызова.

Как начать​

Экспорт уже работает в PPT Task API и доступен для любого ключа Felo OpenAPI.

  1. Получите API-ключ в панели Felo OpenAPI.
  2. Прочитайте документацию PPT Task API — раздел Export PPTX содержит точные форматы запросов и ответов.
  3. Сгенерируйте презентацию, экспортируйте её и откройте файл в PowerPoint.

Для быстрого старта установите Felo PPT Skill и дайте агенту выполнить весь процесс.

Начните работу с Felo OpenAPI: https://openapi.felo.ai

Часто задаваемые вопросы​

Экспортированный файл действительно редактируется в PowerPoint? Да. Экспорт создаёт стандартный .pptx файл. Текст, макет и структура темы сохраняются, поэтому презентацию можно редактировать в PowerPoint, Google Slides или Keynote.

Экспорт стоит дополнительных денег? Экспорт после генерации презентации использует существующий кредит экспорта PPT. Недостаток кредитов возвращает HTTP 402. Получение новой ссылки через GET не пересоздаёт файл и не списывает кредит.

Сколько действует ссылка для скачивания? 30 минут с момента выдачи. Для новой ссылки вызовите GET-эндпоинт экспорта ещё раз.

Можно ли экспортировать презентацию, созданную другим API-ключом? Нет. API-ключ, отправляющий запрос на экспорт, должен владеть PPT.

Что делать, если экспорт не удался? data.status возвращает FAILED. Отправьте POST-запрос экспорта ещё раз для повторной попытки.

Эта статья также доступна на следующих языках: English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা and Português.