# Felo APIs 总览

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

需要用**平台余额**调用网页搜索、网页读取、X 数据、联网问答或 PPT？请阅读 [Felo（Data API）](https://openapi.felo.ai/zh-CN/docs/api-reference/openapi/overview.md)。本页保留原 `/v2` 接口文档，使用 **Felo Pro 积分**。

Felo APIs 是 Felo 自有的工作流 API，覆盖搜索、文档、演示文稿、网页提取、社交搜索和 Agent 工作流。它们与其他 API 使用同一把 Felo API Key，但计费与模型调用分开。

::: tip 可以使用 Felo Pro 订阅积分
**Felo APIs 目前可以使用 Felo Pro 订阅计划的积分。** 适用于本节中的 Felo 自有 `/v2` API：Felo Search、PPT Task、Mindmap、LiveDoc、Web Fetch、X Search、YouTube Subtitling、Landing Page 和 SuperAgent。

这**不适用于** Model API（`/api/v1`）。模型调用必须使用 Felo API Platform 的预付服务额度，Felo Pro 订阅积分不能用于模型调用。
:::

适用范围可能调整，请以 [Console Billing](https://openapi.felo.ai/console/billing) 中显示的余额和用量为准。

## 本节的 API

| API | 端点 | 用途 |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/zh-CN/docs/api-reference/chat.md) | `POST /v2/chat` | 带查询分析、来源和引用的对话式网页搜索 |
| [PPT Task API](https://openapi.felo.ai/zh-CN/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | 生成幻灯片并轮询任务状态 |
| [Mindmap API](https://openapi.felo.ai/zh-CN/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | 根据 prompt 或 LiveDoc 上下文生成思维导图 |
| [LiveDoc API](https://openapi.felo.ai/zh-CN/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | 创建知识库、管理资源并检索上下文 |
| [Web Fetch API](https://openapi.felo.ai/zh-CN/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | 将网页提取为 HTML、text 或 Markdown |
| [X Search API](https://openapi.felo.ai/zh-CN/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | 搜索 X 用户、推文、时间线和回复 |
| [YouTube Subtitling API](https://openapi.felo.ai/zh-CN/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | 获取 YouTube 字幕和时间戳 |
| [Landing Page Task API](https://openapi.felo.ai/zh-CN/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | 异步生成落地页 |
| [SuperAgent API](https://openapi.felo.ai/zh-CN/docs/api-reference/superagent.md) | `POST /v2/conversations` | 通过 SSE 运行 Agent 对话 |

## 认证与第一次调用

在 [Console → API Keys](https://openapi.felo.ai/console/api-keys) 创建一把 Felo API Key，并以 Bearer Token 发送。

```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 APIs | `/v2/*` | Felo Pro 积分 |
| [Felo（Data API）](https://openapi.felo.ai/zh-CN/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/zh-CN/docs/api-reference/chat.md)
- [计费与额度](https://openapi.felo.ai/zh-CN/docs/faq/billing-and-credits.md)
- [错误、限流与重试](https://openapi.felo.ai/zh-CN/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)