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
}

history_data를 사용하기 전에 task_status를 읽으세요. 히스토리 페이로드는 작업에 따라 다를 수 있으며 null일 수 있습니다. ai_page_html과 thread_short_id는 선택 사항입니다. 이 응답은 보장된 PPTX 다운로드 URL이 아닙니다. 다음 단계로 내보내기를 사용하세요.

수명, 소유권 및 청구

• 프레젠테이션은 생성 후 7일에 만료됩니다. 조회와 내보내기는 이 기간을 연장하지 않습니다. 프레젠테이션 expires_at과 서명된 다운로드 URL expires_at은 서로 다른 수명을 나타냅니다.
• 생성한 API 계정만 자신의 작업과 프레젠테이션에 접근할 수 있습니다. 누락되었거나 접근할 수 없는 리소스는 404를 반환할 수 있으며, 만료되었거나 삭제된 리소스는 410을 반환하거나 정리 후 404가 될 수 있습니다.
• 생성은 생성된 페이지당(ppt.generate) 과금됩니다. 페이지 가격 책정에서는 생성 시 10페이지 가격을 예약한 다음 실제 성공 출력으로 정산하고 사용되지 않은 예약분을 해제합니다. 프롬프트가 더 적은 페이지를 요청하더라도 계정에는 예약에 충분한 가용 잔액이 있어야 합니다.
• 내보내기는 별도의 요청 가격(ppt.export)이 있습니다. 상태 조회, 결과 조회, export-status 조회, 삭제는 새 요금을 발생시키지 않습니다.
• 타임아웃 후에는 새 프레젠테이션을 만들지 말고 저장된 작업을 조회하세요. 청구 및 오류를 참조하세요.