Felo API PlatformFelo API Platform
全部 Exa 端点
v0.2.0-beta
OpenAPI 3.1.0

执行神经网络语义网络搜索。

Felo API Support
MIT
服务器:https://openapi.felo.ai
客户端库
Shell Curl

Exa

​

Semantic search, page content, cited answers and asynchronous research.

Exa 操作

执行神经网络语义网络搜索。

​

按语义而非关键词搜索网络。query 为必填；可通过 category、includeDomains、excludeDomains、startPublishedDate、endPublishedDate 缩小范围，并设置 numResults。返回 requestId、resolvedSearchType、searchTime、costDollars 以及包含 id、title 和 url 的 results[]。id 就是 URL，也是 post_exa_contents 接受的值。⚠️ 除非主动请求，否则结果不含页面文本：传入 contents，或随后调用 post_exa_contents。当查询是一段描述而非关键词时，优先用它而不是 searchWeb；如果希望同一次调用就拿到文本，请选 Tavily；如果需要书面回答而非列表，请用 post_exa_answer。

计费参考

  • 计量方式：按上报的响应成本计量。
  • 参考请求估算：0.017 美元。
  • 参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

请求体
必填
application/json
  • query
    类型: string
    必填

    自然语言搜索查询。

  • category
    类型: string 枚举

    关于优先考虑何种页面的可选提示。

    值
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    类型: object

    随每条结果一起返回的内容选项。

    • highlights
      类型: boolean

      返回高亮的相关片段。

    • summary
      类型: boolean

      返回页面由 AI 生成的摘要。

    • text
      类型: boolean

      返回完整页面文本。

  • endPublishedDate
    类型: string 格式: date-time

    仅返回在此 ISO 8601 日期或之前发布的结果。

  • excludeDomains
    类型: array string[]

    排除这些域名的结果。

  • includeDomains
    类型: array string[]

    仅返回这些域名的结果。

  • numResults
    类型: integer
    最小值:  
    1
    最大值:  
    100

    要返回的结果数。

  • outputSchema
    类型: object

    用于从结果合成结构化输出的 JSON Schema。

  • startPublishedDate
    类型: string 格式: date-time

    仅返回在此 ISO 8601 日期或之后发布的结果。

  • stream
    类型: boolean 枚举
    常量:  
    false
    值
    • false
  • systemPrompt
    类型: string

    指导如何生成结构化输出的指令。

  • type
    类型: string 枚举

    搜索模式。auto 让 Exa 自行选择；deep 系列模式以更高延迟换取更高质量的检索。

    值
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
响应
  • 200
    类型: object

    搜索成功完成。

    • costDollars

      资源使用的提供方成本明细。仅供参考；不是 Felo 客户扣费或 Felo 账单凭证。

    • output

      结构化输出，仅在提供 outputSchema 时存在。

    • requestId
      类型: string

      Exa 请求标识符。

    • results
      类型: array object[]

      排序后的搜索结果。

      • author
        类型: string
      • id
        类型: string
      • publishedDate
        类型: string
      • title
        类型: string
      • url
        类型: string
    application/json
  • 400

    无法处理该请求。请检查请求参数。

  • 401

    需要有效的 Felo API 密钥。

  • 402

    由于未满足计费要求，请求无法继续。

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

    API 或计费服务暂时不可用。

  • 504

    服务在处理请求时超时。

  • default

    错误响应；上游透传响应可能采用提供方格式

    application/json
Request Example for post/v1/beta/exa/search
curl https://openapi.felo.ai/v1/beta/exa/search \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "query": "latest evaluation frameworks for AI agents",
  "type": "auto",
  "numResults": 10,
  "category": "company",
  "includeDomains": [
    ""
  ],
  "excludeDomains": [
    ""
  ],
  "startPublishedDate": "",
  "endPublishedDate": "",
  "contents": {
    "text": true,
    "highlights": true,
    "summary": true
  },
  "outputSchema": {},
  "systemPrompt": "",
  "stream": false
}'

{
  "requestId": "string",
  "results": [
    {
      "title": "string",
      "url": "string",
      "publishedDate": "string",
      "author": "string",
      "id": "string"
    }
  ],
  "output": null,
  "costDollars": null
}

搜索成功完成。

Run a neural semantic web search.

需要帮助？