Stimmen auflisten

GET

/v2/voices

GET

/v2/voices

curl -G https://api.elevenlabs.io/v2/voices \
     -d accent=american \
     -d age=young \
     -d gender=male \
     -d high_quality=true \
     -d include_custom_rates=true \
     -d include_live_moderated=true \
     -d include_total_count=true \
     -d language=en \
     -d language=es \
     -d min_notice_period_days=30 \
     -d next_page_token=0 \
     -d sort=created_at_unix \
     -d sort_direction=desc \
     -d use_cases=conversational \
     -d use_cases=narrative_story

{
  "voices": [
    {
      "voice_id": "string",
      "name": "string",
      "samples": [
        {
          "sample_id": "string",
          "file_name": "string",
          "mime_type": "string",
          "size_bytes": 1,
          "hash": "string",
          "duration_secs": 1.1,
          "remove_background_noise": true,
          "has_isolated_audio": true,
          "has_isolated_audio_preview": true,
          "speaker_separation": {
            "voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
            "sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
            "status": "not_started"
          },
          "trim_start": 1,
          "trim_end": 1
        }
      ],
      "category": "generated",
      "fine_tuning": {
        "is_allowed_to_fine_tune": true,
        "state": {
          "eleven_multilingual_v2": "fine_tuned"
        },
        "verification_failures": [],
        "verification_attempts_count": 2,
        "manual_verification_requested": false
      },
      "labels": {},
      "description": "string",
      "preview_url": "string",
      "available_for_tiers": [
        "string"
      ],
      "settings": {
        "stability": 1,
        "use_speaker_boost": true,
        "similarity_boost": 1,
        "style": 0,
        "speed": 1
      },
      "sharing": {
        "status": "enabled",
        "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
        "date_unix": 1714204800,
        "whitelisted_emails": [
          "example@example.com"
        ],
        "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18",
        "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
        "financial_rewards_enabled": true,
        "free_users_allowed": true,
        "live_moderation_enabled": true,
        "rate": 0.05,
        "notice_period": 30,
        "disable_at_unix": 1714204800,
        "voice_mixing_allowed": false,
        "featured": true,
        "category": "professional",
        "reader_app_enabled": true,
        "liked_by_count": 100,
        "cloned_by_count": 50,
        "name": "Rachel",
        "description": "A female voice with a soft and friendly tone.",
        "labels": {
          "accent": "American",
          "gender": "female"
        },
        "review_status": "allowed",
        "enabled_in_library": true,
        "moderation_check": {
          "date_checked_unix": 1714204800,
          "name_value": "Rachel",
          "name_check": true,
          "description_value": "A female voice with a soft and friendly tone.",
          "description_check": true,
          "sample_ids": [
            "sample1",
            "sample2"
          ],
          "sample_checks": [
            0.95,
            0.98
          ],
          "captcha_ids": [
            "captcha1",
            "captcha2"
          ],
          "captcha_checks": [
            0.95,
            0.98
          ]
        },
        "reader_restricted_on": [
          {
            "resource_type": "read",
            "resource_id": "FCwhRBWXzGAHq8TQ4Fs18"
          }
        ]
      },
      "high_quality_base_model_ids": [
        "string"
      ],
      "verified_languages": [
        {
          "language": "string",
          "model_id": "string",
          "accent": "string",
          "locale": "string",
          "preview_url": "string"
        }
      ],
      "collection_ids": [
        "string"
      ],
      "safety_control": "NONE",
      "voice_verification": {
        "requires_verification": false,
        "is_verified": true,
        "verification_failures": [],
        "verification_attempts_count": 0,
        "language": "en",
        "verification_attempts": [
          {
            "text": "Hello, how are you?",
            "date_unix": 1714204800,
            "accepted": true,
            "similarity": 0.95,
            "levenshtein_distance": 2,
            "recording": {
              "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
              "mime_type": "audio/mpeg",
              "size_bytes": 1000000,
              "upload_date_unix": 1714204800,
              "transcription": "Hello, how are you?"
            }
          }
        ]
      },
      "permission_on_resource": "string",
      "is_owner": true,
      "is_legacy": false,
      "is_mixed": false,
      "favorited_at_unix": 1,
      "created_at_unix": 1,
      "is_bookmarked": true,
      "recording_quality": "studio",
      "labelling_status": "in_review",
      "recording_quality_reason": "string"
    }
  ],
  "has_more": true,
  "total_count": 1,
  "next_page_token": "string"
}

Ruft eine Liste aller verfügbaren Stimmen für einen Benutzer mit Suche, Filterung und Paginierung ab.

Abfrageparameter

next_page_tokenstring or nullOptional

Das nächste Seitentoken für die Paginierung. Wird von der vorherigen Anfrage zurückgegeben. Verwenden Sie es zusammen mit dem Flag has_more für eine zuverlässige Paginierung.

page_sizeintegerOptionalStandardwert ist 10

Maximale Anzahl zurückzugebender Stimmen. Darf 100 nicht überschreiten, Standardwert ist 10. Seite 0 kann aufgrund enthaltener Standardstimmen mehr Stimmen enthalten.

searchstring or nullOptional

Suchbegriff zum Filtern von Stimmen. Durchsucht Name, Beschreibung, Labels und Kategorie.

sortstring or nullOptional

Nach welchem Feld sortiert werden soll: ‘created_at_unix’ oder ‘name’. ‘created_at_unix’ ist für ältere Stimmen möglicherweise nicht verfügbar.

