Skip to main content
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

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:
İ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)

flexy_chat:read scope’u yoktur — yalnızca flexy_chat:write kullanılır.

​
Throttle