Felo API PlatformFelo API Platform

指南

Data API 总览

通过统一前缀调用第三方接口，并保持一致的鉴权和请求处理方式。

Data API 是一个第三方 API 目录，统一使用一个 Felo key。它既不同于 Felo 自有的 /v2 API，也不同于 Model API。

统一前缀

https://openapi.felo.ai/v1/beta

参考文档将每个 endpoint 展示为以 /v1/beta 开头的完整路径。直接在 host 后使用该路径，不要再加一遍统一前缀。例如，Tavily 搜索 endpoint 是：

POST https://openapi.felo.ai/v1/beta/tavily/search

查找 endpoint

  • 在 API 目录按供应商浏览。
  • 打开 Data API 参考查看完整 endpoint 列表、参数和响应 schema。
  • 使用参考文档的 tags 在供应商之间切换。

每个供应商保留自己的请求结构。共享层统一的是鉴权和路由，不是 payload。发送请求前先阅读 endpoint schema。

鉴权

使用以下任一 header：

Authorization: Bearer $FELO_API_KEY

或：

X-API-Key: $FELO_API_KEY

发送 JSON body 时带上 Content-Type: application/json。

示例请求

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is Felo AI?",
    "max_results": 3
  }'

响应结构来自供应商。results、分页 cursor 和 metadata 等字段不会跨供应商归一化。

约定

项目说明
Payload供应商特定 JSON；遵循 endpoint schema
分页字段名和 cursor 风格因 endpoint 而异
错误带 status、code、message 和 request_id 的 JSON；供应商细节可能出现在 message 中
限流因 endpoint 和供应商而异；高负载时预期 429
计费按次计费，与 Model API 共用同一份服务额度余额

错误处理

鉴权失败返回与平台其他部分相同的错误结构：

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "..."
}

供应商层面的失败，请读取 HTTP 状态和 message。记录方法、完整路径、请求体结构（去掉敏感值）和 request_id。不要记录完整 API key。

重试

对 429 和 5xx 响应使用退避重试。不要原样重试 400 或 401。部分供应商操作不适合重复执行；重试写操作前先确认 endpoint 的语义。

何时改用 Felo API

需要特定第三方数据源时使用 Data API；需要 Felo 自有工作流时使用 Felo API：

相关