К содержанию
Lumean API

GET/voices/cartesia/clones

Клоны голоса Cartesia владельца ключа, новые сверху. Архивные в список не входят — только с status=archived.

voices.read

У клона в статусе ready есть voice_id — его кладут в tts_settings.voice_id шаблона Cartesia. Пока клон pending/cloning, voice_id равен null.

Список работает без проверки подписки: истёкшая подписка созданные клоны не прячет.

Требуемое право ключа: voices.read.

На этой странице(3)

Параметры

Поля ввода живут прямо в строке запроса: подставьте значение — и получите готовый URL. Ниже — тип, обязательность и допустимые значения каждого параметра.

GEThttps://api.lumean.app/api/public/voices/cartesia/clones
  • CartesiaVoiceCloneStatusв queryнеобязательный

    Только клоны в этом статусе. Без параметра — все, кроме archived; архивные видны только с status=archived.

    Допустимые значения
  • stringв queryнеобязательный≤ 255 симв.

    Поиск по названию клона (display_name).

  • integerв queryнеобязательный≥ 1

    Номер страницы, начиная с 1.

  • integerв queryнеобязательный1..100

    Сколько записей вернуть на странице. Метаданные пагинации лежат рядом с items: current_page, last_page, per_page, total.

Возможные ответы

200

Успех. Полезная нагрузка — в поле data.

Пример тела
{
  "success": true,
  "message": "Success",
  "data": {
    "items": [
      {
        "id": "01a10e08-2ee3-73c2-88b2-8df2bcef9d1d",
        "provider": "cartesia",
        "display_name": "Narrator (my voice)",
        "language": "ru",
        "description": null,
        "status": "ready",
        "voice_id": "6afd76cb-2663-46f7-8f74-85221ce58c56",
        "attempts": 1,
        "error": null,
        "created_at": "2026-10-05T18:02:11+00:00",
        "completed_at": "2026-10-05T18:03:40+00:00",
        "failed_at": null,
        "banned_at": null,
        "ban_reason": null
      },
      {
        "id": "01a10e08-2ee5-702c-b492-243c88fd966f",
        "provider": "cartesia",
        "display_name": "Noisy sample",
        "language": "ru",
        "description": null,
        "status": "failed",
        "voice_id": null,
        "attempts": 1,
        "error": {
          "reason": "processing_error",
          "message": "The provider rejected the sample."
        },
        "created_at": "2026-10-05T17:40:02+00:00",
        "completed_at": null,
        "failed_at": "2026-10-05T17:41:15+00:00",
        "banned_at": null,
        "ban_reason": null
      }
    ],
    "current_page": 1,
    "last_page": 1,
    "per_page": 20,
    "total": 2
  }
}
Поля ответа
successобязательное

Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь true, а ошибка приходит телом другой формы, где этого поля может не быть вовсе.

boolean
messageобязательное

Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются.

string
dataобязательное

Полезная нагрузка ответа.

object
itemsобязательное

Ваши клоны голоса Cartesia на этой странице, новые сверху.

array<CartesiaVoiceClone>CartesiaVoiceClone
элемент массива
idобязательное

UUID клона. Его подставляют в пути /voices/cartesia/clones/{voiceClone}/…; в шаблон он НЕ идёт — туда идёт voice_id.

string
providerобязательное

Провайдер клона — всегда cartesia.

Значенияcartesia
string
display_nameобязательное

Название клона, заданное при создании.

string
languageобязательное

Язык образца (ISO 639-1) либо null, если не передавался.

string
descriptionобязательное

Ваше описание клона либо null.

string
statusобязательное

Статус: pending → cloning → ready либо failed; archived — снят владельцем; banned — заблокирован модератором. Озвучивать можно только ready.

string
voice_idобязательное

Идентификатор голоса Cartesia — значение для tts_settings.voice_id шаблона с service_key: cartesia. Есть только у ready, иначе null.

string
attemptsобязательное

Номер попытки клонирования: 1 при создании, +1 за каждый повтор.

integer
errorобязательное

Причина отказа последней попытки; null, пока отказа не было.

может быть null
object
reasonобязательное

Машинный код отказа: processing_error, max_retries, network, timeout, dispatch_failed. Повторить попытку — POST /voices/cartesia/clones/{voiceClone}/retry; если processing_error повторяется, смените образец.

string
messageобязательное

Пояснение к отказу для человека либо null. Ветвитесь по reason, а не по тексту.

string
created_atобязательное

Когда клон создан.

string
completed_atобязательное

Когда клон стал ready; null до этого.

string
failed_atобязательное

Когда последняя попытка завершилась отказом; null, если отказа нет.

string
banned_atобязательное

Когда клон заблокирован модератором (status = banned); null, если блокировки нет.

string
ban_reasonобязательное

Причина блокировки от модератора либо null. Заблокированный клон нельзя ни использовать, ни архивировать.

string
current_pageобязательное

Номер текущей страницы, с единицы.

integer
last_pageобязательное

Номер последней страницы.

integer
per_pageобязательное

Размер страницы, применённый сервером.

integer
totalобязательное

Сколько записей всего по фильтру.

integer
401

Невалидный или отсутствующий X-API-KEY

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Поля ответа
successобязательное

Всегда false в ответах об ошибке.

boolean
messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string
dataобязательное

Всегда null, когда запрос отклонён до обработки.

может быть null
null
403

У ключа нет права voices.read

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
Поля ответа
successобязательное

Всегда false в ответах об ошибке.

boolean
messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string
422

Ошибка валидации. Поля с ошибками перечислены в errors.

Разобрать этот ответ
Пример тела
{
  "message": "string",
  "errors": {}
}
Поля ответа
messageобязательное

Errors overview.

string
errorsобязательное

A detailed description of each field that failed validation.

object
*необязательное
произвольные ключи
array<string>

Рядом

Объекты

Скормить страницу ИИ

Открыть .mdllm.md

спека 0.0.1