Struct RealtimeClient 

pub struct RealtimeClient { /* private fields */ }

Available on crate feature realtime only.

Entry point for the realtime API.

Construct with RealtimeClient::new, optionally switch to JWT auth via RealtimeClient::with_jwt, then start a session with RealtimeClient::session.

use zai_rs::{model::GLM_realtime_flash, realtime::RealtimeClient};

let session = RealtimeClient::new(key)
    .session(GLM_realtime_flash {})
    .build()
    .await?;

Implementations

impl RealtimeClient

pub fn new(api_key: impl Into<String>) -> Self

Create a realtime client using Bearer auth and the default endpoints.

pub fn with_jwt(self, ttl_seconds: i64) -> Self

Switch to JWT auth, signing tokens valid for ttl_seconds.

The value is validated when the session is built and must be between one second and seven days, inclusive.

pub fn with_bearer(self) -> Self

Switch (back) to server-side Bearer auth.

pub fn with_endpoint_config(self, config: EndpointConfig) -> Self

Override the full endpoint config (base URLs).

pub fn try_with_realtime_base(self, base: impl AsRef<str>) -> ZaiResult<Self>

Override only the realtime base URL (wss://...).

Only the realtime family is replaced; all other endpoint overrides are preserved. Invalid or insecure public URLs return an error.

pub fn session<M: RealtimeModel>(&self, model: M) -> SessionBuilder

Begin building a realtime session for model.

The model bound is checked at compile time via super::RealtimeModel.

pub fn realtime_url(&self) -> String

The resolved realtime WebSocket URL.

pub fn auth(&self) -> &AuthMode

Current auth mode.

Trait Implementations

impl Clone for RealtimeClient

fn clone(&self) -> RealtimeClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RealtimeClient

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.