---
title: Realtime
url: https://lumean.app/developers/docs/realtime
locale: ru
description: "WebSocket-каналы: подключение, авторизация приватного канала и события заказа."
generated: 2026-11-08
spec_version: 1.0.0
---

# Realtime

WebSocket-каналы: подключение, авторизация приватного канала и события заказа.

## Подключение

## Public WebSocket API (X-API-KEY) Real-time события заказов и клонов голоса Cartesia и Fish Audio для клиентов Public API. Протокол — Pusher-совместимый,
подходят стандартные библиотеки: **pusher-js** или **Laravel Echo**. ### Подключение | Параметр | Значение |
| --- | --- |
| Хост / порт / схема | `ws.lumean.app` / `443` / `wss` (TLS обязателен) |
| App key (публичный) | `7c4dd881d8116ac76fe89aff71d8c2ff` |
| Auth-эндпоинт | `POST https://api.lumean.app/api/public/broadcasting/auth` | ```js
import Pusher from 'pusher-js'; const pusher = new Pusher('7c4dd881d8116ac76fe89aff71d8c2ff', { wsHost: 'ws.lumean.app', wsPort: 443, wssPort: 443, forceTLS: true, enabledTransports: ['ws', 'wss'], cluster: '', channelAuthorization: { endpoint: 'https://api.lumean.app/api/public/broadcasting/auth', headers: { 'X-API-KEY': 'ВАШ_API_КЛЮЧ' }, },
}); const ch = pusher.subscribe('private-orders.42'); // 42 = ID владельца ключа
ch.bind('status.changed', (e) => console.log(e.new_status, e.order.id));
``` ### Авторизация подписки Приватные каналы (`private-*`) требуют авторизации: клиентская библиотека
автоматически шлёт `POST https://api.lumean.app/api/public/broadcasting/auth` с заголовком
`X-API-KEY` и подставляет полученный токен сама. Право ключа зависит от канала:
каналы заказов и превью чанков — `orders.read`, клоны голоса Cartesia и Fish Audio
(`private-cartesia-voice-clones.{userId}`, `private-fishaudio-voice-clones.{userId}`) — `voices.read`, подарочные коды реселлера
(`private-giftcodes.{userId}`) — `reseller.read`. Подписаться можно
только на свои каналы (иначе `403`). > Имена событий: в pusher-js — без ведущей точки (`bind('status.changed')`), в
> Laravel Echo — с точкой (`.listen('.status.changed')`). Каналы, события и схемы payload — в секциях ниже.

- host: `ws.lumean.app`
- port: `443`
- scheme: `wss`
- app key: `7c4dd881d8116ac76fe89aff71d8c2ff`
- auth endpoint: `https://api.lumean.app/api/public/broadcasting/auth`

## Авторизация приватного канала

`POST /broadcasting/auth` — Авторизовать подписку на WebSocket-канал

## Каналы

| Поле | Право ключа | События | Страница |
| --- | --- | --- | --- |
| `private-orders.{userId}` | `orders.read` | 15 | [orders](https://lumean.app/developers/docs/md/realtime/orders) |
| `private-order.task.{orderId}` | `orders.read` | 9 | [order-task](https://lumean.app/developers/docs/md/realtime/order-task) |
| `private-chunks.preview.{userId}` | `orders.read` | 1 | [chunks-preview](https://lumean.app/developers/docs/md/realtime/chunks-preview) |
| `private-cartesia-voice-clones.{userId}` | `voices.read` | 1 | [cartesia-voice-clones](https://lumean.app/developers/docs/md/realtime/cartesia-voice-clones) |
| `private-fishaudio-voice-clones.{userId}` | `voices.read` | 1 | [fishaudio-voice-clones](https://lumean.app/developers/docs/md/realtime/fishaudio-voice-clones) |
| `private-giftcodes.{userId}` | `reseller.read` | 4 | [giftcodes](https://lumean.app/developers/docs/md/realtime/giftcodes) |

---

- Эта же страница в браузере: https://lumean.app/developers/docs/realtime
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md