> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Stimme abrufen

GET https://api.elevenlabs.io/v1/voices/{voice_id}

Gibt Metadaten zu einer bestimmten Stimme zurück.

Reference: https://elevenlabs.io/docs/api-reference/voices/get

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Path parameters

- `voice_id` (string, required) — ID der zu verwendenden Stimme. Mit dem Endpunkt [Get voices](/docs/api-reference/voices/search) können Sie alle verfügbaren Stimmen auflisten.

### Query parameters

- `with_settings` (boolean, optional, default: true, deprecated) — Dieser Parameter ist jetzt veraltet. Er wird ignoriert und in einer zukünftigen Version entfernt.

## Response

### 200

Erfolgreiche Antwort

- `voice_id` (string, required) — Die ID der Stimme.
- `name` (string, optional) — Der Name der Stimme.
- `samples` (list of SampleResponseModel, optional, nullable) — Liste der mit der Stimme verknüpften Samples.
- `category` (enum, optional) — Die Kategorie der Stimme.
  - Allowed values: `generated`, `cloned`, `premade`, `professional`, `famous`, `high_quality`
- `fine_tuning` (FineTuningResponseModel, optional, nullable) — Finetuning-Informationen für die Stimme.
- `labels` (map from string to string, optional) — Mit der Stimme verknüpfte Labels.
- `description` (string, optional, nullable) — Die Beschreibung der Stimme.
- `preview_url` (string, optional, nullable) — Die Vorschau-URL der Stimme.
- `available_for_tiers` (list of string, optional) — Die Stufen, für die die Stimme verfügbar ist.
- `settings` (VoiceSettingsResponseModel, optional, nullable) — Die Einstellungen der Stimme.
- `sharing` (VoiceSharingResponseModel, optional, nullable) — Die Freigabeinformationen der Stimme.
- `high_quality_base_model_ids` (list of string, optional) — Die Basis-Modell-IDs für hochwertige Stimmen.
- `verified_languages` (list of VerifiedVoiceLanguageResponseModel, optional, nullable) — Die verifizierten Sprachen der Stimme.
- `collection_ids` (list of string, optional, nullable) — Die IDs der Sammlungen, zu denen diese Stimme gehört.
- `safety_control` (enum, optional, nullable) — Die Sicherheitskontrollen der Stimme.
  - Allowed values: `NONE`, `BAN`, `CAPTCHA`, `ENTERPRISE_BAN`, `ENTERPRISE_CAPTCHA`
- `voice_verification` (VoiceVerificationResponseModel, optional, nullable) — Die Stimmverifizierung der Stimme.
- `permission_on_resource` (string, optional, nullable) — Die Berechtigung für die Ressource der Stimme.
- `is_owner` (boolean, optional, nullable) — Ob die Stimme dem Nutzer gehört.
- `is_legacy` (boolean, optional, default: false) — Ob die Stimme veraltet ist.
- `is_mixed` (boolean, optional, default: false) — Ob die Stimme gemischt ist.
- `favorited_at_unix` (integer, optional, nullable) — Zeitstempel im Unix-Format, zu dem die Stimme als Favorit markiert wurde.
- `created_at_unix` (integer, optional, nullable) — Der Erstellungszeitpunkt der Stimme als Unix-Zeit.
- `is_bookmarked` (boolean, optional, nullable) — Ob die Stimme vom aktuellen Nutzer als Lesezeichen gespeichert wurde. Nur für Community-Stimmen relevant, die aus der Bibliothek kopiert wurden.
- `recording_quality` (enum, optional, nullable) — Die von der Review-Pipeline ermittelte Aufnahmequalität der Stimme.
  - Allowed values: `studio`, `good`, `ok`, `poor`, `bad`
- `labelling_status` (enum, optional, nullable) — Der Status der Review-Pipeline für die Stimme.
  - Allowed values: `in_review`, `review_complete`
- `recording_quality_reason` (string, optional, nullable) — Der von der Review-Pipeline ermittelte Grund für die Bewertung der Aufnahmequalität.

## Errors

### 422 Unprocessable Entity Error

Validierungsfehler

- `detail` (list of ValidationError, optional)

## Types

### SampleResponseModel

