# 联网问答

使用平台余额生成带网页来源的回答。

提交一个问题，一次获得生成的回答与网页来源。

示例使用[总览](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-overview.md)中配置的 `FELO_API_KEY`。调用使用**平台余额**，不使用 Felo Pro 积分。响应示例仅展示结构，实际内容和可选字段会变化。

## 接口

`POST /api/v1/data/chat`

此接口使用平台余额。原[搜索问答接口](https://openapi.felo.ai/zh-CN/docs/api-reference/chat.md) `/v2/chat` 使用 Pro 积分，响应外层结构也不同。

## 请求参数

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `query` | string | 是 | 问题，1–2,000 字符 |
| `accept_language` | string | 否 | 期望的回答语言，例如 `zh-CN`、`en`、`ja`；最长 64 字符 |
| `stream` | boolean | 否 | 只能为 `false`；默认 `false` |

`accept_language` 使用语言标签，语言代码为 2–8 个英文字母，后续部分用连字符连接，例如 `zh-TW`。服务会把语言要求加入生成请求。不传时由上游选择语言，没有固定的默认回答语言；问题使用英文，也不保证回答为英文。该偏好只作用于生成的回答，引用来源的标题和摘要保留原语言。

此接口返回非流式 JSON，不支持 `stream: true`、SSE、`messages` 数组或选择模型。

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/chat" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"解释检索增强生成，并提供参考来源。","accept_language":"zh-CN","stream":false}'
```

## 返回结果

HTTP 200，返回 `status: "ok"` 和 `data` 对象：

```json
{
  "status": "ok",
  "data": {
    "id": "example-chat-id",
    "message_id": "example-message-id",
    "answer": "检索增强生成会把检索到的资料作为上下文提供给模型……",
    "resources": [
      {"title":"示例参考资料","link":"https://example.com/guide","snippet":"检索增强生成概述。"}
    ],
    "query_analysis": {"queries":["检索增强生成"]}
  }
}
```

| 字段 | 说明 |
|---|---|
| `data.answer` | 生成的回答 |
| `data.resources` | 来源网页，包含标题、链接和摘要 |
| `data.query_analysis` | 可选的查询分析，可能为 null |
| `data.id`、`data.message_id` | 本次响应的标识 |

先检查 HTTP 状态，再读取回答和来源。不要沿用 `/v2/chat` 对数字 `status: 200` 的判断。

## 计费

`chat` 按请求计费，不按模型 token 计费。请查看[当前价格表](https://openapi.felo.ai/api/v1/data/prices)和[计费与错误处理](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-billing.md)。