> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wyświetl listę głosów dubbingowych > Przeglądaj ten sam katalog głosów dubbingowych co w aplikacji oraz swoje zapisane własne głosy dubbingowe, wraz z przykładami do odtworzenia i limitem głosów. Te identyfikatory służą do dubbingu wideo; voices_list udostępnia osobną bibliotekę zamiany tekstu na mowę. Przeglądaj ten sam katalog głosów dubbingowych co w aplikacji oraz swoje zapisane własne głosy dubbingowe, wraz z przykładami do odtworzenia i limitem głosów. Te identyfikatory służą do dubbingu wideo; voices\_list udostępnia osobną bibliotekę zamiany tekstu na mowę. ```http theme={null} POST https://api.voicecheap.ai/v1/actions/dubbing_voices_list ``` ## Uwierzytelnianie i uprawnienia Wyślij klucz API VoiceCheap w tym nagłówku. Obsługiwany jest również nagłówek Authorization: Bearer z tym samym kluczem API. Tokeny dostępu OAuth są akceptowane tylko przez MCP, a nie przez ten endpoint REST. Wymagane uprawnienia: `voices:read`. Wymagana jest aktywna płatna subskrypcja. Uprawnienia nie zmieniają ról w zespole, własności zasobów, kredytów na multimedia ani limitów planu. ## Parametry Wartość tekstowa. Dozwolone wartości: "en", "fr", "es", "de", "it", "pt", "pl", "zh", "ja". Wartość domyślna: "en". Wartość tekstowa. Minimalna długość: 2. Maksymalna długość: 35. Wartość tekstowa. Maksymalna długość: 100. Poniższy JSON Schema zachowuje dokładne nazwy pól, typy zagnieżdżone, wartości domyślne, ograniczenia i akceptowane wartości udostępniane przez mechanizm wykrywania. Dodatkowe reguły zależności między polami znajdują się w uwagach do operacji. ```json theme={null} { "type": "object", "properties": { "locale": { "default": "en", "type": "string", "enum": ["en", "fr", "es", "de", "it", "pt", "pl", "zh", "ja"] }, "language": { "type": "string", "minLength": 2, "maxLength": 35 }, "search": { "type": "string", "maxLength": 100 } }, "additionalProperties": false } ``` ## Przykłady żądań Zastąp przykładowe identyfikatory zasobów i klucze multimediów wartościami zwróconymi dla Twojego konta. Przy ponawianiu tej samej operacji zmieniającej dane zachowaj identyfikator żądania. ```bash cURL theme={null} curl --request POST 'https://api.voicecheap.ai/v1/actions/dubbing_voices_list' \ --header "x-api-key: $VOICECHEAP_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"locale":"en","language":"en","search":"Studio narrator"}' ``` ```javascript JavaScript theme={null} const input = { locale: 'en', language: 'en', search: 'Studio narrator', }; const response = await fetch('https://api.voicecheap.ai/v1/actions/dubbing_voices_list', { method: 'POST', headers: { 'x-api-key': process.env.VOICECHEAP_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify(input), }); const body = await response.json(); if (!response.ok) throw new Error(body.code + ': ' + body.message); console.log(body); ``` ```python Python theme={null} import os import requests response = requests.post( "https://api.voicecheap.ai/v1/actions/dubbing_voices_list", headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]}, json={"locale": "en", "language": "en", "search": "Studio narrator"}, timeout=120, ) body = response.json() if not response.ok: raise RuntimeError(f"{body.get('code')}: {body.get('message')}") print(body) ``` ## Odpowiedź Pierwsze pomyślne wykonanie zwraca HTTP 200 z wynikiem operacji w data. Ponowienie może zamiast tego zwrócić zapisany stan żądania. Przykład przedstawia jedną obsługiwaną odpowiedź, bez wszystkich opcjonalnych pól. Pasujące głosy do dubbingu wideo z katalogu i własne głosy niestandardowe oraz bieżący limit zapisanych głosów do dubbingu. ```json HTTP 200 theme={null} { "data": { "voices": [ { "id": "dubbing_voice_R8q3k9Yp", "name": "Studio narrator", "source": "custom", "previewUrl": "https://files.example.com/dubbing-narrator.mp3" } ], "cloneUsage": { "limit": 7, "used": 1, "remaining": 6 } } } ``` ## Pola wyniku | Pole | Opis | | - | - | | `data.voices` | Pasujące własne głosy niestandardowe do dubbingu, a następnie głosy do dubbingu z katalogu. | | `data.voices[].id` | Nieprzezroczysty identyfikator głosu do dubbingu; używaj go w operacjach dubbingu, a nie w tts\_generate. | | `data.voices[].name` | Nazwa wyświetlana głosu w żądanej lokalizacji, gdy dostępne są zlokalizowane metadane. | | `data.voices[].source` | custom dla własnych zapisanych głosów do dubbingu lub catalog. | | `data.voices[].previewUrl` | Opcjonalny bezwzględny adres URL odtwarzalnego przykładu. | | `data.voices[].language` | Opcjonalny kod języka z katalogu. Głosy niestandardowe zwykle nie zawierają metadanych języka. | | `data.voices[].languages` | Opcjonalna lista kodów języków z katalogu. | | `data.voices[].accent` | Opcjonalny zlokalizowany akcent z katalogu. | | `data.voices[].description` | Opcjonalny zlokalizowany opis katalogowy. | | `data.voices[].age` | Opcjonalny zlokalizowany opis wieku z katalogu. | | `data.voices[].gender` | Opcjonalny zlokalizowany opis płci z katalogu. | | `data.voices[].useCase` | Opcjonalny zlokalizowany przypadek użycia w katalogu. | | `data.voices[].category` | Opcjonalna zlokalizowana kategoria katalogowa. | | `data.cloneUsage.limit` | Limit miejsc na zapisane własne głosy dubbingowe w bieżącym planie. | | `data.cloneUsage.used` | Liczba zapisanych własnych głosów dubbingowych. | | `data.cloneUsage.remaining` | Niewykorzystane miejsca na zapisane własne głosy dubbingowe. | ## Uwagi do operacji * To biblioteka głosów do dubbingu filmów. Użyj voices\_list, aby uzyskać dostęp do odrębnego katalogu TTS i głosów wybieranych przez clone:\. * locale ma domyślną wartość en i akceptuje en, fr, es, de, it, pt, pl, zh oraz ja. Brakujący zlokalizowany tekst jest zastępowany wersją angielską lub innym dostępnym tłumaczeniem. * Opcjonalne search dopasowuje podciąg w nazwie głosu i zlokalizowanym opisie bez rozróżniania wielkości liter, z limitem 100 znaków po usunięciu białych znaków z początku i końca. * Opcjonalne language zawiera 2–35 znaków i jest porównywane przez dokładne dopasowanie z metadanymi language lub languages katalogu. Głosy bez metadanych językowych, w tym głosy niestandardowe, pozostają uwzględnione. * Lista nie jest dzielona na strony. Głosy katalogowe i niestandardowe mają różne opcjonalne metadane. Wykorzystanie miejsc na klony obejmuje tylko zapisane niestandardowe głosy do dubbingu. * Przykład filtruje wyniki do jednego własnego głosu niestandardowego. Pole na liście to previewUrl; klonowanie zwraca tę samą próbkę audio w audioExampleUrl. * Historia mowy i głosy niestandardowe należą do uwierzytelnionego konta. Rozliczanie w ramach zespołu nie daje dostępu do mowy ani głosów innego członka. ## Wykorzystanie Każde pomyślne wywołanie zużywa jedno wywołanie z miesięcznego limitu API/MCP. Obowiązują również kredyty na multimedia oraz limity generowania danej operacji. ## Błędy | Status HTTP | Kod | Znaczenie lub sposób rozwiązania | | - | - | - | | 400 | `CREDENTIAL_IN_QUERY` | Dane uwierzytelniające zostały podane w parametrze zapytania access\_token lub api\_key. Wysyłaj dane uwierzytelniające w nagłówkach. | | 400 | `VALIDATION_ERROR` | Dane wejściowe nie odpowiadają schematowi akcji; sprawdź details, aby poznać błędy pól. | | 401 | `API_KEY_EXPIRED` | Klucz API wygasł. | | 401 | `INVALID_API_KEY` | Podaj prawidłowy, niewygasły klucz API. | | 401 | `INVALID_CREDENTIAL` | Nagłówek Authorization ma nieprawidłowy format lub jest sprzeczny z x-api-key. | | 401 | `MISSING_CREDENTIAL` | Nie podano użytecznych danych uwierzytelniających w nagłówku lub przekroczyły one 4096 znaków. | | 401 | `USER_NOT_FOUND` | Konto powiązane z poświadczeniem już nie istnieje. | | 403 | `AMBIGUOUS_TEAM_API_KEY` | Użytkownik, do którego należą dane uwierzytelniające, należy do więcej niż jednego zespołu, więc kontekst rozliczeniowy jest niejednoznaczny. | | 403 | `INSUFFICIENT_SCOPE` | Nadaj wszystkie wymagane uprawnienia lub wybierz inne dane uwierzytelniające. | | 403 | `INTEGRATION_PLAN_UNSUPPORTED` | Nie udało się zweryfikować limitów integracji konta. | | 403 | `SUBSCRIPTION_REQUIRED` | Użyj aktywnej płatnej subskrypcji. | | 403 | `TEAM_OWNER_NOT_FOUND` | Nie znaleziono konta faktycznego właściciela zespołu. | | 429 | `INTEGRATION_MONTHLY_LIMIT_REACHED` | Poczekaj na odnowienie miesięcznego limitu lub zmień plan. | | 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Jeśli występuje nagłówek Retry-After, odczekaj wskazany czas i stosuj rosnące odstępy między ponowieniami. | | 500 | `INTERNAL_ERROR` | Sprawdź stan zapisanego żądania i historię zasobu przed podjęciem decyzji o ponowieniu operacji zmieniającej dane. | | 503 | `SERVER_RESTARTING` | Serwer jest uruchamiany ponownie. Spróbuj ponownie wkrótce i zachowaj ten sam identyfikator żądania dla operacji zmieniającej dane. | ```json theme={null} { "code": "INSUFFICIENT_SCOPE", "message": "This credential does not permit the requested action.", "status": 403, "details": { "requiredScopes": ["voices:read"] } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.