https://wiki.chuk.dev/index.php?action=history&feed=atom&title=Chuk_Chat_Backend_and_API
Chuk Chat Backend and API - Revision history
2026-04-15T01:54:52Z
Revision history for this page on the wiki
MediaWiki 1.45.1
https://wiki.chuk.dev/index.php?title=Chuk_Chat_Backend_and_API&diff=25&oldid=prev
AI-Assistant: Add user-friendly backend and API architecture documentation
2026-03-13T18:09:09Z
<p>Add user-friendly backend and API architecture documentation</p>
<p><b>New page</b></p><div>= Chuk Chat Backend and API =<br />
<br />
This page explains the backend in practical terms.<br />
<br />
== Base backend URL ==<br />
https://api.chuk.chat<br />
<br />
== Authentication model ==<br />
Most endpoints require a Bearer token from your signed-in account session.<br />
<br />
== Key endpoint groups ==<br />
* '''Health''': service status<br />
* '''Chat streaming''': SSE and WebSocket chat endpoints<br />
* '''Model/config endpoints''': list models and configuration<br />
* '''Media endpoints''': image generation, audio transcription, file conversion<br />
* '''User endpoints''': status, billing, and account actions<br />
<br />
== Streaming protocols ==<br />
=== SSE (HTTP) ===<br />
* Endpoint: POST /v1/ai/chat<br />
* Great compatibility for browser-style request/response streaming<br />
<br />
=== WebSocket ===<br />
* Endpoint: /v1/ai/chat/ws<br />
* Better for long-lived sessions and mobile stability<br />
<br />
== Typical chat response events ==<br />
* content chunks<br />
* reasoning chunks (for reasoning-capable models)<br />
* usage/tokens<br />
* provider/model metadata<br />
* done marker<br />
<br />
== Rate limit examples ==<br />
The backend includes request limits to protect stability, including separate limits for chat, audio transcription, and image generation.<br />
<br />
== Billing-related backend flows ==<br />
* checkout session creation<br />
* customer portal session creation<br />
* subscription sync endpoint<br />
<br />
== Why this backend design exists ==<br />
* Fast streaming UX<br />
* Multi-provider AI routing<br />
* Security and privacy controls<br />
* Clear separation of chat, media, and billing responsibilities<br />
<br />
== Related pages ==<br />
* [[How Chuk Chat Works]]<br />
* [[Chuk Chat Architecture]]<br />
* [[Chuk Chat AI Providers and Services]]<br />
<br />
[[Category:Chuk Chat]]<br />
[[Category:Architecture]]</div>
AI-Assistant