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

GET/voices/cartesia/clones/quota

Квота клонов голоса Cartesia владельца ключа до попытки создания: limit — потолок (правило тарифа, иначе запасной потолок 2; null, если проверка отказала раньше подсчёта — бан клонирования или no_subscription у сервиса, закрытого для оплаты с баланса), used — клоны в pending/cloning/ready, remaining — свободные места.

voices.read

Если создать клон сейчас нельзя, can_create равен false, а reason — тот же код, что вернуло бы создание: no_subscription, voice_clone_banned (причина в ban_reason) или voice_clone_quota_exceeded.

Если сервис закрыт для владельца ключа (закрытый тест), ответ — 404 с reason: service_not_found.

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

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

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

200

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

Пример тела
{
  "success": true,
  "message": "Success",
  "data": {
    "limit": 2,
    "used": 1,
    "remaining": 1,
    "can_create": true,
    "reason": null,
    "ban_reason": null
  }
}
Поля ответа
successобязательное

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

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

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

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

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

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

Действующий потолок клонов: правило тарифа, иначе запасной потолок 2. null, если проверка отказала раньше подсчёта (бан клонирования или no_subscription у сервиса, закрытого для оплаты с баланса).

может быть null
integer
usedобязательное

Сколько клонов держат место: в статусах pending, cloning и ready.

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

Свободные места: limit - used, не меньше 0; null, если limit равен null.

может быть null
integer
can_createобязательное

Можно ли создать клон прямо сейчас. false — причина в reason.

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

Код отказа, который вернуло бы создание: no_subscription, voice_clone_banned или voice_clone_quota_exceeded; null, если создать можно.

может быть null
string
ban_reasonобязательное

Причина блокировки клонирования при reason: voice_clone_banned, иначе null.

может быть null
string
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
404

Сервис Cartesia закрыт для владельца ключа (service_not_found)

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "Resource not found."
}
Поля ответа
successобязательное

Всегда false у ошибок.

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

Причина отказа словами, на языке аккаунта. Для показа пользователю; ветвиться по ней нельзя — формулировки меняются.

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

Машиночитаемая причина бизнес-отказа (например, input_expired, insufficient_balance). Ветвите обработку по ней, а не по тексту message.

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

Тот же машинный код, что в reason, — второе имя поля. Значения всегда совпадают.

string

Рядом

Соседние операции

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

Открыть .mdllm.md

спека 0.0.1