---
title: "GET /services — Сервисы и их возможности"
url: https://lumean.app/developers/docs/api/get-services
locale: ru
description: "Сервисы и их возможности"
generated: 2026-11-17
operationId: serviceCatalog.index
method: GET
path: /services
scopes: ["templates.read|orders.read|voices.read"]
spec_version: 1.0.0
---

# GET /services

**Сервисы и их возможности**

Карта `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`.

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

## Запрос

```bash
curl -X GET 'https://api.lumean.app/api/public/services' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'
```

## Параметры

| Поле | Где | Тип | Обяз. | Описание |
| --- | --- | --- | --- | --- |
| `X-Locale` | header | `string` | — | Язык локализованных текстов ответа (`message`, подписи, причины ошибок), код ISO-639-1. Необязателен; без него — язык аккаунта владельца ключа, затем `Accept-Language`, затем язык по умолчанию. Неизвестный или неподдерживаемый код пропускается так же, как отсутствующий. |
| `X-Timezone` | header | `string` | — | IANA-зона (`Europe/Moscow`), в которой ответ показывает моменты времени — ISO-8601 со смещением. Необязателен; без него даты приходят в UTC. Невалидная зона игнорируется. Применённую зону сервер возвращает в одноимённом заголовке ответа. |

## Тело запроса

Тела нет.

## Ответы

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

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь `true`, а ошибка приходит телом другой формы, где этого поля может не быть вовсе. |
| `message` | `string` | обяз. | Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются. |
| `data` | `object` | обяз. | Полезная нагрузка ответа. |
| `data.*` | `object` — произвольные ключи | — |  |

**Пример**

```json
{
  "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"
        }
      }
    }
  }
}
```

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

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Всегда `false` в ответах об ошибке. |
| `message` | `string` | обяз. | Текст ошибки на языке ключа (задаётся заголовком `X-Locale`). |
| `data` | `null` — nullable | обяз. | Всегда `null`, когда запрос отклонён до обработки. |

**Пример**

```json
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
```

### 403 — У ключа нет ни одного из прав templates.read, orders.read, voices.read

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Всегда `false` в ответах об ошибке. |
| `message` | `string` | обяз. | Текст ошибки на языке ключа (задаётся заголовком `X-Locale`). |

**Пример**

```json
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
```

---

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