Skip to main content
POST
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ę.

Uwierzytelnianie i uprawnienia

string
wymagane
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

string
Wartość tekstowa.Dozwolone wartości: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. Wartość domyślna: “en”.
string
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.

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.

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.

Pola wyniku

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:<UUID>.
  • 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