Open API

Send chat message (SSE)

Send message to AstrBot chat pipeline and receive streaming SSE response. Reuses /api/chat/send behavior. If session_id/conversation_id is omitted, server will create a new UUID session_id.

post/api/v1/chat

Request body

session_idstring

Optional chat session ID. If omitted (and conversation_id is also omitted), server creates a UUID automatically.

conversation_idstring

Alias of session_id.

usernamestring required

Target username.

selected_providerstring
selected_modelstring
enable_streamingboolean
config_idstring

Optional AstrBot config file ID. If provided, the chat session will use this config file. Use "default" to reset to default config.

config_namestring

Optional AstrBot config file name. Used only when config_id is not provided.

Response

SSE stream

Changes