Сервисы и их возможности
Карта code → описание всех сервисов, доступных вам. По ней клиент узнаёт, какие
сервисы есть, принимают ли они заказы и что умеют, — без списка сервисов в своём коде.
status— принимает ли сервис заказы прямо сейчас.state:available,maintenance(техобслуживание,message— сообщение администратора) илиdisabled(сервис отключён). Отключённый сервис остаётся в ответе соstatus: false.type—tts,dubbing,image,sfx,music,voice_clone,voice_searchилиother.capabilities—templates(можно создать шаблон, схема —GET /template-services/config?service=<code>),voice_libraryиvoice_filters(голоса —GET /voices?provider=<voice_provider>, фильтры —GET /voices/filters?provider=<voice_provider>),voice_clone(клоны —/voices/<clone_provider>/clones),dubbing(у сервиса есть дубляж, его код —dubbing_service, или это сам сервис дубляжа).health— стабильность, скорость и очередь со страницы статуса;nullу сервиса, которого там нет (закрытый тест, отключён).order— порядок показа.
Сервисы закрытого теста видны только участникам теста.
Требуемое право ключа: любое из templates.read, orders.read, voices.read.
Параметры
Значения подставляются прямо в строку запроса, и URL собирается сам. Ниже — тип, обязательность и допустимые значения каждого параметра.
Возможные ответы
200Успех. Полезная нагрузка — в поле data.
Успех. Полезная нагрузка — в поле data.
{
"success": true,
"message": "Services retrieved.",
"data": {
"elevenlabs": {
"code": "elevenlabs",
"name": "ElevenLabs",
"type": "tts",
"order": 1,
"access": "public",
"status": true,
"state": "available",
"message": null,
"maintenance": {
"enabled": false,
"since": null,
"message": null
},
"capabilities": {
"templates": true,
"voice_library": true,
"voice_filters": true,
"voice_clone": false,
"dubbing": true
},
"task_types": [
"tts"
],
"voice_provider": "elevenlabs",
"clone_provider": null,
"dubbing_service": "elevenlabs_dub",
"health": {
"status": "operational",
"stability_index": 98,
"latency_seconds": 4.1,
"latency_unit": "chunk",
"error_level": "normal",
"queue": {
"state": "few",
"approx": null,
"wait_seconds": 30,
"load": "low"
}
}
},
"cartesia": {
"code": "cartesia",
"name": "Cartesia",
"type": "tts",
"order": 3,
"access": "public",
"status": false,
"state": "maintenance",
"message": "The service is under maintenance.",
"maintenance": {
"enabled": true,
"since": "2026-11-07T10:15:00+03:00",
"message": "The service is under maintenance."
},
"capabilities": {
"templates": true,
"voice_library": true,
"voice_filters": true,
"voice_clone": true,
"dubbing": true
},
"task_types": [
"tts"
],
"voice_provider": "cartesia",
"clone_provider": "cartesia",
"dubbing_service": "cartesia_dub",
"health": {
"status": "maintenance",
"stability_index": null,
"latency_seconds": null,
"latency_unit": "chunk",
"error_level": "normal",
"queue": {
"state": "none",
"approx": null,
"wait_seconds": null,
"load": "low"
}
}
}
}
}Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь true, а ошибка приходит телом другой формы, где этого поля может не быть вовсе.
Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются.
dataобязательноеПолезная нагрузка ответа.
object
Полезная нагрузка ответа.
401Невалидный или отсутствующий X-API-KEY
Невалидный или отсутствующий X-API-KEY
{
"success": false,
"message": "API key is missing. Provide it in the X-API-KEY header.",
"data": null
}Всегда false в ответах об ошибке.
Текст ошибки на языке ключа (задаётся заголовком X-Locale).
Всегда null, когда запрос отклонён до обработки.
403У ключа нет ни одного из прав templates.read, orders.read, voices.read
У ключа нет ни одного из прав templates.read, orders.read, voices.read
{
"success": false,
"message": "This API key does not have permission to perform this action."
}Всегда false в ответах об ошибке.
Текст ошибки на языке ключа (задаётся заголовком X-Locale).
Рядом
Об этом словами
Эта страница для ИИ
версия API 1.0.0