Skip to main content
Pobierz status tłumaczenia

Pobierz status tłumaczenia

Pobierz aktualny status projektu tłumaczeniowego. Użyj tego punktu końcowego, aby sprawdzać postępy i uzyskać adres URL przetłumaczonego wideo po zakończeniu przetwarzania.

Żądanie

Nagłówki

string
wymagane
Twój klucz API VoiceCheap. Uzyskaj go z app.voicecheap.ai/page-api.

Parametry ścieżki

string
wymagane
Unikalny identyfikator projektu tłumaczeniowego zwrócony z punktu końcowego Start Translation.

Odpowiedź

Struktura odpowiedzi różni się w zależności od statusu tłumaczenia.

Wspólne pola

string
wymagane
Unikalny identyfikator projektu
string
wymagane
Nazwa projektu
string
wymagane
Adres URL oryginalnego przesłanego pliku wideo/audio
string
wymagane
Wykryty lub określony język oryginalny
string
wymagane
Język docelowy tłumaczenia
number
wymagane
Czas trwania zawartości w sekundach
number
wymagane
Znacznik czasu Unix utworzenia projektu
string
wymagane
Przepływ pracy API, który utworzył projekt: translation lub transcription.
string
wymagane
Status transkrypcji źródłowej: processing, success lub failed. Ten sygnał jest niezależny od zakończenia procesu dubbing.
object
wymagane
Dostępne znormalizowane transkrypcje.
string
Identyfikator pracy tłumaczeniowej dla aktualnie raportowanej wersji przetłumaczonej.
string
Identyfikator wersji przetłumaczonej dla aktualnie raportowanej wersji przetłumaczonej.
string
Aktualny krok projektu. Podczas tworzenia lub transkrypcji odzwierciedla to aktywny krok tworzenia. Przykłady obejmują downloading_content, content_validation oraz transcription_processing. Gdy rozpocznie się dubbing, może on przełączyć się na aktywny krok dubbingu, taki jak smart_sync lub audio_assembling. status: processing nie łączy się z actualProgressStep: done.
number
Przybliżony procent postępu tworzenia/transkrypcji projektu (0-100)
string
Aktualny krok dubbingu dla języka docelowego (np. smart_sync, audio_enhancement, video_upload)
number
Przybliżony procent postępu dubbingu (0-100)
string
wymagane
Aktualny status tłumaczenia: processing, success lub failed

Pola Lip Sync

Gdy zażądano synchronizacji ruchu ust (lip sync), odpowiedź zawiera dodatkowy obiekt lipSync:
object
Status synchronizacji ruchu ust i szczegóły wyjściowe (obecne tylko wtedy, gdy zażądano synchronizacji ruchu ust)
Gdy żądana jest synchronizacja ruchu ust, tłumaczenie pozostaje w processing, dopóki lipSync.status nie zostanie COMPLETED. Jeśli synchronizacja ruchu ust nie powiedzie się, status zmienia się na failed, a error.code to LIPSYNC_FAILED. Gdy synchronizacja ruchu ust zakończy się powodzeniem, odczytaj zasób z synchronizacją ruchu ust z lipSync.videoUrl; translatedVideoUrl to przetłumaczony plik wideo przed nałożeniem synchronizacji ruchu ust.
Użyj GET /v1/projects/{projectId}, gdy potrzebujesz pełnej historii wersji tłumaczenia lub pełnej historii synchronizacji ruchu ust.

Pola odpowiedzi o sukcesie

W przypadku przepływów pracy tłumaczenia, następujące pola są uwzględniane, gdy status to success. Przepływ pracy obejmujący tylko transkrypcję osiąga success bez pól przetłumaczonych mediów.
string
URL do pobrania przetłumaczonego pliku wideo
string
URL do pobrania przetłumaczonego pliku audio osobno

Pola odpowiedzi o błędzie

Gdy status to failed, uwzględniane jest następujące dodatkowe pole:
object
Szczegóły błędu

Przykłady

Przykłady odpowiedzi

Status przetwarzania

Status przetwarzania (Lip Sync żądane)

Status sukcesu

Status sukcesu (Lip Sync ukończone)

Status błędu

Najlepsze praktyki odpytywania

Zalecany interwał odpytywania: 10-30 sekundCzas tłumaczenia różni się w zależności od długości i złożoności wideo. W przypadku typowego 2-minutowego wideo należy oczekiwać 2-5 minut czasu przetwarzania.
Limit szybkości: 30 żądań na minutęUnikaj odpytywania częściej niż raz na 2 sekundy, aby pozostać w granicach limitów szybkości.

Błędy