Skip to main content
POST
Pobierz metadane i przykład do odtworzenia dla jednego głosu dubbingowego z katalogu lub własnego głosu należącego do Ciebie.

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.Minimalna długość: 1. Maksymalna długość: 255. Wzorzec: ^[A-Za-z0-9_-]+$.
string
Wartość tekstowa.Dozwolone wartości: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. Wartość domyślna: “en”.
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 katalogowy lub własny niestandardowy głos do dubbingu z publicznymi metadanymi i opcjonalną próbką do odtworzenia.

Pola wyniku

Uwagi do operacji

  • Użyj voiceId z dubbing_voices_list. To nieprzezroczysty identyfikator o długości 1–255 znaków, zawierający wyłącznie litery, cyfry, podkreślenia i łączniki.
  • locale ma te same wartości domyślne i akceptowane co dubbing_voices_list. Głosy z katalogu mogą zawierać zlokalizowane metadane language, accent, description, age, gender, useCase i category.
  • Własne głosy użytkownika zwracają source: custom i opcjonalne previewUrl; pomijają pola języka katalogowego. Pole audioExampleUrl z surowej odpowiedzi klonowania jest tutaj przedstawiane jako previewUrl.
  • 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