- `sample_id` (string, optional) — Die ID des Beispiels.
- `file_name` (string, optional) — Der Name der Beispieldatei.
- `mime_type` (string, optional) — Der MIME-Typ der Beispieldatei.
- `size_bytes` (integer, optional) — Die Größe der Beispieldatei in Byte.
- `hash` (string, optional) — Der Hash der Beispieldatei.
- `duration_secs` (double, optional, nullable)
- `remove_background_noise` (boolean, optional, nullable)
- `has_isolated_audio` (boolean, optional, nullable)
- `has_isolated_audio_preview` (boolean, optional, nullable)
- `speaker_separation` (SpeakerSeparationResponseModel, optional, nullable)
- `trim_start` (integer, optional, nullable)
- `trim_end` (integer, optional, nullable)

### FineTuningResponseModel

- `is_allowed_to_fine_tune` (boolean, optional) — Ob der Nutzer die Stimme finetunen darf.
- `state` (map from string to enum, optional) — Der Status des Finetune-Prozesses für jedes Modell.
  - Allowed values: `not_started`, `queued`, `fine_tuning`, `fine_tuned`, `failed`, `delayed`
- `verification_failures` (list of string, optional) — Liste der Überprüfungsfehler im Finetuning-Prozess.
- `verification_attempts_count` (integer, optional) — Die Anzahl der Verifizierungsversuche im Finetune-Prozess.
- `manual_verification_requested` (boolean, optional) — Gibt an, ob eine manuelle Überprüfung für den Fine-Tuning-Prozess angefordert wurde.
- `language` (string, optional, nullable) — Die Sprache des Finetuning-Prozesses.
- `progress` (map from string to double, optional, nullable) — Der Fortschritt des Finetune-Prozesses.
- `message` (map from string to string, optional, nullable) — Die Meldung des Finetuning-Prozesses.
- `dataset_duration_seconds` (double, optional, nullable) — Die Dauer des Datensatzes in Sekunden.
- `verification_attempts` (list of VerificationAttemptResponseModel, optional, nullable) — Die Anzahl der Verifizierungsversuche.
- `slice_ids` (list of string, optional, nullable) — Liste der Slice-IDs.
- `manual_verification` (ManualVerificationResponseModel, optional, nullable) — Die manuelle Verifizierung des Finetuning-Prozesses.
- `max_verification_attempts` (integer, optional, nullable) — Die maximale Anzahl von Verifizierungsversuchen.
- `next_max_verification_attempts_reset_unix_ms` (integer, optional, nullable) — Der nächste Zeitpunkt zum Zurücksetzen der maximalen Verifizierungsversuche in Unix-Millisekunden.
- `finetuning_state` (any, optional)

### VoiceSettingsResponseModel

- `stability` (double, optional, nullable, default: 0.5) — Legt die Stabilität der Stimme und die Zufälligkeit zwischen den einzelnen Generierungen fest. Niedrigere Werte ermöglichen ein breiteres emotionales Spektrum. Höhere Werte können zu einer monotonen Stimme mit begrenzter Emotionalität führen.
- `use_speaker_boost` (boolean, optional, nullable, default: true) — Diese Einstellung erhöht die Ähnlichkeit mit dem ursprünglichen Sprecher. Ihre Verwendung erfordert etwas mehr Rechenleistung und erhöht dadurch die Latenz.
- `similarity_boost` (double, optional, nullable, default: 0.75) — Legt fest, wie genau die KI beim Nachbilden der ursprünglichen Stimme folgen soll.
- `style` (double, optional, nullable, default: 0) — Legt die Stilüberzeichnung der Stimme fest. Diese Einstellung verstärkt den Stil des ursprünglichen Sprechers. Sie benötigt zusätzliche Rechenressourcen und kann die Latenz erhöhen, wenn sie nicht auf 0 gesetzt ist.
- `speed` (double, optional, nullable, default: 1) — Passt die Geschwindigkeit der Stimme an. Ein Wert von 1.0 ist die Standardgeschwindigkeit. Werte unter 1.0 verlangsamen die Sprache, Werte über 1.0 beschleunigen sie.

### VoiceSharingResponseModel

- `status` (enum, optional) — Der Status der Stimmfreigabe.
  - Allowed values: `enabled`, `disabled`, `copied`, `copied_disabled`
