Bu endpoint özel bir rate limit (flexy-chat throttle) ile korunmaktadır. Limit aşıldığında 429 Too Many Requests yanıtı döner.
Endpoint özeti
| Metot | Endpoint | Açıklama |
|---|
POST | /api/v1/flexy-chat/stream | AI ile streaming sohbet başlatır |
Tüm parametreler ve örnek istek/yanıtlar için API Referansı sekmesine bakın. Flexy Chat kavramı
Flexy Chat, yapay zekaya bir prompt ve isteğe bağlı konuşma geçmişi (history) göndermenize olanak tanır. Yanıt, Server-Sent Events (SSE) formatında text/event-stream olarak akar — tüm yanıtın bitmesi beklenmez, token’lar geldikçe işlenebilir.
İş kuralları
history alanı: Önceki konuşma bağlamını aktarmak için kullanılır. Maksimum 20 mesaj gönderilebilir. Her mesaj role (user veya assistant) ve content alanlarını içermelidir.
prompt limiti: Minimum 1, maksimum 2000 karakter. Aşılırsa 422 Unprocessable Entity döner.
SSE Event akışı
Yanıt aşağıdaki sırayla event’ler gönderir:
| Event | Açıklama | Data içeriği |
|---|
stream_start | Stream açıldı | model, provider |
step_start | Adım başladı | — |
text_start | Metin bloğu başladı | message_id |
text_delta | Token chunk geldi (asıl içerik) | delta (metin parçası), message_id |
text_complete | Metin bloğu tamamlandı | message_id |
step_finish | Adım bitti | — |
stream_end | Stream kapandı | finish_reason, usage (token sayıları) |
İstemci tarafında gerçek zamanlı metin göstermek için text_delta event’lerini dinleyin ve delta alanını birleştirin. Stream bittikten sonra stream_end içindeki usage ile token tüketimini takip edebilirsiniz.
Yetkilendirme
FlexyChat endpoint’inde rol tabanlı izin kontrolü (ViewAny:Resource vb.) uygulanmaz — erişim kontrolü tamamen token scope + throttle seviyesindedir. middleware('tenant') gerektirdiğinden aktif bir tenant bağlamı zorunludur.
Token scope’ları (Passport)
| İşlem | Scope |
|---|
Streaming (stream) | flexy_chat:write |
flexy_chat:read scope’u yoktur — yalnızca flexy_chat:write kullanılır.
Throttle
| Throttle | Endpoint | Açıklama |
|---|
throttle:flexy-chat | POST /flexy-chat/stream | FlexyChat’e özgü özel rate limit kuralı |
