# Felo API 개요

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

웹 검색, 웹 읽기, X 데이터, Chat 또는 PPT를 **플랫폼 잔액**으로 결제하려면 [Data API의 Felo](https://openapi.felo.ai/ko/docs/api-reference/openapi/overview.md)를 사용하세요. 이 페이지는 **Felo Pro 크레딧**을 사용하는 기존 `/v2` API를 문서화합니다.

Felo API는 검색, 문서, 프레젠테이션, 웹 추출, 소셜 검색, 에이전트 워크플로를 위한 퍼스트파티 워크플로 수준 API입니다. 플랫폼의 나머지 부분과 같은 Felo API 키를 사용하지만, 모델 호출과는 별도로 과금됩니다.

::: tip Felo Pro 구독 크레딧
**Felo API는 현재 Felo Pro 구독 크레딧을 허용합니다.** 이는 이 섹션의 퍼스트파티 `/v2` API, 즉 Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page, SuperAgent에 적용됩니다.

이 내용은 Model API 호출(`/api/v1`)에는 적용되지 않습니다. Model API 호출에는 선불 Felo API Platform 서비스 크레딧이 필요하며, Felo Pro 구독 크레딧은 사용할 수 없습니다.
:::

자격은 변경될 수 있습니다. [Console Billing](https://openapi.felo.ai/console/billing) 페이지가 현재 잔액과 사용량의 단일 기준입니다.

## 이 섹션의 API

| API | 엔드포인트 | 용도 |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/ko/docs/api-reference/chat.md) | `POST /v2/chat` | 쿼리 분석, 소스, 인용이 포함된 대화형 웹 검색 |
| [PPT Task API](https://openapi.felo.ai/ko/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | 슬라이드 덱 생성 및 작업 상태 폴링 |
| [Mindmap API](https://openapi.felo.ai/ko/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | 프롬프트 또는 LiveDoc 컨텍스트를 마인드맵으로 변환 |
| [LiveDoc API](https://openapi.felo.ai/ko/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | 지식 베이스 생성, 리소스 관리, 컨텍스트 검색 |
| [Web Fetch API](https://openapi.felo.ai/ko/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | 웹페이지를 HTML, 텍스트 또는 Markdown으로 추출 |
| [X Search API](https://openapi.felo.ai/ko/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | X 사용자, 트윗, 타임라인, 답글 검색 |
| [YouTube Subtitling API](https://openapi.felo.ai/ko/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | YouTube 자막과 타임스탬프 가져오기 |
| [Landing Page Task API](https://openapi.felo.ai/ko/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | 랜딩 페이지를 비동기적으로 생성 |
| [SuperAgent API](https://openapi.felo.ai/ko/docs/api-reference/superagent.md) | `POST /v2/conversations` | SSE를 통해 에이전트 대화 실행 |

## 인증 및 첫 호출

[Console → API Keys](https://openapi.felo.ai/console/api-keys)에서 하나의 Felo API 키를 만들고 Bearer 토큰으로 보내세요.

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

성공 응답에는 답변, 쿼리 분석, 인용된 웹 리소스가 포함됩니다.

## 청구 모델

| 표면 | 경로 | 호출 결제 방식 |
|---|---|---|
| Felo API | `/v2/*` | Felo Pro 크레딧 |
| [Data API의 Felo](https://openapi.felo.ai/ko/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | 플랫폼 잔액, Pro 크레딧 아님 |
| Model API | `/api/v1/*` | 선불 Felo API Platform 서비스 크레딧만 사용; Felo Pro는 적용되지 않음 |
| Data API | `/v1/beta/*` | 각 엔드포인트에 표시된 API 카탈로그 청구 기준 사용 |

Felo Pro 크레딧과 API 서비스 크레딧은 별도 잔액입니다. Felo Pro 구독이 자동으로 API 서비스 크레딧을 제공하지 않으며, API 서비스 크레딧이 Felo Pro 구독 크레딧을 추가하지도 않습니다.

## 관련 항목

- [Felo Search API](https://openapi.felo.ai/ko/docs/api-reference/chat.md)
- [Billing and Credits](https://openapi.felo.ai/ko/docs/faq/billing-and-credits.md)
- [Errors, Limits, and Retries](https://openapi.felo.ai/ko/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)