К содержанию
Lumean
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.

Параметры

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

GEThttps://api.lumean.app/api/public/services

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

    200

    Успех. Полезная нагрузка — в поле 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"
            }
          }
        }
      }
    }
    Поля ответа
    successобязательное

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

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

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

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

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

    object
    *необязательное
    произвольные ключи
    object
    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

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

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

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

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

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

    string

    Эта страница для ИИ

    Открыть .mdllm.md

    версия API 1.0.0