# 聯網問答

使用平台餘額並搭配網頁來源產生答案。

送出問題，即可在單一回應中收到帶有網頁來源的生成答案。

所有範例都使用來自[總覽](https://openapi.felo.ai/zh-TW/docs/data-api/guides/felo-overview.md)的 `FELO_API_KEY`。呼叫會使用 **平台餘額**，不是 Felo Pro 點數。回應範例僅供說明；實際內容與可選欄位會有所不同。

## 端點

`POST /api/v1/data/chat`

這是平台餘額端點。[Felo Search API](https://openapi.felo.ai/zh-TW/docs/api-reference/chat.md) 位於 `/v2/chat`，使用 Pro 點數並有不同的回應封裝。

## 請求

| 欄位 | 類型 | 必填 | 意義 |
|---|---|---|---|
| `query` | string | 是 | 問題，1–2,000 個字元 |
| `accept_language` | string | 否 | 偏好的答案語言，例如 `en`、`ja` 或 `zh-CN`；最多 64 個字元 |
| `stream` | boolean | 否 | 必須為 `false`；預設為 `false` |

請使用帶有 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":"Explain retrieval augmented generation and cite sources.","accept_language":"en","stream":false}'
```

## 回應

HTTP 200 會回傳 `status: "ok"` 與一個 `data` 物件：

```json
{
  "status": "ok",
  "data": {
    "id": "example-chat-id",
    "message_id": "example-message-id",
    "answer": "Retrieval augmented generation adds retrieved context to a model request...",
    "resources": [
      {"title":"Example reference","link":"https://example.com/guide","snippet":"An overview of retrieval augmented generation."}
    ],
    "query_analysis": {"queries":["retrieval augmented generation"]}
  }
}
```

| 欄位 | 意義 |
|---|---|
| `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-TW/docs/data-api/guides/felo-billing.md)。