Skip to main content
POST
Pobierz należące do Ciebie nagranie mowy, w tym skrypt, ustawienia sposobu mówienia, tymczasowy adres URL audio i dostępne dopasowanie czasowe słó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: 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. Szczegóły historii mowy należącej do wywołującego, pełne teksty edytowalne i wypowiadane, ustawienia sposobu wypowiedzi, tymczasowy adres URL odtwarzania oraz dostępne znaczniki czasu słów.

Pola wyniku

Uwagi do operacji

  • historyId musi składać się z 64 małych znaków szesnastkowych, opcjonalnie poprzedzonych free-. Użyj identyfikatora zwróconego przez tts_generate lub tts_list.
  • Opcjonalne właściwości starszych rekordów, takie jak voiceName, voiceSource i sourceFileName, mogą być pominięte. Brak instructions oznacza domyślnie pusty ciąg znaków, brak speed — 1, a brak previewEndIndex — null.
  • wordAlignment może mieć wartość null. Ten odczyt wczytuje istniejące dopasowanie; użyj tts_align, aby przygotować znaczniki czasu.
  • Indeksy znaków źródłowych w wordAlignment odnoszą się do spokenText, z którego usunięto znaczniki sterowania sposobem wypowiedzi.
  • audioUrl jest tymczasowy. Wywołaj ponownie tts_get, aby uzyskać nowy adres odtwarzania, lub tts_download, aby uzyskać link do pobrania.
  • 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