Skip to main content
POST
Sprawdzaj postęp transkrypcji, tłumaczenia i synchronizacji ruchu ust oraz pobieraj adresy URL ukończonych wynikó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: projects: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ść: 200. Wzorzec: ^[^/\\]+$.
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. Zwraca postęp przetwarzania i adresy URL ukończonych wyników bez osadzonych transkrypcji.

Pola wyniku

Uwagi do operacji

  • Użyj tej akcji do sprawdzania stanu projects_create, translations_create, translations_start, translations_dub i lipsync_create. Transkrypcje pobieraj osobno przez transcripts_get.
  • Ten uwierzytelniony odczyt stanu, podlegający limitowi częstotliwości, nie zużywa miesięcznego limitu wywołań akcji.
  • W przypadku tłumaczeń śledzi ostatnio utworzoną wersję językową i jej ostatnią wersję. Aby uzyskać pełny stan wielu języków, odczytaj projects_get lub translations_list.
  • Projekt obejmujący tylko transkrypcję kończy się pomyślnie po ukończeniu transkrypcji. Ukończony wynik dubbingu może pozostać w stanie processing, gdy synchronizacja ruchu ust jest aktywna, lub w stanie failed, jeśli ostatnia synchronizacja ruchu ust się nie powiodła.
  • Procedura obsługi zawsze usuwa transcripts z bazowego wyniku stanu. Nie zawiera pól ukończenia dynamicznych napisów; sprawdzaj je przez projects_get.
  • Zapisane błędy zwracają kody błędów VoiceCheap i stałe komunikaty. Użyj kodu i aktualnego stanu zasobu, aby zdecydować, jak wznowić działanie.

Wykorzystanie

Ta kontrola stanu lub wykorzystania nie zużywa miesięcznego limitu wywołań API/MCP. Nadal obowiązują zasady uwierzytelniania, płatnego dostępu, własności i limitów częstotliwości.

Błędy