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/filters

Voice Catalogue Filters

Descriptions of the filters of the chosen provider's voice catalogue: the parameter key, a label, the kind (text, select, multiselect) and the allowed values with counts. Pass provider (elevenlabs, heygen, cartesia, fishaudio, lumvoice) — the same values as in GET /voices?provider=….

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/filters
  • stringin der Queryerforderlich

    Voice provider: elevenlabs, heygen, cartesia, fishaudio or lumvoice.

    Zulässige Werte

Mögliche Antworten

200

Success. The payload is in data.

Beispiel für den Body
{
  "success": true,
  "message": "Success",
  "data": {
    "provider": "cartesia",
    "filters": [
      {
        "key": "search",
        "label": "Search",
        "type": "text",
        "options": null
      },
      {
        "key": "language",
        "label": "Language",
        "type": "select",
        "options": [
          {
            "value": "ru",
            "label": "ru",
            "count": 58
          },
          {
            "value": "en",
            "label": "en",
            "count": 214
          }
        ]
      },
      {
        "key": "gender",
        "label": "Gender",
        "type": "select",
        "options": [
          {
            "value": "female",
            "label": "female",
            "count": 150
          },
          {
            "value": "male",
            "label": "male",
            "count": 122
          }
        ]
      }
    ]
  }
}
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
providererforderlich

The provider whose filters are described.

string
filterserforderlich

Filters of the provider’s voice catalogue.

array<any>
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 required permission, or the object belongs to another user.

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

Not found, or not reachable with this key.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "Resource not found."
}
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
reasonoptional

Machine-readable reason — present on business refusals (for example, invalid_order_status); other errors omit it. Branch on it, not on the message text.

string
error_codeoptional

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

string
422

Validation error. Offending fields are listed in errors.

Diese Antwort analysieren
Beispiel für den Body
{
  "message": "string",
  "errors": {
    "key": [
      "string"
    ]
  }
}
Felder der Antwort
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>

Dasselbe in Worten

Benachbarte Operationen

Diese Seite für KI

.md öffnenllm.md

API-Version 1.0.0