- `history_item_sample_id` (string, optional, nullable) — Die Beispiel-ID des Verlaufseintrags.
- `date_unix` (integer, optional) — Das Datum der Stimmfreigabe als Unix-Zeit.
- `whitelisted_emails` (list of string, optional) — Eine Liste von E-Mail-Adressen auf der Zulassungsliste.
- `public_owner_id` (string, optional) — Die ID des öffentlichen Eigentümers.
- `original_voice_id` (string, optional) — Die ID der ursprünglichen Stimme.
- `financial_rewards_enabled` (boolean, optional) — Gibt an, ob finanzielle Belohnungen aktiviert sind.
- `free_users_allowed` (boolean, optional) — Gibt an, ob kostenlose Benutzer zugelassen sind.
- `live_moderation_enabled` (boolean, optional) — Gibt an, ob Live-Moderation aktiviert ist.
- `rate` (double, optional, nullable) — Der Satz der Stimmfreigabe.
- `fiat_rate` (double, optional, nullable) — Der Satz der Stimmfreigabe in USD pro 1.000 Credits.
- `notice_period` (integer, optional) — Die Kündigungsfrist für die Stimmfreigabe.
- `disable_at_unix` (integer, optional, nullable) — Das Datum der Stimmfreigabe als Unix-Zeit.
- `voice_mixing_allowed` (boolean, optional) — Ob Stimmenmischung zulässig ist.
- `featured` (boolean, optional) — Ob die Stimme hervorgehoben wird.
- `category` (enum, optional) — Die Kategorie der Stimme.
  - Allowed values: `generated`, `cloned`, `premade`, `professional`, `famous`, `high_quality`
- `reader_app_enabled` (boolean, optional, nullable) — Gibt an, ob die Reader-App aktiviert ist.
- `image_url` (string, optional, nullable) — Die Bild-URL der Stimme.
- `ban_reason` (string, optional, nullable) — Der Sperrgrund der Stimme.
- `liked_by_count` (integer, optional) — Die Anzahl der Likes für diese Stimme.
- `cloned_by_count` (integer, optional) — Die Anzahl der Klone dieser Stimme.
- `name` (string, optional) — Der Name der Stimme.
- `description` (string, optional, nullable) — Die Beschreibung der Stimme.
- `labels` (map from string to string, optional) — Die Labels der Stimme.
- `review_status` (enum, optional) — Der Review-Status der Stimme.
  - Allowed values: `not_requested`, `pending`, `declined`, `allowed`, `allowed_with_changes`
- `review_message` (string, optional, nullable) — Die Review-Nachricht der Stimme.
- `enabled_in_library` (boolean, optional) — Ob die Stimme in der Bibliothek aktiviert ist.
- `instagram_username` (string, optional, nullable) — Der Instagram-Benutzername der Stimme.
- `twitter_username` (string, optional, nullable) — Der Twitter/X-Nutzername der Stimme.
- `youtube_username` (string, optional, nullable) — Der YouTube-Nutzername der Stimme.
- `tiktok_username` (string, optional, nullable) — Der TikTok-Nutzername der Stimme.
- `moderation_check` (VoiceSharingModerationCheckResponseModel, optional, nullable) — Die Moderationsprüfung der Stimme.
- `reader_restricted_on` (list of ReaderResourceResponseModel, optional, nullable) — Die für die Stimme eingeschränkte Leserschaft.

### VerifiedVoiceLanguageResponseModel

- `language` (string, required) — Die Sprache der Stimme.
- `model_id` (string, required) — Die Modell-ID der Stimme.
- `accent` (string, optional, nullable) — Der Akzent der Stimme, falls zutreffend.
- `locale` (string, optional, nullable) — Das Gebietsschema der Stimme, falls zutreffend.
- `preview_url` (string, optional, nullable) — Die Vorschau-URL der Stimme, falls zutreffend.

### VoiceVerificationResponseModel

- `requires_verification` (boolean, required) — Ob die Stimme eine Verifizierung erfordert.
- `is_verified` (boolean, required) — Ob die Stimme verifiziert wurde.
- `verification_failures` (list of string, required) — Liste der Überprüfungsfehler.
- `verification_attempts_count` (integer, required) — Die Anzahl der Verifizierungsversuche.
- `language` (string, optional, nullable) — Die Sprache der Stimme.
- `verification_attempts` (list of VerificationAttemptResponseModel, optional, nullable) — Anzahl der Versuche zur Verifizierung.

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### SpeakerSeparationResponseModel

- `voice_id` (string, required) — Die ID der Stimme.
- `sample_id` (string, required) — Die ID des Beispiels.
- `status` (enum, required) — Der Status der Sprechertrennung.
  - Allowed values: `not_started`, `pending`, `completed`, `failed`
- `speakers` (map from string to SpeakerResponseModel, optional, nullable) — Die Sprecher des Samples.
- `selected_speaker_ids` (list of string, optional, nullable) — Die IDs der ausgewählten Sprecher.

### VerificationAttemptResponseModel

