Zum Inhalt
Lumean

Beschreibungen auf Englisch

Die Oberfläche des Bereichs ist in Ihre Sprache übersetzt, Beschreibungen von Operationen, Schemata und Fehlern gibt es aber nur auf Russisch und Englisch — hier wird die englische Fassung angezeigt.
GET/voices/{provider}/clones

My Voice Clones

The key owner's voice clones of the chosen provider (provider: cartesia or fishaudio), newest first. Archived clones are left out unless you pass status=archived.

A clone in ready carries a voice_id — put it into tts_settings.voice_id of a template of the same provider (Cartesia or Fish Audio). While the clone is pending/cloning, voice_id is null.

The list does not check the subscription: an expired subscription never hides the clones already created.

Required key permission: voices.read.

Parameter

Werte werden direkt in die Anfragezeile eingesetzt, und die URL entsteht von selbst. Darunter stehen Typ, Pflichtangabe und zulässige Werte jedes Parameters.

GEThttps://api.lumean.app/api/public/voices//clones
  • stringim Pfaderforderlich

    Voice provider whose clones you work with: cartesia or fishaudio. Any other value does not match the route (404). The clone cap, the subscription rule and the clone ids are separate for each provider.

    Der Wert wird direkt in die Anfragezeile oben eingesetzt.

    Zulässige Werte
  • stringin der Queryoptional≤ 32 Zeichen

    Only clones in this status: review, pending, cloning, ready, failed, archived or banned. Without it — everything except archived; archived clones show up only with status=archived.

    Zulässige Werte
  • integerin der Queryoptional≥ 1

    Page number, starting at 1.

  • integerin der Queryoptional1..100

    How many records to return per page. The page meta sits in data next to the items list: current_page, last_page, per_page, total.

Mögliche Antworten

200

Success. The payload is in data.

Beispiel für den Body
{
  "success": true,
  "message": "Success",
  "data": {
    "items": [
      {
        "id": "01a10e08-2ee3-73c2-88b2-8df2bcef9d1d",
        "provider": "cartesia",
        "display_name": "Narrator (my voice)",
        "language": "ru",
        "description": null,
        "status": "ready",
        "voice_id": "6afd76cb-2663-46f7-8f74-85221ce58c56",
        "attempts": 1,
        "error": null,
        "created_at": "2026-10-05T18:02:11+00:00",
        "completed_at": "2026-10-05T18:03:40+00:00",
        "failed_at": null,
        "banned_at": null,
        "ban_reason": null
      },
      {
        "id": "01a10e08-2ee5-702c-b492-243c88fd966f",
        "provider": "cartesia",
        "display_name": "Noisy sample",
        "language": "ru",
        "description": null,
        "status": "failed",
        "voice_id": null,
        "attempts": 1,
        "error": {
          "reason": "processing_error",
          "message": "The provider rejected the sample."
        },
        "created_at": "2026-10-05T17:40:02+00:00",
        "completed_at": null,
        "failed_at": "2026-10-05T17:41:15+00:00",
        "banned_at": null,
        "ban_reason": null
      }
    ],
    "current_page": 1,
    "last_page": 1,
    "per_page": 20,
    "total": 2
  }
}
Felder der Antwort
successerforderlich

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.

boolean
messageerforderlich

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.

string
dataerforderlich

The response payload.

object
itemserforderlich

Your voice clones of the chosen provider (cartesia or fishaudio) on this page, newest first.

array<CartesiaVoiceClone>CartesiaVoiceClone
Array-Element
iderforderlich

Clone UUID. Use it in /voices/cartesia/clones/{voiceClone}/… paths; it does NOT go into a template — voice_id does.

string
providererforderlich

Clone provider — always cartesia.

Wertecartesia
string
display_nameerforderlich

Clone name given at creation.

string
languageerforderlich

Language of the sample (ISO 639-1), or null if none was sent.

darf null sein
string
descriptionerforderlich

Your description of the clone, or null.

darf null sein
string
statuserforderlich

Status: pending → cloning → ready or failed; archived — retired by the owner; banned — blocked by a moderator. Only ready can be used for narration.

string
voice_iderforderlich

The Cartesia voice id — the value for tts_settings.voice_id of a template with service_key: cartesia. Present only for ready, otherwise null.

darf null sein
string
attemptserforderlich

Cloning attempt number: 1 on creation, +1 for every retry.

integer
errorerforderlich

Why the last attempt failed; null while there has been no failure.

darf null sein
object
reasonerforderlich

Machine-readable failure code: processing_error, max_retries, network, timeout, dispatch_failed. Retry with POST /voices/cartesia/clones/{voiceClone}/retry; if processing_error keeps coming back, use a different sample.

darf null sein
string
messageerforderlich

Human-readable explanation of the failure, or null. Branch on reason, not on this text.

darf null sein
string
created_aterforderlich

When the clone was created.

darf null seindate-time
string
completed_aterforderlich

When the clone became ready; null until then.

darf null seindate-time
string
failed_aterforderlich

When the last attempt failed; null if it has not.

darf null seindate-time
string
banned_aterforderlich

When a moderator banned the clone (status = banned); null if it is not banned.

darf null seindate-time
string
ban_reasonerforderlich

Reason for the ban given by the moderator, or null. A banned clone can be neither used nor archived.

darf null sein
string
current_pageerforderlich

Current page number, starting from one.

integer
last_pageerforderlich

Number of the last page.

integer
per_pageerforderlich

Page size the server applied.

integer
totalerforderlich

Total number of records matching the filter.

integer
401

The key is missing, unknown, disabled or expired.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

Error text in the key's language (set through the X-Locale header).

string
dataerforderlich

Always null when the request is rejected before processing.

darf null sein
null
403

The key lacks the voices.read permission.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

Error text in the key's language (set through the X-Locale header).

string
422

Validation error, for example an unknown status or per_page above 100. Offending fields are listed in errors.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": true,
  "message": "string",
  "errors": {}
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

A summary of the validation errors in words, in the response language (X-Locale).

string
errorserforderlich

A per-field breakdown: the key names a request field, the value lists the complaints about it.

object
*optional
beliebige Schlüssel
array<string>

Diese Seite für KI

.md öffnenllm.md

API-Version 1.0.0