Skip to main content
POST
Wyświetl historię swoich nagrań mowy, od najnowszych. Przekaż nextCursor jako cursor, aby pobrać starsze nagrania.

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

integer
Liczba całkowita.Minimum: 1. Maksimum: 100. Wartość domyślna: 30.
string
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. Strona podsumowań historii generowania mowy, od najnowszych, oraz kursor do pobierania starszych nagrań.

Pola wyniku

Uwagi do operacji

  • limit ma domyślnie wartość 30 i mieści się w zakresie od 1 do 100. Przekaż zwrócony nextCursor jako cursor dla kolejnej strony.
  • nextCursor ma wartość null, gdy zwrócono mniej elementów niż limit. Pełna ostatnia strona nadal może zwrócić kursor; następne wywołanie może być puste.
  • Każde textPreview zawiera najwyżej pierwsze 180 znaków. Użyj tts_get, aby pobrać pełny tekst i adres URL audio.
  • Elementy historii podają status: success. Różni się to od status: completed w wyniku generowania mowy.
  • 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