---
title: "GET /orders/dubbing/options — Dubbing options"
url: https://lumean.app/tr/developers/docs/api/get-orders-dubbing-options
locale: tr
description: "Dubbing options"
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

**Dubbing options**

Which dubbing kinds are open to the key owner and how to order them. Kinds are in
`kinds`, keyed by the service of the source order: `cartesia` (the dub is the
`cartesia_dub` service) and `elevenlabs` (the dub is `elevenlabs_dub`). Each kind has:

- `available` — whether dubbing of this kind is open;
- `dub_service` — the dub service code (it is also the `task_type` of the created order);
- `languages` — allowed `target_language` values, `models` and `default_model` — allowed
  `model_id` values and the default model;
- `max_source_chars` — the cap on source characters;
- `price_factor` — how many times a dub costs more than voicing the same text with the
  source service (translation included): Cartesia — 1.35, ElevenLabs — 1.5;
- `maintenance` — dubbing of this kind is temporarily not accepted.

A closed kind is `available: false` with empty lists and zeros. The top-level fields
(except `kinds`) repeat the `cartesia` kind for compatibility with older clients.

**Required key permission:** `orders.read`.

- Gerekli izin: `orders.read`

## İstek

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

## Parametreler

| Alan | Yer | Tür | Zor. | Açıklama |
| --- | --- | --- | --- | --- |
| `X-Locale` | header | `string` | — | Language of the localised texts in the response (`message`, labels, failure reasons), an ISO-639-1 code. Optional; without it — the key owner’s account language, then `Accept-Language`, then the default language. An unknown or unsupported code is skipped as if it were absent. |
| `X-Timezone` | header | `string` | — | IANA time zone (`Europe/Moscow`) in which the response shows moments in time — ISO-8601 with an offset. Optional; without it dates come in UTC. An invalid zone is ignored. The server returns the applied zone in the response header of the same name. |

## İstek gövdesi

Gövde yok.

## Yanıtlar

### 200 — Dubbing options.

**Yanıt alanları**

| Alan | Tür | Zor. | Açıklama |
| --- | --- | --- | --- |
| `success` | `boolean` | zorunlu | Success flag. Branch on the HTTP status code instead: any 2xx response carries `true` here, while an error comes back in a different shape that need not contain this field at all. |
| `message` | `string` | zorunlu | A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code. |
| `data` | `object` | zorunlu | The response payload. |
| `data.available` | `boolean` | zorunlu | Whether dubbing of Cartesia orders is open (the `cartesia` kind; kept for older clients — use `kinds`). |
| `data.languages` | `array<string>` | zorunlu | Allowed `target_language` values of the `cartesia` kind. |
| `data.models` | `array<string>` | zorunlu | Allowed `model_id` values of the `cartesia` kind. |
| `data.default_model` | `string` | zorunlu | Default model of the `cartesia` kind. |
| `data.max_source_chars` | `integer` | zorunlu | Source character cap of the `cartesia` kind. |
| `data.price_factor` | `number` | zorunlu | How many times a Cartesia dub costs more than voicing the same text with Cartesia (translation included). |
| `data.maintenance` | `boolean` | zorunlu | `true` — Cartesia dubbing is temporarily not accepted. |
| `data.kinds` | `object` | zorunlu | Dubbing kinds keyed by the source order service (`cartesia`, `elevenlabs`). Each has `available`, `dub_service` (the dub service code, also the order `task_type`; `null` when closed), `languages`, `models`, `default_model`, `max_source_chars`, `price_factor`, `maintenance`. |
| `data.kinds.*` | `object` — rastgele anahtarlar | — |  |

**Örnek**

```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 — The key is missing, unknown, disabled or expired.

**Yanıt alanları**

| Alan | Tür | Zor. | Açıklama |
| --- | --- | --- | --- |
| `success` | `boolean` | zorunlu | Always `false` in error responses. |
| `message` | `string` | zorunlu | Error text in the key's language (set through the `X-Locale` header). |
| `data` | `null` — nullable | zorunlu | Always `null` when the request is rejected before processing. |

**Örnek**

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

### 403 — The key lacks the required permission, or the object belongs to another user.

**Yanıt alanları**

| Alan | Tür | Zor. | Açıklama |
| --- | --- | --- | --- |
| `success` | `boolean` | zorunlu | Always `false` in error responses. |
| `message` | `string` | zorunlu | Error text in the key's language (set through the `X-Locale` header). |

**Örnek**

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

---

- Bu sayfa tarayıcıda: https://lumean.app/tr/developers/docs/api/get-orders-dubbing-options
- Makine tarafından okunabilir tam başvuru: https://api.lumean.app/docs/llm.md