Skip to main content
POST
Wyświetl dostępne głosy do syntezy mowy, swoje zapisane własne głosy, niewygasłe podglądy do odtworzenia i limity tworzenia głosów.

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

Wyślij pusty obiekt JSON. Ta akcja nie ma pól wejściowych.
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. Dostępne głosy TTS z katalogu i własne zapisane głosy niestandardowe, limit miejsc na zapisane głosy, aktywne niezapisane podglądy i limity tworzenia głosów.

Pola wyniku

Uwagi do operacji

  • Przykładowy katalog jest skrócony. Akcja zwraca dostępną bibliotekę TTS z zapisanymi głosami niestandardowymi przed wpisami katalogowymi.
  • Użyj voices[].id w tts_generate. Zapisane głosy używają clone:<UUID>; identyfikatory katalogowe są nieprzezroczyste. Te identyfikatory są odrębne od identyfikatorów z dubbing_voices_list.
  • Wpisy katalogowe zawierają accent, gender, style i previewFileName; previewUrl jest opcjonalne. Zapisane wpisy niestandardowe zawierają accent: original, source: clone i tymczasowe previewUrl.
  • canClone określa, czy plan obsługuje zapisywanie niestandardowych głosów TTS; remaining wskazuje wolne miejsca. Zarezerwowane operacje tworzenia mogą być wliczane do used.
  • voicePreviews zawiera tylko należące do użytkownika, niezapisane, gotowe głosy kandydujące, które nie wygasły. Podgląd jest ważny przez 24 godziny; jego adres URL umożliwiający odtwarzanie może wygasnąć wcześniej.
  • cloneTrial to limit jednego podglądu klonu na cały okres korzystania z konta. Płatne plany obejmują pięć żądań projektowania głosu na dzień UTC; każde udane projektowanie tworzy dwa głosy kandydujące. creationUsage podaje aktualny limit i czas resetu.
  • 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