---
title: "private-chunks.preview.{userId}"
url: https://lumean.app/developers/docs/realtime/chunks-preview
locale: ru
description: "Результат фонового расчёта превью разбиения текста на чанки. Приходит для больших текстов, отправленных в `POST /orders/chunks/preview`."
generated: 2026-11-08
scopes: [orders.read]
spec_version: 1.0.0
---

# private-chunks.preview.{userId}

Результат фонового расчёта превью разбиения текста на чанки. Приходит для больших текстов, отправленных в `POST /orders/chunks/preview`.

- Право ключа: `orders.read`

## Параметры канала

| Поле | Тип | Описание | Пример |
| --- | --- | --- | --- |
| `userId` | `integer` | числовой идентификатор владельца ключа, его отдаёт `GET /user`. | `42` |

## События

### `.ready` — Ready

Async-превью готово — ограниченное уведомление: итоги по всему тексту (`summary`) и мета первой страницы (`page`). Сами чанки в это событие не входят — их нужно отдельно запросить через `GET /orders/chunks/preview/{previewId}?page=1`.

**Payload**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `status` | `string` — `ready` | обяз. |  |
| `preview_id` | `string` | обяз. | Контентный идентификатор превью (sha256 от текста+шаблона+режима). Используйте для пагинации (`GET .../{previewId}`) и повторного preflight-запроса. |
| `summary` | `object` | обяз. | Итоги по всему тексту — не только по текущей странице чанков. |
| `summary.chunks_count` | `integer` | — |  |
| `summary.total_effective_length` | `integer` | — | Суммарная billable-длина по всем чанкам, в символах (паузы не считаются). |
| `summary.total_price_units` | `integer` | — |  |
| `summary.pause_count` | `integer` | — |  |
| `summary.total_pause_seconds` | `number` | — |  |
| `summary.caps_ok` | `boolean` | — |  |
| `summary.caps_exceeded` | `string \| null` — `count` · `single` · `total` · `chunks` · `null` | — |  |
| `summary.paragraphs_count` | `integer \| null` | — | Число абзацев, или `null` вне абзацного режима. |
| `summary.paragraphs` | `array<object> \| null` | — | Агрегат по абзацам. `null` означает либо «превью не абзацное», либо «абзацев больше лимита broadcast-payload» — во втором случае `paragraphs_count` остаётся числом, а полный список абзацев берите через `GET /orders/chunks/preview/{previewId}`. |
| `summary.paragraphs.paragraph_index` | `integer` | — |  |
| `summary.paragraphs.chunks_count` | `integer` | — |  |
| `summary.paragraphs.first_chunk_index` | `integer` | — | Сквозной номер первого чанка абзаца — по нему абзац находится в постраничном списке чанков. |
| `summary.paragraphs.text_length` | `integer` | — |  |
| `summary.paragraphs.effective_length` | `integer` | — |  |
| `summary.paragraphs.price_units` | `integer` | — |  |
| `page` | `object` | обяз. | Мета первой страницы чанков. Сами чанки — отдельным `GET`-запросом с пагинацией по `preview_id`. |
| `page.current_page` | `integer` | — |  |
| `page.per_page` | `integer` | — |  |
| `page.total` | `integer` | — | Всего чанков в разбиении (по всем страницам). |
| `page.has_more` | `boolean` | — |  |

---

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