sort_directionstring or nullOptional

In welcher Richtung die Stimmen sortiert werden sollen: ‘asc’ oder ‘desc’.

voice_typestring or nullOptional

Typ der Stimme, nach dem gefiltert wird. Einer von ‘personal’, ‘community’, ‘default’, ‘workspace’, ‘non-default’, ‘non-community’, ‘saved’. ‘non-default’ entspricht allen außer ‘default’. ‘non-community’ entspricht der Kombination aus ‘personal’ und ‘workspace’ und schließt Kopien aus der Stimmbibliothek aus. ‘saved’ entspricht non-default, enthält aber Standardstimmen, wenn diese einer Sammlung hinzugefügt wurden.

Typ der Stimme, nach dem gefiltert wird. Einer von 'personal', 'community', 'default', 'workspace', 'non-default', 'non-community', 'saved'. 'non-default' entspricht allen außer 'default'. 'non-community' entspricht der Kombination aus 'personal' und 'workspace' und schließt Kopien aus der Stimmbibliothek aus. 'saved' entspricht non-default, enthält aber Standardstimmen, wenn diese einer Sammlung hinzugefügt wurden.

categorystring or nullOptional

Kategorie der Stimme, nach der gefiltert wird. Eine von „premade“, „cloned“, „generated“, „professional“

fine_tuning_statestring or nullOptional

Status des Finetunings der Stimme, nach dem gefiltert wird. Gilt nur für professionelle Stimmklone. Einer von ‘draft’, ‘not_verified’, ‘not_started’, ‘queued’, ‘fine_tuning’, ‘fine_tuned’, ‘failed’, ‘delayed’

collection_idstring or nullOptional

Collection-ID, nach der Stimmen gefiltert werden.

genderstring or nullOptional

Zum Filtern verwendetes Geschlecht basierend auf dem ‘gender’-Label der Stimme.

agestring or nullOptional

Für die Filterung verwendetes Alter, basierend auf dem Label „age“ der Stimme.

languagelist of strings or nullOptional

Zum Filtern verwendete Sprachen basierend auf dem Label „language“ der Stimme. Stimmen, die einer der angegebenen Sprachen entsprechen, werden zurückgegeben.

accentstring or nullOptional

Akzent für die Filterung, basierend auf dem Label ‘accent’ der Stimme.

use_caseslist of strings or nullOptional

Für die Filterung verwendete Anwendungsfälle basierend auf dem Label ‘use_case’ der Stimme. Es werden Stimmen zurückgegeben, die einem der angegebenen Anwendungsfälle entsprechen.

min_notice_period_daysinteger or nullOptional

Auf Stimmen filtern, deren Kündigungsfrist für die Freigabe mindestens die angegebene Anzahl an Tagen beträgt.

include_custom_ratesboolean or nullOptional

Ob Stimmen mit einer benutzerdefinierten Freigaberate einbezogen werden sollen. Standardmäßig werden sie einbezogen.

include_live_moderatedboolean or nullOptional

Ob Stimmen mit aktivierter Live-Moderation einbezogen werden sollen. Standardmäßig werden sie einbezogen.

high_qualityboolean or nullOptional

Wenn true, werden nur Stimmen in Studioqualität zurückgegeben, deren Kategorie ‘high_quality’ ist.

include_total_countbooleanOptionalStandardwert ist true

Ob die Gesamtzahl der gefundenen Stimmen in die Antwort aufgenommen werden soll. HINWEIS: Der Wert total_count ist eine Live-Aufnahme und kann sich zwischen Anfragen ändern, wenn Nutzer Stimmen erstellen, ändern oder löschen. Verwenden Sie für die Paginierung stattdessen das Flag has_more. Aktivieren Sie dies nur, wenn Sie die Gesamtzahl tatsächlich benötigen, z. B. zur Anzeige, da dies die Performance beeinträchtigt.

voice_idslist of strings or nullOptional

Stimmen-IDs, nach denen gesucht wird. Maximal 100 Stimmen-IDs.

Antwort

Erfolgreiche Antwort

voiceslist of objects

Die Liste der Stimmen, die der Abfrage entsprechen.

has_moreboolean

Gibt an, ob auf nachfolgenden Seiten weitere Stimmen verfügbar sind. Verwenden Sie dieses Flag (und next_page_token) für eine zuverlässige Paginierung, statt sich auf total_count zu verlassen.

total_countinteger

Die Gesamtzahl der Stimmen, die der Abfrage entsprechen. Dieser Wert ist eine Live-Aufnahme des aktuellen Datenbankzustands und kann sich zwischen Anfragen ändern, wenn Nutzer Stimmen erstellen, ändern oder löschen. Verwenden Sie für zuverlässige Paginierung das Flag has_more, statt sich auf diesen Wert zu verlassen. Fragen Sie dieses Feld nur ab, wenn Sie die Gesamtzahl tatsächlich benötigen, z. B. zur Anzeige, da die Berechnung die Leistung beeinträchtigt.

next_page_tokenstring or nullOptional

Token zum Abrufen der nächsten Ergebnisseite. Übergeben Sie diesen Wert mit der nächsten Anfrage, um die Seitennummerierung fortzusetzen. Null, wenn keine weiteren Ergebnisse vorhanden sind.

Fehler

422

Unprocessable Entity Error

Header

Abfrageparameter

Antwort

Fehler