Editing Chuk Chat Backend and API

= Chuk Chat Backend and API =

This page explains the backend in practical terms.

== Base backend URL ==
https://api.chuk.chat

== Authentication model ==
Most endpoints require a Bearer token from your signed-in account session.

== Key endpoint groups ==
* '''Health''': service status
* '''Chat streaming''': SSE and WebSocket chat endpoints
* '''Model/config endpoints''': list models and configuration
* '''Media endpoints''': image generation, audio transcription, file conversion
* '''User endpoints''': status, billing, and account actions

== Streaming protocols ==
=== SSE (HTTP) ===
* Endpoint: POST /v1/ai/chat
* Great compatibility for browser-style request/response streaming

=== WebSocket ===
* Endpoint: /v1/ai/chat/ws
* Better for long-lived sessions and mobile stability

== Typical chat response events ==
* content chunks
* reasoning chunks (for reasoning-capable models)
* usage/tokens
* provider/model metadata
* done marker

== Rate limit examples ==
The backend includes request limits to protect stability, including separate limits for chat, audio transcription, and image generation.

== Billing-related backend flows ==
* checkout session creation
* customer portal session creation
* subscription sync endpoint

== Why this backend design exists ==
* Fast streaming UX
* Multi-provider AI routing
* Security and privacy controls
* Clear separation of chat, media, and billing responsibilities

== Related pages ==
* [[How Chuk Chat Works]]
* [[Chuk Chat Architecture]]
* [[Chuk Chat AI Providers and Services]]

[[Category:Chuk Chat]]
[[Category:Architecture]]