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.
POST/voices/{provider}/clones/{voiceClone}/retry

Retry Voice Clone

A new attempt for a clone in failed, with the same sample. The clone goes back to pending and takes a slot under the plan's cap again, so the checks are the same as on creation (404 service_not_found, 402 no_subscription, 422 voice_clone_quota_exceeded).

Only failed can be retried: a ready clone already has its voice and pending/cloning are still running — those get 409 voice_clone_not_retryable.

Required key permission: voices.write.

Parameter

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

POSThttps://api.lumean.app/api/public/voices//clones//retry
  • 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
  • stringim Pfaderforderlich

    Cartesia or Fish Audio voice clone UUID — 36 characters, not a number.

    Take it from the clone's id field: POST /voices/cartesia/clones (or /voices/fishaudio/clones) returns it on creation and the matching GET …/clones lists it. This is not the clone's voice_id (that one goes into a template). Someone else's clone returns 404 with reason: voice_clone_not_found.

    Der Wert wird direkt in die Anfragezeile oben eingesetzt.

Mögliche Antworten

200

Success. The payload is in data.

Beispiel für den Body
{
  "success": true,
  "message": "Success",
  "data": {
    "id": "01a10e08-2ee5-702c-b492-243c88fd966f",
    "provider": "cartesia",
    "display_name": "Noisy sample",
    "language": "ru",
    "description": null,
    "status": "pending",
    "voice_id": null,
    "attempts": 2,
    "error": null,
    "created_at": "2026-10-05T17:40:02+00:00",
    "completed_at": null,
    "failed_at": null,
    "banned_at": null,
    "ban_reason": null
  }
}
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 clone with a new attempt queued — back in pending.

CartesiaVoiceCloneCartesiaVoiceClone
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
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
402

No live subscription that includes the provider's service (Cartesia or Fish Audio; reason: no_subscription). Returned only if that service is closed to paying from the balance.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "An active subscription is required.",
  "reason": "no_subscription",
  "error_code": "no_subscription"
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes.

string
reasonerforderlich

Machine-readable reason of a business refusal (for example, input_expired, insufficient_balance). Branch on it, not on the message text.

string
error_codeerforderlich

The same machine-readable code as in reason — a second name for the field. The values always match.

string
403

The key lacks the voices.write 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
404

The clone does not exist or belongs to someone else (reason: voice_clone_not_found). A voiceClone that is not a UUID does not match the route: reason: endpoint_not_found (a hint with the docs address, llm.md §6.1). Also reason: service_not_found — the service is closed to the key owner.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "Voice clone not found.",
  "reason": "voice_clone_not_found",
  "error_code": "voice_clone_not_found"
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes.

string
reasonerforderlich

Machine-readable reason of a business refusal (for example, input_expired, insufficient_balance). Branch on it, not on the message text.

string
error_codeerforderlich

The same machine-readable code as in reason — a second name for the field. The values always match.

string
409

The clone is not in failed (it is already ready, still pending/cloning, or archived), or its sample has already been deleted (reason: voice_clone_not_retryable). Create a new clone instead.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "Only a clone that ended with an error can be retried.",
  "reason": "voice_clone_not_retryable",
  "error_code": "voice_clone_not_retryable"
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes.

string
reasonerforderlich

Machine-readable reason of a business refusal (for example, input_expired, insufficient_balance). Branch on it, not on the message text.

string
error_codeerforderlich

The same machine-readable code as in reason — a second name for the field. The values always match.

string
422

The clone cap of the plan is reached (reason: voice_clone_quota_exceeded, the cap is in max).

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "Voice clone limit reached: no more than 3. Delete a clone you no longer need or wait for the current one to fail.",
  "reason": "voice_clone_quota_exceeded",
  "error_code": "voice_clone_quota_exceeded",
  "max": 3
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes.

string
reasonerforderlich

Machine-readable reason of a business refusal (for example, input_expired, insufficient_balance). Branch on it, not on the message text.

string
error_codeerforderlich

The same machine-readable code as in reason — a second name for the field. The values always match.

string
maxerforderlich

The clone cap of your plan for the chosen provider: how many clones in pending, cloning and ready you may hold at once (clones of the other provider do not count). Archive a clone you no longer need to free a slot.

integer
429

The clone rate limit is exceeded (reason: rate_limit_exceeded): by default 6 attempts per minute and 60 per day per user, shared with the web cabinet and LumVoice cloning. Every attempt counts, including one rejected by validation. Wait retry_after seconds (the Retry-After header).

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "Too many attempts. Please wait a moment and try again.",
  "reason": "rate_limit_exceeded",
  "error_code": "rate_limit_exceeded",
  "retry_after": 30
}
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
reasonerforderlich

Machine-readable failure reason — branch on this, not on the message text.

string
error_codeerforderlich

The same machine-readable code as in reason — a second name for the field. The values always match; branch on either.

string
retry_afteroptional

How many seconds to wait before retrying (the same value is in the Retry-After header).

darf null sein
integer

Diese Seite für KI

.md öffnenllm.md

API-Version 1.0.0