Skip to main content
POST
Pobierz tymczasowy adres URL do odtworzenia niezapisanego podglądu sklonowanego lub zaprojektowanego głosu. Użyj voices_save_preview, aby zachować go przed wygaśnięciem.

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
wymagane
Wartość tekstowa.Format: “uuid”. Wzorzec: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$.
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. Jeden aktywny podgląd głosu należący do wywołującego, z odświeżonym tymczasowym adresem URL odtwarzania i czasem jego wygaśnięcia.

Pola wyniku

Uwagi do operacji

  • previewId to UUID głosu kandydującego zwrócony w voicePreviews przez voices_preview_clone, voices_design lub voices_list.
  • Widoczne są tylko niezapisane, niewygasłe podglądy w stanie ready. Zapisana propozycja głosu trafia do voices_list jako clone:<previewId>. W przypadku wygasłych, zapisanych, brakujących lub nienależących do użytkownika propozycji zwracane jest tutaj VOICE_PREVIEW_NOT_FOUND.
  • Adres URL jest tymczasowy i może wygasnąć przed expiresAt. Zapisz wybraną propozycję głosu za pomocą voices_save_preview, zanim wygaśnie sam podgląd.
  • 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