Ошибки

Ошибки приходят в JSON со стабильным code и человекочитаемым message:

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance for this request."
  }
}

Коды ответов

Код	`code`	Когда
`401`	`unauthorized`	Ключа нет, он неверный или отозван
`403`	`client_disabled`	Аккаунт неактивен
`403`	`email_not_verified`	Почта аккаунта не подтверждена — перейдите по ссылке из письма в личном кабинете
`402`	`insufficient_balance`	Не хватает баланса (с учётом овердрафта)
`422`	`invalid_request`	Кривое тело запроса, в том числе `previous_text` или `next_text` длиннее 10 000 символов
`422`	`unknown_voice` / `unknown_format`	Неизвестное значение параметра
`422`	`voice_not_ready`	Голос ещё обучается и недоступен для синтеза
`422`	`voice_quota_exceeded`	Достигнут лимит private-голосов
`422`	`file_too_large`	Аудиофайл превышает лимит загрузки
`422`	`text_too_long`	Текст длиннее 10 000 символов
`422`	`unsupported_language`	Только если на сервере включён языковой фильтр: в тексте есть буквы не русского и не английского алфавита
`422`	`content_rejected`	Текст содержит контент, запрещённый к озвучке
`429`	`concurrency_limit`	Слишком много одновременных запросов для аккаунта
`5xx`	`synthesis_failed`	Временная проблема синтеза — повторите чуть позже
`5xx`	`service_unavailable`	Временная проблема в операциях с голосами — повторите чуть позже

Текст принимается на любом языке и любой письменности. Ошибка unsupported_language возможна только в конфигурации с включённым языковым фильтром (LANGUAGE_FILTER_ENABLED=true) — тогда допускаются только русские и английские буквы.

Начало работы

Руководства

Справочник

Коды ответов

​Коды ответов

Коды ответов