- `text` (string, required) — Der Text des Verifizierungsversuchs.
- `date_unix` (integer, required) — Das Datum des Verifizierungsversuchs als Unix-Zeit.
- `accepted` (boolean, required) — Ob der Verifizierungsversuch akzeptiert wurde.
- `similarity` (double, required) — Die Ähnlichkeit des Verifizierungsversuchs.
- `levenshtein_distance` (double, required) — Die Levenshtein-Distanz des Verifizierungsversuchs.
- `recording` (RecordingResponseModel, optional, nullable) — Die Aufnahme des Verifizierungsversuchs.

### ManualVerificationResponseModel

- `extra_text` (string, required) — Der zusätzliche Text der manuellen Verifizierung.
- `request_time_unix` (integer, required) — Das Datum der manuellen Verifizierung als Unix-Zeit.
- `files` (list of ManualVerificationFileResponseModel, required) — Die Dateien der manuellen Überprüfung.

### VoiceSharingModerationCheckResponseModel

- `date_checked_unix` (integer, optional, nullable) — Das Datum der Moderationsprüfung als Unix-Zeit.
- `name_value` (string, optional, nullable) — Der Namenswert der Stimme.
- `name_check` (boolean, optional, nullable) — Gibt an, ob die Namensprüfung erfolgreich war.
- `description_value` (string, optional, nullable) — Der Beschreibungswert der Stimme.
- `description_check` (boolean, optional, nullable) — Gibt an, ob die Beschreibungsprüfung erfolgreich war.
- `sample_ids` (list of string, optional, nullable) — Eine Liste von Sample-IDs.
- `sample_checks` (list of double, optional, nullable) — Eine Liste von Sample-Prüfungen.
- `captcha_ids` (list of string, optional, nullable) — Eine Liste von CAPTCHA-IDs.
- `captcha_checks` (list of double, optional, nullable) — Eine Liste von CAPTCHA-Prüfwerten.

### ReaderResourceResponseModel

- `resource_type` (enum, required) — Der Ressourcentyp.
  - Allowed values: `read`, `collection`
- `resource_id` (string, required) — Die ID der Ressource.

### ValidationErrorLocItems

### SpeakerResponseModel

- `speaker_id` (string, required) — Die ID des Sprechers.
- `duration_secs` (double, required) — Die Dauer des Sprechersegments in Sekunden.
- `utterances` (list of UtteranceResponseModel, optional, nullable) — Die Äußerungen des Sprechers.

### RecordingResponseModel

- `recording_id` (string, required) — Die ID der Aufnahme.
- `mime_type` (string, required) — Der MIME-Typ der Aufnahme.
- `size_bytes` (integer, required) — Die Größe der Aufnahme in Byte.
- `upload_date_unix` (integer, required) — Das Datum der Aufnahme als Unix-Zeit.
- `transcription` (string, required) — Die Transkription der Aufnahme.

### ManualVerificationFileResponseModel

- `file_id` (string, required) — Die ID der Datei.
- `file_name` (string, required) — Der Name der Datei.
- `mime_type` (string, required) — Der MIME-Typ der Datei.
- `size_bytes` (integer, required) — Die Größe der Datei in Byte.
- `upload_date_unix` (integer, required) — Das Datum der Datei als Unix-Zeit.

### UtteranceResponseModel

- `start` (double, required) — Die Startzeit der Äußerung in Sekunden.
- `end` (double, required) — Die Endzeit der Äußerung in Sekunden.

## Examples

**Response**

```json
{
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "name": "Rachel",
  "category": "professional",
  "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": {
    "accent": "American",
    "age": "middle-aged",
    "description": "expressive",
    "gender": "female",
    "use_case": "social media"
  },
  "description": "A warm, expressive voice with a touch of humor.",
  "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3",
  "available_for_tiers": [
    "creator",
    "enterprise"
  ],
  "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": [
    "eleven_v2_flash",
    "eleven_flash_v2",
    "eleven_turbo_v2_5",
    "eleven_multilingual_v2",
    "eleven_v2_5_flash",
    "eleven_flash_v2_5",
    "eleven_turbo_v2"
  ],
  "verified_languages": [
    {
      "language": "en",
      "model_id": "eleven_multilingual_v2",
      "accent": "american",
      "locale": "en-US",
      "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3"
    }
  ],
  "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?"
        }
      }
    ]
  },
  "is_owner": false,
  "is_legacy": false,
  "is_mixed": false
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM"

response = requests.get(url)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM');

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```