# Felo Chat založený na vyhledávání

POST /api/v1/data/chat

Pošlete otázku a obdržíte v jedné odpovědi vygenerovanou odpověď s webovými zdroji.

Všechny příklady používají `FELO_API_KEY` z [přehledu](https://openapi.felo.ai/cs/docs/data-api/guides/felo-overview.md). Volání používají **zůstatek platformy**, nikoli Felo Pro credits. Příklady odpovědí jsou ilustrativní; živý obsah a volitelná pole se liší.

## Konečný bod

`POST /api/v1/data/chat`

Toto je koncový bod s zůstatkem platformy. [Felo Search API](https://openapi.felo.ai/cs/docs/api-reference/chat.md) na `/v2/chat` používá Pro credits a má odlišný obal odpovědi.

## Požadavek

| Pole | Typ | Povinné | Význam |
|---|---|---|---|
| `query` | string | Ano | Otázka, 1–2 000 znaků |
| `accept_language` | string | Ne | Preferovaný jazyk odpovědi, například `en`, `ja` nebo `zh-CN`; max. 64 znaků |
| `stream` | boolean | Ne | Musí být `false`; výchozí je `false` |

Použijte jazykový tag s 2–8písmenným kódem jazyka a volitelnými podtagy oddělenými pomlčkami, například `zh-TW`. Služba přidá tuto preferenci do požadavku na generování. Pokud je vynechána, upstream služba zvolí jazyk; neexistuje pevný výchozí jazyk a otázka v angličtině nezaručuje odpověď v angličtině. Preference se vztahuje na vygenerovanou odpověď; názvy zdrojů a úryvky zůstávají ve svém původním jazyce.

Tento koncový bod vrací ne-streamovaný JSON. Nepodporuje `stream: true`, SSE, pole `messages` ani výběr modelu.

```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}'
```

## Odpověď

HTTP 200 vrací `status: "ok"` a objekt `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"]}
  }
}
```

| Pole | Význam |
|---|---|
| `data.answer` | Vygenerovaná odpověď |
| `data.resources` | Zdrojové stránky s názvy, odkazy a úryvky |
| `data.query_analysis` | Volitelná analýza dotazu; může být null |
| `data.id`, `data.message_id` | Identifikátory odpovědi |

Nejprve zkontrolujte HTTP stav, poté přečtěte odpověď a zdroje. Netestujte číselný `status: 200`, jak byste to dělali u `/v2/chat`.

## Účtování

`chat` je účtován za požadavek, nikoli podle tokenů modelu. Viz [aktuální ceny](https://openapi.felo.ai/api/v1/data/prices) a [Účtování a chyby](https://openapi.felo.ai/cs/docs/data-api/guides/felo-billing.md).