> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wyświetl listę wygenerowanej mowy > Wyświetl historię swoich nagrań mowy, od najnowszych. Przekaż nextCursor jako cursor, aby pobrać starsze nagrania. Wyświetl historię swoich nagrań mowy, od najnowszych. Przekaż nextCursor jako cursor, aby pobrać starsze nagrania. ```http theme={null} POST https://api.voicecheap.ai/v1/actions/tts_list ``` ## Uwierzytelnianie i uprawnienia 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 Liczba całkowita. Minimum: 1. Maksimum: 100. Wartość domyślna: 30. 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. ```json theme={null} { "type": "object", "properties": { "limit": { "default": 30, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "pattern": "^(free-)?[0-9a-f]{64}$", "description": "History ID returned by tts_generate or tts_list." } }, "additionalProperties": false } ``` ## 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. ```bash cURL theme={null} curl --request POST 'https://api.voicecheap.ai/v1/actions/tts_list' \ --header "x-api-key: $VOICECHEAP_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"limit":1}' ``` ```javascript JavaScript theme={null} const input = { limit: 1, }; const response = await fetch('https://api.voicecheap.ai/v1/actions/tts_list', { method: 'POST', headers: { 'x-api-key': process.env.VOICECHEAP_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify(input), }); const body = await response.json(); if (!response.ok) throw new Error(body.code + ': ' + body.message); console.log(body); ``` ```python Python theme={null} import os import requests response = requests.post( "https://api.voicecheap.ai/v1/actions/tts_list", headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]}, json={"limit": 1}, timeout=120, ) body = response.json() if not response.ok: raise RuntimeError(f"{body.get('code')}: {body.get('message')}") print(body) ``` ## 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ń. ```json HTTP 200 theme={null} { "data": { "items": [ { "historyId": "722c80c6412edd4c3dcd625061e1c1feafbb0d54274d95fd8b5ca047f8cdd23d", "textPreview": "Hello world.", "voice": "933563129e564b19a115bedd57b7406a", "voiceName": "Sarah", "voiceSource": "catalog", "inputType": "text", "instructionPreset": "narrator", "sourceFileName": "launch-script.txt", "characterCount": 12, "durationSeconds": 1.5, "isPreview": false, "createdAt": 1792152000000, "updatedAt": 1792152000000, "status": "success" } ], "nextCursor": "722c80c6412edd4c3dcd625061e1c1feafbb0d54274d95fd8b5ca047f8cdd23d" } } ``` ## Pola wyniku | Pole | Opis | | - | - | | `data.items` | Podsumowania historii mowy, od najnowszych. | | `data.items[].historyId` | Identyfikator własnej historii generowania mowy: 64 małe znaki szesnastkowe, opcjonalnie z prefiksem free- dla podglądu aplikacji. | | `data.items[].voice` | Oryginalny identyfikator wyboru TTS, w tym clone:\ dla zapisanego głosu niestandardowego. | | `data.items[].voiceName` | Opcjonalna zapisana nazwa wyświetlana wybranego głosu. | | `data.items[].voiceSource` | Opcjonalne źródło głosu: catalog lub clone. | | `data.items[].inputType` | Typ oryginalnego wejścia: text lub pdf. | | `data.items[].instructionPreset` | Zapisany zestaw ustawień wypowiedzi. | | `data.items[].sourceFileName` | Opcjonalna oryginalna nazwa pliku podana podczas generowania. | | `data.items[].characterCount` | Liczba znaków zarejestrowana dla tego wygenerowanego nagrania mowy. | | `data.items[].durationSeconds` | Czas trwania audio w sekundach. | | `data.items[].createdAt` | Czas utworzenia jako znacznik czasu Unix w milisekundach. | | `data.items[].updatedAt` | Czas ostatniej aktualizacji jako znacznik czasu Unix w milisekundach. | | `data.items[].status` | Zapisane pomyślne nagrania mowy używają success; tts\_generate używa completed w wyniku generowania. | | `data.items[].textPreview` | Pierwsze 180 znaków zapisanego skryptu. | | `data.items[].isPreview` | true, gdy audio zawiera tylko podgląd zapisanego skryptu. | | `data.nextCursor` | historyId ostatniego elementu dla pełnej strony, w przeciwnym razie null. | ## 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 | Status HTTP | Kod | Znaczenie lub sposób rozwiązania | | - | - | - | | 400 | `CREDENTIAL_IN_QUERY` | Dane uwierzytelniające zostały podane w parametrze zapytania access\_token lub api\_key. Wysyłaj dane uwierzytelniające w nagłówkach. | | 400 | `VALIDATION_ERROR` | Dane wejściowe nie odpowiadają schematowi akcji; sprawdź details, aby poznać błędy pól. | | 401 | `API_KEY_EXPIRED` | Klucz API wygasł. | | 401 | `INVALID_API_KEY` | Podaj prawidłowy, niewygasły klucz API. | | 401 | `INVALID_CREDENTIAL` | Nagłówek Authorization ma nieprawidłowy format lub jest sprzeczny z x-api-key. | | 401 | `MISSING_CREDENTIAL` | Nie podano użytecznych danych uwierzytelniających w nagłówku lub przekroczyły one 4096 znaków. | | 401 | `USER_NOT_FOUND` | Konto powiązane z poświadczeniem już nie istnieje. | | 403 | `AMBIGUOUS_TEAM_API_KEY` | Użytkownik, do którego należą dane uwierzytelniające, należy do więcej niż jednego zespołu, więc kontekst rozliczeniowy jest niejednoznaczny. | | 403 | `INSUFFICIENT_SCOPE` | Nadaj wszystkie wymagane uprawnienia lub wybierz inne dane uwierzytelniające. | | 403 | `INTEGRATION_PLAN_UNSUPPORTED` | Nie udało się zweryfikować limitów integracji konta. | | 403 | `SUBSCRIPTION_REQUIRED` | Użyj aktywnej płatnej subskrypcji. | | 403 | `TEAM_OWNER_NOT_FOUND` | Nie znaleziono konta faktycznego właściciela zespołu. | | 429 | `INTEGRATION_MONTHLY_LIMIT_REACHED` | Poczekaj na odnowienie miesięcznego limitu lub zmień plan. | | 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Jeśli występuje nagłówek Retry-After, odczekaj wskazany czas i stosuj rosnące odstępy między ponowieniami. | | 500 | `INTERNAL_ERROR` | Sprawdź stan zapisanego żądania i historię zasobu przed podjęciem decyzji o ponowieniu operacji zmieniającej dane. | | 503 | `SERVER_RESTARTING` | Serwer jest uruchamiany ponownie. Spróbuj ponownie wkrótce i zachowaj ten sam identyfikator żądania dla operacji zmieniającej dane. | ```json theme={null} { "code": "INSUFFICIENT_SCOPE", "message": "This credential does not permit the requested action.", "status": 403, "details": { "requiredScopes": ["tts:read"] } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.