---
title: "private-fishaudio-voice-clones.{userId}"
url: https://lumean.app/developers/docs/realtime/fishaudio-voice-clones
locale: ru
description: "Ход клонирования ваших голосов Fish Audio: событие на каждое изменение статуса клона, созданного через `POST /voices/fishaudio/clones` (или в кабинете). Право ключа — `voices.read`."
generated: 2026-10-17
scopes: [voices.read]
spec_version: 0.0.1
---

# private-fishaudio-voice-clones.{userId}

Ход клонирования ваших голосов Fish Audio: событие на каждое изменение статуса клона, созданного через `POST /voices/fishaudio/clones` (или в кабинете). Право ключа — `voices.read`.

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

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

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

## События

### `.voice_clone.updated` — Voice clone updated

Клон голоса Fish Audio создан или сменил статус (`pending` → `cloning` → `ready` либо `failed`; `archived` после удаления; `banned` — заблокирован модератором). `voice_id` появляется только у `ready` — его кладут в `tts_settings.voice_id` шаблона Fish Audio.

**Payload**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `voice_clone` | `object` | обяз. |  |
| `voice_clone.id` | `string (uuid)` | обяз. |  |
| `voice_clone.provider` | `string` — `fishaudio` | обяз. |  |
| `voice_clone.display_name` | `string` | обяз. |  |
| `voice_clone.language` | `string \| null` | — |  |
| `voice_clone.description` | `string \| null` | — |  |
| `voice_clone.status` | `string` — `pending` · `cloning` · `ready` · `failed` · `archived` · `banned` | обяз. | Статус клона. `banned` — клон заблокирован модератором: в новые заказы не берётся и не удаляется, причина — в `ban_reason`. |
| `voice_clone.voice_id` | `string \| null` | обяз. | Идентификатор голоса Fish Audio (строка из 32 hex-символов, не UUID) — значение для `tts_settings.voice_id` шаблона. Есть только у клона в статусе `ready`, иначе `null`. |
| `voice_clone.attempts` | `integer` | обяз. |  |
| `voice_clone.error` | `object \| null` | обяз. |  |
| `voice_clone.error.reason` | `string` | — | processing_error, max_retries, network, timeout, dispatch_failed, unbanned |
| `voice_clone.error.message` | `string \| null` | — |  |
| `voice_clone.created_at` | `string (date-time)` | обяз. |  |
| `voice_clone.completed_at` | `string (date-time) \| null` | — |  |
| `voice_clone.failed_at` | `string (date-time) \| null` | — |  |
| `voice_clone.banned_at` | `string (date-time) \| null` | — |  |
| `voice_clone.ban_reason` | `string \| null` | — | Причина блокировки клона модератором либо `null`. |

---

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