配置 Harness

Chat API

接入带查询分析、网页资源和引用的 AI 对话搜索。

POST/v2/chat

认证

Bearer API key

Content type

application/json

限流说明

Per API key and per user windows. Read X-RateLimit headers.

Authentication LLM API

Chat API 可将 AI-powered conversational search 接入你的应用。发送自然语言 query，即可获得基于实时 web search results 生成的智能回答。

Overview

Chat API 会执行以下流程：

分析并优化 query
搜索相关 web information
排序并过滤 search results
基于 sources 生成完整 AI answer
返回 answer 和 source citations

认证

Authorization: Bearer YOUR_API_KEY

详见认证指南。

Endpoint

POST https://openapi.felo.ai/v2/chat

请求

参数	类型	必填	说明	Constraints
`query`	string	是	用户问题或搜索 query	1-2000 characters

响应

{
  "status": "ok",
  "message": null,
  "data": {
    "answer": "...",
    "query_analysis": { "queries": ["..."] },
    "resources": [{ "link": "https://example.com", "title": "Source", "snippet": "..." }]
  }
}

响应字段

字段	类型	说明
`status`	string	`"ok"` 或 `"error"`
`data.answer`	string	AI-generated answer
`data.query_analysis.queries`	string[]	从用户输入生成的优化 search queries
`data.resources`	array	用于生成回答的 web sources

错误码

Code	HTTP Status	说明	Solution
`INVALID_API_KEY`	401	API Key 无效或已撤销	检查 key 是否正确且 active
`MISSING_AUTHORIZATION`	401	缺少 Authorization header	加入 Authorization header
`MISSING_PARAMETER`	400	缺少必填参数	确保 body 中包含 `query`
`QUERY_TOO_LONG`	400	Query 超过最大长度	缩短到 2000 characters 以内
`RATE_LIMITED`	429	请求过多	降低请求频率或联系 support

Example

curl -X POST https://openapi.felo.ai/v2/chat   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"query":"What are the benefits of renewable energy?"}'