# 平台总览

区分模型、第三方数据、平台余额 API 与 Felo Pro 积分接口，选择合适的接入入口。

Felo API Platform 用一个 API Key 提供模型、Data API 供应商和原 Felo 工作流。账户和密钥可以共用，但扣费方式不同：Data API 使用平台余额，原 Felo APIs 使用 Felo Pro 积分。

## API 分类

| 入口 | Base URL | 适用场景 | 文档 |
|------|----------|----------|------|
| Model API | `https://openapi.felo.ai/api/v1`（OpenAI-compatible）与 `https://openapi.felo.ai/api`（Anthropic-compatible） | 直接调用语言、图片、视频或决策模型 | [Model API](https://openapi.felo.ai/zh-CN/docs/model-api) |
| Data API | `https://openapi.felo.ai/v1/beta` / `https://openapi.felo.ai/api/v1/data` | 调用 Felo 和第三方数据与工具接口，路径以具体接口为准 | [Data API](https://openapi.felo.ai/zh-CN/docs/data-api) |
| Felo APIs | `https://openapi.felo.ai/v2` | 使用 Felo 自有的搜索、办公、内容生成、网页提取与知识工作流 | [Felo API 参考](https://openapi.felo.ai/zh-CN/docs/api-reference/chat.md) |

## 该选哪一类？

| 我想要… | 使用 |
|---------|------|
| 在自己的代码或 AI 编程工具里运行 LLM | Model API |
| 获得带网页搜索、引用和查询分析的答案 | Chat API（`/v2/chat`） |
| 生成演示文稿、落地页、思维导图或视频 | 对应的 Felo 任务或模型 endpoint |
| 构建知识库并从其中检索 | LiveDoc API |
| 调用 Tavily、Exa、Apollo 或其他具名数据供应商 | Data API |
| 把模型固定到指定上游供应商 | Model API + `X-Felo-Channel` |

## 共同准备

1. 在 [Felo API Platform 控制台](https://openapi.felo.ai/console/api-keys)创建一个 API key。
2. 通过 `Authorization: Bearer $FELO_API_KEY` 发送。
3. 模型和 Data API 需要平台余额；`/v2` 工作流需要检查 Felo Pro 积分。
4. 选择要调用的入口对应的 Base URL。

同一个 key 适用于本文档描述的所有入口。不同环境请使用不同的 key，这样轮换其中一个时不会影响其他环境。

## 平台提供的能力

- 一个 key，替代为每个模型和数据供应商分别开户。
- 公开的模型目录，包含模型 ID、上下文限制、协议与费率。
- 对可通过多个渠道使用的模型，公开各供应商的价格。
- 在一个控制台中集中查看用量和账单。

## 下一步

- [模型与价格](https://openapi.felo.ai/zh-CN/docs/guides/models-and-pricing.md) — 读取目录并估算一次请求的费用。
- [为什么同一个模型价格不同？](https://openapi.felo.ai/zh-CN/docs/guides/provider-routing.md) — 把模型固定到指定供应商。
- [协议与 SDK](https://openapi.felo.ai/zh-CN/docs/guides/protocols.md) — 在 OpenAI-compatible、Responses 和 Messages 之间选择。
- [异步任务](https://openapi.felo.ai/zh-CN/docs/guides/async-tasks.md) — 处理 PPT、落地页、视频和导出任务。
- [Data API 总览](https://openapi.felo.ai/zh-CN/docs/guides/data-api.md) — 通过统一前缀调用第三方 endpoint。
