Skip to main content
POST
Pobierz nowy tymczasowy adres URL do pobrania należącego do Ciebie nagrania mowy. Nigdy nie uruchamia generowania ani nie zużywa kredytów na multimedia.

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: tts: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
Identyfikator historii zwrócony przez tts_generate lub tts_list.Wzorzec: ^(free-)?[0-9a-f]{64}$.
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. Nowy tymczasowy adres URL pobierania własnego pliku MP3 z mową.

Pola wyniku

Uwagi do operacji

  • Ten odczyt nigdy nie generuje mowy ani nie zużywa kredytów na multimedia. Limity wywołań integracji nadal obowiązują.
  • Nazwa pliku jest wyprowadzana z sourceFileName, jeśli je podano, a w przeciwnym razie to voicecheap-tts-speech.mp3. Adresy URL są tymczasowe.
  • 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