Felo API 설정
공급자: Felo · 플랫폼 잔액으로 결제
Felo는 Data API의 한 공급자로, 웹 검색, 웹 읽기, X 데이터, 검색 기반 답변, 프레젠테이션을 제공합니다. 각 Felo 엔드포인트는 관련 Data API 카테고리에서 다른 공급자와 함께 찾을 수 있습니다.
이 엔드포인트들은 플랫폼 잔액과 /api/v1/data 접두사를 사용합니다. 이 가이드에서는 인증, 첫 요청, 청구 규칙을 찾는 위치를 설명합니다.
Felo Pro 크레딧을 사용하려면 기존 Felo API를 참조하세요. 플랫폼 잔액과 Pro 크레딧은 서로 별개입니다.
첫 요청 만들기
- Console → API Keys에서 키를 만드세요.
- Console → Billing에서 플랫폼 잔액을 확인하거나 충전하세요.
- 서버 또는 로컬 셸에서 키를 설정하세요:
export FELO_API_KEY="YOUR_API_KEY"Authorization: Bearer $FELO_API_KEY를 보내세요. X-API-Key도 허용됩니다. 인증 방법은 하나만 선택하세요. JSON 요청에는 Content-Type: application/json이 필요합니다.
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"What is retrieval augmented generation?","count":3}'HTTP 200은 페이지 제목, 링크, 스니펫과 total을 포함한 resources 배열을 반환합니다. 대화형 답변은 생성하지 않습니다. 그런 답변이 필요하면 Chat을 사용하세요.
API 살펴보기
| 가이드 | 작업 | 반환 내용 | 청구 단위 |
|---|---|---|---|
| 웹 검색 | 웹 검색 | 페이지 제목, 링크, 스니펫 | 요청 |
| 웹 읽기 | URL 읽기 | Markdown, 텍스트, HTML 또는 스크린샷 | 요청 |
| X 데이터 | 프로필, 사용자 검색, 사용자 게시물, 게시물 검색, 답글 | 지원되는 경우 페이지네이션이 포함된 구조화된 사용자 및 게시물 | 반환 결과 |
| 검색 기반 채팅 | 질문 답변 | 답변 및 웹 소스 | 요청 |
| PPT | 생성, 상태, 결과, 내보내기, 내보내기 상태, 삭제 | 생성 작업 및 다운로드 가능한 PPTX | 생성된 페이지; 내보내기는 별도 청구 |
| 청구 및 오류 | 공통 통합 안내 | 가격, 잔액 처리, 재시도 규칙 | — |
이 가이드 전반에 걸쳐 14개의 핵심 작업이 있습니다. PPT 생성이 stream_key를 반환하면, PPT 가이드에서 SSE로 생성 이벤트를 읽는 방법도 설명합니다. 상태 및 결과 조회, export-status 조회, 삭제는 새 요금을 발생시키지 않습니다.
기존 통합을 이전하기 전에
호출하는 정확한 엔드포인트에 맞는 가이드를 사용하세요. /v2를 /api/v1/data로 바꾸는 것만으로는 완전한 마이그레이션이 아닙니다:
- Web Read는
/web/read를 사용하며, 요청당 하나의 출력 형식을 사용합니다. - Chat은
status: "ok"를 반환하며, 비스트리밍 JSON만 지원합니다. - PPT 결과는 POST
/tasks/{task_id}/historical을 사용합니다. - PPT 생성은 JSON 루트에 식별자를 반환합니다.
task_id와ppt_business_id를 모두 저장하세요. - 생성된 PPT는 7일 후 만료됩니다. 만료되기 전에 내보내고 저장하세요.
여기에는 LiveDoc CRUD, Mindmap, SuperAgent와 같은 모든 /v2 워크플로에 대한 기본 OpenAPI 대응 문서는 없습니다. 해당 기능은 계속해서 Felo API 가이드와 Pro 크레딧 청구를 사용하세요.
계약 및 현재 가격
- 공개 OpenAPI 스키마 — 필드 정의와 응답 스키마.
- OpenAPI YAML 스키마 — YAML을 받아들이는 도구용.
- 현재 가격 — 작업 ID, 청구 단위, 현재 요율.
이 리소스들은 공개되어 있으며 키 없이 읽을 수 있습니다. 자동 재시도를 추가하기 전에 청구 및 오류를 확인하세요.