---
title: "GET /voices/cartesia/clones/quota — My Cartesia Voice Clone Quota"
url: https://lumean.app/tr/developers/docs/api/get-voices-cartesia-clones-quota
locale: tr
description: "My Cartesia Voice Clone Quota"
generated: 2026-10-17
operationId: cartesiaVoice.quota
method: GET
path: /voices/cartesia/clones/quota
scopes: [voices.read]
spec_version: 0.0.1
---

# GET /voices/cartesia/clones/quota

**My Cartesia Voice Clone Quota**

The key owner's Cartesia voice clone quota, before trying to create one: `limit` is the
cap (the plan's rule, otherwise the fallback cap of 2; `null` when the check refused
before counting — a clone ban, or `no_subscription` on a service closed to paying
from the balance), `used` is the clones in `pending`/`cloning`/`ready`, `remaining`
is the free slots.

When a clone cannot be created right now, `can_create` is `false` and `reason` is the
same code creation would return: `no_subscription`, `voice_clone_banned` (the cause
is in `ban_reason`) or `voice_clone_quota_exceeded`.

If the service is closed to the key owner (closed test), the answer is `404` with
`reason: service_not_found`.

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

- Gerekli izin: `voices.read`

## İstek

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

## Parametreler

Parametre yok.

## İstek gövdesi

Gövde yok.

## Yanıtlar

### 200 — Success. The payload is in `data`.

**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.limit` | `integer` — nullable | zorunlu | The effective clone cap: the plan's rule, otherwise the fallback cap of 2. `null` when the check refused before counting (a clone ban, or `no_subscription` on a service closed to paying from the balance). |
| `data.used` | `integer` | zorunlu | How many clones hold a slot: those in `pending`, `cloning` and `ready`. |
| `data.remaining` | `integer` — nullable | zorunlu | Free slots: `limit - used`, never below 0; `null` when `limit` is `null`. |
| `data.can_create` | `boolean` | zorunlu | Whether a clone can be created right now. `false` — the cause is in `reason`. |
| `data.reason` | `string` — nullable | zorunlu | The refusal code creation would return: `no_subscription`, `voice_clone_banned` or `voice_clone_quota_exceeded`; `null` when creation is possible. |
| `data.ban_reason` | `string` — nullable | zorunlu | The clone ban cause when `reason` is `voice_clone_banned`, otherwise `null`. |

**Örnek**

```json
{
  "success": true,
  "message": "Success",
  "data": {
    "limit": 2,
    "used": 1,
    "remaining": 1,
    "can_create": true,
    "reason": null,
    "ban_reason": null
  }
}
```

### 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 `voices.read` permission.

**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."
}
```

### 404 — The Cartesia service is closed to the key owner (`reason: service_not_found`).

**Yanıt alanları**

| Alan | Tür | Zor. | Açıklama |
| --- | --- | --- | --- |
| `success` | `boolean` | zorunlu | Always `false` in error responses. |
| `message` | `string` | zorunlu | The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes. |
| `reason` | `string` | zorunlu | Machine-readable reason of a business refusal (for example, `input_expired`, `insufficient_balance`). Branch on it, not on the `message` text. |
| `error_code` | `string` | zorunlu | The same machine-readable code as in `reason` — a second name for the field. The values always match. |

**Örnek**

```json
{
  "success": false,
  "message": "Resource not found."
}
```

---

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