指南
平台总览
了解 Model API、Data API 与 Felo APIs 三层如何分工，以及该从哪一层开始。
Felo API Platform 用一个 API key 提供三类请求入口。它们共用同一个账户、服务额度和 key，但解决的问题不同，Base URL 也不同。
三类 API
| 入口 | Base URL | 适用场景 | 文档 |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1（OpenAI-compatible）与 https://openapi.felo.ai/api（Anthropic-compatible） | 直接调用语言、图片、视频或决策模型 | Model API |
| Data API | https://openapi.felo.ai/v1/beta | 调用具名第三方数据与搜索供应商 | Data API |
| Felo APIs | https://openapi.felo.ai/v2 | 使用 Felo 自有的搜索、办公、内容生成、网页提取与知识工作流 | Felo API 参考 |
该选哪一类？
| 我想要… | 使用 |
|---|---|
| 在自己的代码或 AI 编程工具里运行 LLM | Model API |
| 获得带网页搜索、引用和查询分析的答案 | Chat API（/v2/chat） |
| 生成演示文稿、落地页、思维导图或视频 | 对应的 Felo 任务或模型 endpoint |
| 构建知识库并从其中检索 | LiveDoc API |
| 调用 Tavily、Exa、Apollo 或其他具名数据供应商 | Data API |
| 把模型固定到指定上游供应商 | Model API + X-Felo-Channel |
共同准备
- 在 Felo API Platform 控制台创建一个 API key。
- 通过
Authorization: Bearer $FELO_API_KEY发送。 - 随用随充以美元计价的服务额度。
- 选择要调用的入口对应的 Base URL。
同一个 key 适用于本文档描述的所有入口。不同环境请使用不同的 key，这样轮换其中一个时不会影响其他环境。
平台提供的能力
- 一个 key，替代为每个模型和数据供应商分别开户。
- 公开的模型目录，包含模型 ID、上下文限制、协议与费率。
- 对可通过多个渠道使用的模型，公开各供应商的价格。
- 在一个控制台中集中查看用量和账单。
下一步
- 模型与价格 — 读取目录并估算一次请求的费用。
- 渠道与供应商路由 — 把模型固定到指定供应商。
- 协议与 SDK — 在 OpenAI-compatible、Responses 和 Messages 之间选择。
- 异步任务 — 处理 PPT、落地页、视频和导出任务。
- Data API 总览 — 通过统一前缀调用第三方 endpoint。