Felo PPT API, 이제 실제 PPTX 파일로 내보내기 지원
Felo OpenAPI의 PPT 작업 API가 생성된 슬라이드 데크를 편집 가능한 .pptx 파일로 내보내기 지원한다. 하나의 API 키, 네 단계 비동기 흐름, 그리고 다운로드 링크.
에이전트가 주제를 조사하고, 개요를 만들고, 완성된 슬라이드 데크를 생성한다. 디자인 도구를 직접 사용할 필요 없다. 한 가지 부족했던 점은 팀이 PowerPoint에서 열 수 있는 파일을 제공하지 못했다.
이제 그 간극이 사라졌다. Felo OpenAPI가 생성된 데크를 실제 .pptx 파일로 내보낸다. PPT 작업 API는 이미 Felo에서 편집 가능한 슬라이드를 만들었다. 새로운 내보내기 엔드포인트가 이를 PowerPoint 파일로 변환한다. 다운로드, 편집, 공유 가능하다. 같은 API 키, 같은 비동기 패턴, 한 번의 추가 호출만 필요하다.
지금 사용해보기: https://openapi.felo.ai/docs/api-reference/ppt-tasks
실제로 바뀐 점
이전에는 PPT 작업 API가 Felo 슬라이드 URL에서 끝났다. 데크를 받았지만, 전달은 거기서 멈췄다. 클라이언트, 강의, 이사회 앞에 내놓으려면 누군가 PowerPoint에서 수작업으로 다시 만들어야 했다.
이제 흐름이 완성된다. PPT 생성 작업이 COMPLETED 상태에 도달하면, 하나의 내보내기 엔드포인트를 호출하고 두 번째 엔드포인트를 폴링한다. API가 서명된 download_url을 반환한다. 진짜 .pptx 파일을 가리킨다. 모두가 이미 사용하는 형식 그대로다.
이 기능은 단순한 형식 변환을 넘는다:
- 데크를 편집할 수 있다. PDF나 평면 이미지가 아니다. 텍스트, 레이아웃, 테마 구조가 PowerPoint로 넘어간다. 동료가 숫자를 고치거나 섹션을 재배치할 수 있다. 재생성 필요 없다.
- 조사 과정이 이미 끝났다. Felo의 PPT 생성은 단순히 프롬프트를 슬라이드에 옮기지 않는다. 주제를 조사하고, 자료를 모으고, 논리를 구조화하고, 테마를 적용한다. 발표에 바로 쓸 수 있는 데크를 제공한다. 초안이 아니다.
이 조합이 핵심이다. 대부분의 도구는 조사만 잘해서 텍스트를 주거나, 형식만 잘해서 빈 구조를 준다. Felo는 둘 다 한다. 이제 결과물을 파일로 제공한다.
내보내기 작동 방식
내보내기는 비동기 방식이다. PPT 작업 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를 받는다. 둘 다 저장한다. 작업 ID로 생성 상태를 폴링하고, 비즈니스 ID로 내보내기를 한다.
2단계 — 데크 준비 완료까지 폴링
GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY
2~5초마다 폴링한다. task_status가 COMPLETED가 되면 데크가 생성된다. 내보내기 가능하다. 슬라이드를 Felo에서 미리 보고 싶으면 ppt_url도 함께 반환된다.
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에서 파일을 다운로드하면 끝난다.
배포 전에 알아두면 좋은 네 가지
다운로드 URL은 발급 후 30분 동안만 유효하다. 서명된 URL이다. 영구 링크가 아니다. 만료되면 GET 내보내기 엔드포인트를 다시 호출한다. PPTX를 재생성하지 않고 새 URL을 발급한다. 비용 없다.
내보내기 완료 후 재실행은 크레딧을 소모한다. 내보내기가 아직 처리 중일 때 POST를 반복 호출해도 안전하다. 두 번째 작업이 시작되지 않는다. 하지만 내보내기 완료 후 POST를 다시 호출하면 파일을 재생성하고 기존 PPT 내보내기 크레딧을 소모한다. 새 링크만 필요하면 GET을 사용한다.
API 키는 데크를 소유해야 한다. 내보내기는 PPT를 생성한 키에 한정된다. 데크를 생성하지 않은 키는 내보내기 불가하다. 데크는 생성한 계정 내에 남는다.
실패는 재시도 가능하다. FAILED 내보내기는 같은 POST로 다시 제출할 수 있다. 크레딧 부족은 HTTP 402를 반환한다. 속도 제한은 HTTP 429를 반환하고, 잠시 후 재시도 가치가 있다.
에이전트에게 중요한 이유
중요한 점은 파일 형식이 아니다. 완전한 조사부터 파일까지의 파이프라인이 열리는 것이다.
조사와 내보내기를 모두 할 수 있는 에이전트는 이제 전체 루프를 자동으로 실행한다:
- 주간 비즈니스 리뷰 — 주간 지표를 가져오고, 숫자 배경을 조사하고, 데크를 생성하고, 내보내기 후
.pptx를 공유 드라이브에 넣는다. 월요일 스탠드업 전에 준비된다. - 클라이언트 전달물 — 브리프를 조사된, 테마가 적용된 데크로 변환한다. 클라이언트가 직접 브랜드화할 수 있는 편집 가능한 파일을 제공한다.
- 영업 지원 — 계정 조사를 바탕으로 잠재 고객별 맞춤 데크를 생성한다. 각각 내보내기 후 CRM 기록에 자동 첨부한다.
- 강의 및 교육 자료 — 주제를 조사하고, 레슨으로 구조화하고, 강사가 수업 전에 편집할 수 있는 슬라이드를 내보낸다.
각 경우 사람의 역할은 검토와 다듬기로 줄어든다. 빈 슬라이드에서 시작하지 않는다.
폴링 루프를 직접 작성하고 싶지 않다면, Felo PPT Skill이 처리한다. Felo AI 에이전트 패키지를 설치하면 에이전트가 데크 생성, 폴링, 내보내기를 하나의 기능으로 갖는다. 위에서 설명한 파이프라인을 직접 호출할 수 있다.
시작하기
내보내기는 PPT 작업 API에서 바로 사용할 수 있다. 모든 Felo OpenAPI 키에서 가능하다.
- Felo OpenAPI 대시보드에서 API 키를 가져온다.
- PPT 작업 API 레퍼런스를 읽는다. Export PPTX 섹션에 정확한 요청 및 응답 형식이 있다.
- 데크를 생성하고, 내보내기 후 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, বাংলা, Português.