# Arama Destekli Sohbet

Platform bakiyesini kullanarak web kaynaklarıyla bir yanıt oluşturun.

Bir soru gönderin ve tek bir yanıtta web kaynaklarıyla oluşturulmuş bir yanıt alın.

Tüm örnekler [genel bakış](https://openapi.felo.ai/tr/docs/data-api/guides/felo-overview.md) içindeki `FELO_API_KEY`’i kullanır. Çağrılar Felo Pro kredilerini değil, **platform bakiyesini** kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.

## Uç nokta

`POST /api/v1/data/chat`

Bu, platform-bakiyesi uç noktasıdır. `/v2/chat` adresindeki [Felo Arama API](https://openapi.felo.ai/tr/docs/api-reference/chat.md) Pro kredilerini kullanır ve farklı bir yanıt zarfına sahiptir.

## İstek

| Alan | Tür | Gerekli | Anlamı |
|---|---|---|---|
| `query` | string | Evet | Soru, 1–2.000 karakter |
| `accept_language` | string | Hayır | Tercih edilen yanıt dili; örneğin `en`, `ja` veya `zh-CN`; en fazla 64 karakter |
| `stream` | boolean | Hayır | `false` olmalıdır; varsayılan `false` |

2–8 harfli bir dil kodu ve isteğe bağlı tireyle ayrılmış alt etiketler içeren bir dil etiketi kullanın; örneğin `zh-TW`. Hizmet bu tercihi oluşturma isteğine ekler. Belirtilmezse, üst akış hizmeti dili seçer; sabit bir varsayılan yoktur ve İngilizce bir soru, İngilizce bir yanıtı garanti etmez. Tercih oluşturulan yanıt için geçerlidir; kaynak başlıkları ve alıntılar kendi orijinal dillerini korur.

Bu uç nokta akışsız JSON döndürür. `stream: true`, SSE, bir `messages` dizisi veya model seçimini desteklemez.

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

## Yanıt

HTTP 200, `status: "ok"` ve bir `data` nesnesi döndürür:

```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"]}
  }
}
```

| Alan | Anlamı |
|---|---|
| `data.answer` | Oluşturulan yanıt |
| `data.resources` | Başlıklar, bağlantılar ve özetlerle kaynak sayfalar |
| `data.query_analysis` | İsteğe bağlı sorgu analizi; null olabilir |
| `data.id`, `data.message_id` | Yanıt tanımlayıcıları |

Önce HTTP durumunu kontrol edin, ardından yanıtı ve kaynakları okuyun. `/v2/chat` ile yaptığınız gibi sayısal `status: 200` kontrolü yapmayın.

## Faturalandırma

`chat`, model belirteçleriyle değil istek başına faturalandırılır. [Güncel fiyatlara](https://openapi.felo.ai/api/v1/data/prices) ve [Faturalandırma ve Hatalar](https://openapi.felo.ai/tr/docs/data-api/guides/felo-billing.md) bölümüne bakın.