---
title: "GET /orders/dubbing/options — Справочник дубляжа"
url: https://lumean.app/developers/docs/api/get-orders-dubbing-options
locale: ru
description: "Справочник дубляжа"
generated: 2026-11-08
operationId: dubbing.options
method: GET
path: /orders/dubbing/options
scopes: [orders.read]
spec_version: 1.0.0
---

# GET /orders/dubbing/options

**Справочник дубляжа**

Какие виды дубляжа открыты владельцу ключа и чем их заказывать. Виды — в `kinds` по
сервису исходного заказа: `cartesia` (дубль — сервис `cartesia_dub`) и `elevenlabs`
(дубль — `elevenlabs_dub`). У каждого вида:

- `available` — открыт ли дубляж этого вида;
- `dub_service` — код сервиса дубля (он же `task_type` созданного заказа);
- `languages` — допустимые `target_language`, `models` и `default_model` — допустимые
  `model_id` и модель по умолчанию;
- `max_source_chars` — потолок символов исходника;
- `price_factor` — во сколько раз дубль дороже озвучки того же текста исходным сервисом
  (перевод включён): Cartesia — 1,35, ElevenLabs — 1,5;
- `maintenance` — приём дубляжа этого вида временно приостановлен.

Закрытый вид — `available: false`, пустые списки и нули. Поля верхнего уровня (кроме
`kinds`) повторяют вид `cartesia` — для совместимости со старыми клиентами.

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

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

## Запрос

```bash
curl -X GET 'https://api.lumean.app/api/public/orders/dubbing/options' \
  -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 — Справочник дубляжа

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

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь `true`, а ошибка приходит телом другой формы, где этого поля может не быть вовсе. |
| `message` | `string` | обяз. | Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются. |
| `data` | `object` | обяз. | Полезная нагрузка ответа. |
| `data.available` | `boolean` | обяз. | Открыт ли дубляж заказов Cartesia (вид `cartesia`; поле для старых клиентов — смотрите `kinds`). |
| `data.languages` | `array<string>` | обяз. | Допустимые `target_language` вида `cartesia`. |
| `data.models` | `array<string>` | обяз. | Допустимые `model_id` вида `cartesia`. |
| `data.default_model` | `string` | обяз. | Модель по умолчанию вида `cartesia`. |
| `data.max_source_chars` | `integer` | обяз. | Потолок символов исходника вида `cartesia`. |
| `data.price_factor` | `number` | обяз. | Во сколько раз дубль Cartesia дороже озвучки Cartesia того же текста (перевод включён). |
| `data.maintenance` | `boolean` | обяз. | `true` — приём дубляжа Cartesia временно приостановлен. |
| `data.kinds` | `object` | обяз. | Виды дубляжа по сервису исходного заказа (`cartesia`, `elevenlabs`). У каждого: `available`, `dub_service` (код сервиса дубля, он же `task_type` заказа; `null` у закрытого), `languages`, `models`, `default_model`, `max_source_chars`, `price_factor`, `maintenance`. |
| `data.kinds.*` | `object` — произвольные ключи | — |  |

**Пример**

```json
{
  "success": true,
  "message": "string",
  "data": {
    "available": true,
    "languages": [
      "string"
    ],
    "models": [
      "string"
    ],
    "default_model": "string",
    "max_source_chars": 1,
    "price_factor": 1,
    "maintenance": true,
    "kinds": {
      "key": []
    }
  }
}
```

### 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 — У ключа нет права orders.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-orders-dubbing-options
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md