指南
平台总览
区分模型、第三方数据、平台余额 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 |
| Data API | https://openapi.felo.ai/v1/beta / https://openapi.felo.ai/api/v1/data | 调用 Felo 和第三方数据与工具接口,路径以具体接口为准 | 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发送。 - 模型和 Data API 需要平台余额;
/v2工作流需要检查 Felo Pro 积分。 - 选择要调用的入口对应的 Base URL。
同一个 key 适用于本文档描述的所有入口。不同环境请使用不同的 key,这样轮换其中一个时不会影响其他环境。
平台提供的能力
- 一个 key,替代为每个模型和数据供应商分别开户。
- 公开的模型目录,包含模型 ID、上下文限制、协议与费率。
- 对可通过多个渠道使用的模型,公开各供应商的价格。
- 在一个控制台中集中查看用量和账单。
下一步
- 模型与价格 — 读取目录并估算一次请求的费用。
- 为什么同一个模型价格不同? — 把模型固定到指定供应商。
- 协议与 SDK — 在 OpenAI-compatible、Responses 和 Messages 之间选择。
- 异步任务 — 处理 PPT、落地页、视频和导出任务。
- Data API 总览 — 通过统一前缀调用第三方 endpoint。