# Felo API 설정

플랫폼 잔액을 사용하여 검색, 웹 콘텐츠, X 데이터 및 프레젠테이션용 Felo 엔드포인트를 Data API에 설정합니다.

Felo는 [Data API](https://openapi.felo.ai/ko/docs/data-api)의 한 공급자로, 웹 검색, 웹 읽기, X 데이터, 검색 기반 답변, 프레젠테이션을 제공합니다. 각 Felo 엔드포인트는 관련 Data API 카테고리에서 다른 공급자와 함께 찾을 수 있습니다.

이 엔드포인트들은 **플랫폼 잔액**과 `/api/v1/data` 접두사를 사용합니다. 이 가이드에서는 인증, 첫 요청, 청구 규칙을 찾는 위치를 설명합니다.

Felo Pro 크레딧을 사용하려면 [기존 Felo API](https://openapi.felo.ai/ko/docs/api-reference/felo-apis.md)를 참조하세요. 플랫폼 잔액과 Pro 크레딧은 서로 별개입니다.

## 첫 요청 만들기

1. [Console → API Keys](https://openapi.felo.ai/console/api-keys)에서 키를 만드세요.
2. [Console → Billing](https://openapi.felo.ai/console/billing)에서 **플랫폼 잔액**을 확인하거나 충전하세요.
3. 서버 또는 로컬 셸에서 키를 설정하세요:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

`Authorization: Bearer $FELO_API_KEY`를 보내세요. `X-API-Key`도 허용됩니다. 인증 방법은 하나만 선택하세요. JSON 요청에는 `Content-Type: application/json`이 필요합니다.

```bash
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](https://openapi.felo.ai/ko/docs/data-api/guides/felo-chat.md)을 사용하세요.

## API 살펴보기

| 가이드 | 작업 | 반환 내용 | 청구 단위 |
|---|---|---|---|
| [웹 검색](https://openapi.felo.ai/ko/docs/data-api/guides/felo-web-search.md) | 웹 검색 | 페이지 제목, 링크, 스니펫 | 요청 |
| [웹 읽기](https://openapi.felo.ai/ko/docs/data-api/guides/felo-web-read.md) | URL 읽기 | Markdown, 텍스트, HTML 또는 스크린샷 | 요청 |
| [X 데이터](https://openapi.felo.ai/ko/docs/data-api/guides/felo-x-data.md) | 프로필, 사용자 검색, 사용자 게시물, 게시물 검색, 답글 | 지원되는 경우 페이지네이션이 포함된 구조화된 사용자 및 게시물 | 반환 결과 |
| [검색 기반 채팅](https://openapi.felo.ai/ko/docs/data-api/guides/felo-chat.md) | 질문 답변 | 답변 및 웹 소스 | 요청 |
| [PPT](https://openapi.felo.ai/ko/docs/data-api/guides/felo-ppt.md) | 생성, 상태, 결과, 내보내기, 내보내기 상태, 삭제 | 생성 작업 및 다운로드 가능한 PPTX | 생성된 페이지; 내보내기는 별도 청구 |
| [청구 및 오류](https://openapi.felo.ai/ko/docs/data-api/guides/felo-billing.md) | 공통 통합 안내 | 가격, 잔액 처리, 재시도 규칙 | — |

이 가이드 전반에 걸쳐 **14개의 핵심 작업**이 있습니다. PPT 생성이 `stream_key`를 반환하면, [PPT 가이드](https://openapi.felo.ai/ko/docs/data-api/guides/felo-ppt.md#sse)에서 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 가이드](https://openapi.felo.ai/ko/docs/api-reference/felo-apis.md)와 Pro 크레딧 청구를 사용하세요.

## 계약 및 현재 가격

- [공개 OpenAPI 스키마](https://openapi.felo.ai/api/v1/data/openapi.json) — 필드 정의와 응답 스키마.
- [OpenAPI YAML 스키마](https://openapi.felo.ai/api/v1/data/openapi.yaml) — YAML을 받아들이는 도구용.
- [현재 가격](https://openapi.felo.ai/api/v1/data/prices) — 작업 ID, 청구 단위, 현재 요율.

이 리소스들은 공개되어 있으며 키 없이 읽을 수 있습니다. 자동 재시도를 추가하기 전에 [청구 및 오류](https://openapi.felo.ai/ko/docs/data-api/guides/felo-billing.md)를 확인하세요.