Skip to main content
Rozpocznij tłumaczenie

Rozpocznij tłumaczenie

Utwórz nowy projekt tłumaczenia, przesyłając plik wideo lub audio. Proces tłumaczenia przebiega asynchronicznie w tle. Użyj punkt końcowy statusu, aby śledzić postępy i pobierać wyniki. Użyj Pobierz szczegóły projektu, gdy potrzebujesz historii przetłumaczonych wersji lub historii synchronizacji ruchu ust.

Limit współbieżności

Możesz uruchomić do 10 tłumaczeń jednocześnie na konto. Jeśli 10 tłumaczeń jest już w toku, nowe żądania zwrócą CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429).

Żądanie

Ten punkt końcowy akceptuje multipart/form-data z przesłaniem pliku.

Nagłówki

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

Parametry treści

file
wymagane
Plik wideo lub audio do przetłumaczenia.Obsługiwane formaty wideo: video/mp4, video/quicktime, video/x-matroska, video/webm, video/mpegObsługiwane formaty audio: audio/mpeg, audio/wav, audio/mp4, audio/x-m4a, audio/flac, audio/ogg, audio/aac, audio/webmMaksymalny rozmiar pliku według planu: Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB oraz Enterprise 60 GB.
string
wymagane
Język, na który ma zostać przetłumaczona treść. Musi być zapisany małymi literami.Dozwolone wartości (70+): afrikaans, albanian, amharic, arabic, armenian, assamese, azerbaijani, basque, belarusian, bengali, bosnian, bulgarian, catalan, croatian, czech, danish, dutch, english, british english, estonian, finnish, french, french canadian, galician, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, irish, italian, japanese, kannada, kazakh, khmer, korean, lao, latvian, lithuanian, macedonian, malay, malayalam, mandarin, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, brazilian portuguese, punjabi, romanian, russian, serbian, slovak, slovenian, spanish, swahili, swedish, tagalog, tamil, telugu, thai, turkish, ukrainian, urdu, vietnamese, welsh, yoruba, zulu
string
Język źródłowy treści przy użyciu kodów językowych ISO (np. en, es, fr, de, ja, zh).
Zdecydowanie zalecane: Pozostaw to pole puste w celu automatycznego wykrywania.Podaj ten parametr tylko wtedy, gdy masz 100% pewności, że kod języka jest poprawny i zgodny z formatem ISO. Nieprawidłowe kody języków spowodują błędy transkrypcji. Nasze automatyczne wykrywanie obsługuje ponad 80 języków i jest wysoce dokładne.
Domyślnie: auto-detect
string
Niestandardowa nazwa projektu. Przydatna do identyfikacji projektów w Twoim panelu.Domyślnie: Jeśli nie zostanie podana, użyty zostanie identyfikator projektu.
string
Punkt końcowy https, który odbiera zdarzenia webhook dla tego projektu, zastępując punkt końcowy skonfigurowany na Twoim koncie.Domyślnie: Punkt końcowy webhook konta, jeśli został skonfigurowany.
string
auto-detect lub liczba całkowita od 1 do 32. Znana liczba mówców może poprawić diaryzację.Domyślnie: auto-detect
string
Tablica ciągów JSON zawierająca specyficzne dla żądania nazwy, marki, akronimy lub terminy specjalistyczne. Terminy te są łączone z zapisanym glosariuszem konta lub zespołu.
boolean
Usuń typowe słowa wypełniacze z transkrypcji źródłowej przed tłumaczeniem.Domyślnie: true
string
Istniejąca transkrypcja SRT w języku źródłowym. originalLanguage musi być jawnie określone, gdy podano to pole.
boolean
Czy zachować dźwięk w tle w danych wyjściowych.Po włączeniu zachowuje muzykę w tle, otoczenie, śmiech, oklaski i dźwięki tłumu, usuwając jednocześnie tylko oryginalny głos (separacja ścieżek). Wyłącz, jeśli źródło nie zawiera dźwięku w tle.Domyślnie: true
boolean
Zachowaj oryginalnego mówcę cicho pod przetłumaczonym głosem.Domyślnie: false
number
Głośność oryginalnego głosu od 1 do 70, gdy włączona jest opcja keepOriginalVoice.Domyślnie: 30
string
Tryb izolacji głosu, gdy włączona jest opcja keepBackgroundMusic. Kontroluje jakość i charakterystykę separacji głosu.
Nasze domyślne przetwarzanie głosu, zaprojektowane z myślą o profesjonalnej jakości dźwięku:
  • Usuwa echa i pogłosy
  • Czyści niedoskonałości techniczne
  • Generuje czysty i wyraźny głos
Zalecane dla: Większości projektów, w których jakość dźwięku jest najważniejsza. Idealne do samouczków, treści edukacyjnych, filmów marketingowych i wszelkich treści wymagających optymalnej czystości głosu.
Zachowuje naturalne cechy środowiska nagrania:
  • Utrzymuje dźwięk zbliżony do oryginalnego nagrania
  • Zachowuje charakterystykę środowiskową
Zalecane dla: Treści, w których autentyczność otoczenia jest ważna, takich jak vlogi plenerowe, filmy dokumentalne lub treści, w których atmosfera dźwiękowa jest integralną częścią doświadczenia.
Ta opcja może w niektórych przypadkach powodować artefakty lub nieoczekiwane efekty ze względu na zachowanie elementów tła.
Dozwolone wartości: studio, realisticDomyślnie: studio
boolean
Czy generować napisy dla przetłumaczonego wideo.Po włączeniu dodaje czyste napisy w stylu Netflixa (czarno-białe). Użyj subtitlesSource, aby wybrać tekst oryginalny (język źródłowy) lub przetłumaczony (język docelowy). Napisy są automatycznie synchronizowane dla optymalnej czytelności.Uwaga: Napisy wtopione wymagają FFmpeg z filtrem subtitles (libass). Jeśli jest niedostępny, API zamiast twardego wypalenia stylu osadzi ścieżkę napisów.Domyślnie: false
string
Wybierz źródło tekstu napisów, gdy włączona jest opcja subtitles.Dozwolone wartości: translated, originalDomyślnie: translatedUwaga: Jeśli wybrano original, ale oryginalna transkrypcja jest niedostępna, napisy zostaną zastąpione przez translated.
string
Uruchom przetwarzanie synchronizacji ruchu ust po zakończeniu tłumaczenia.
  • standard = Lip Sync
  • pro = Lip Sync Pro
  • studio = Lip Sync Studio
Tryby premium wymagają spełnienia standardowych wymogów dotyczących planu, czasu trwania i kredytów.Domyślnie: pomiń pole, aby pominąć synchronizację ruchu ust.
boolean
Włącz wykrywanie aktywnego mówcy dla żądanego procesu synchronizacji ruchu ust.Domyślnie: false
boolean
Starszy selektor synchronizacji ruchu ust zachowany dla kompatybilności wstecznej.
  • false = Standardowa synchronizacja ruchu ust (4 minuty kredytów na 1 minutę wideo)
  • true = Lip Sync Pro (9 minut kredytów na 1 minutę wideo)
Lip Sync Pro jest dostępna począwszy od planu Creator.
Maksymalny czas trwania: 30 minut na wideo.Opóźnienie: Przetwarzanie synchronizacji ruchu ust zazwyczaj dodaje 2x-4x czasu trwania oryginalnego wideo.
E-maile o zakończeniu lub błędzie synchronizacji ruchu ust nie są wysyłane dla żądań wyzwalanych przez API. Użyj punkt końcowy statusu, aby śledzić postępy.
Domyślnie: niewłączone (pomiń pole, aby pominąć synchronizację ruchu ust)Form-data: Wysyłaj wartości logiczne jako ciągi znaków true lub false (np. -F "lipsyncPro=false").
Nie łącz lipsyncPro z wykluczającym się lipSyncMode.
string
Strategia głosowa: cloning lub custom.Domyślnie: cloning
string
Wymagane, gdy voiceMode to custom. Głos musi należeć do faktycznego właściciela projektu. Dowolne lub nieprzypisane identyfikatory głosów są odrzucane.
object
Dostosuj parametry klonowania głosu, aby uzyskać zaawansowaną kontrolę nad generowanym głosem. Przekaż jako ciąg JSON podczas używania form-data. Wszystkie wartości muszą mieścić się w zakresie od 0 do 1 (z krokiem 0,01).
Te ustawienia mają zastosowanie tylko wtedy, gdy voiceMode to cloning.
Wartości domyślne (zrównoważone):
Zalecane w celu uniknięcia odtwarzania akcentu:
string
Tablica JSON zawierająca zakresy czasowe źródła, które powinny pozostać w oryginalnym języku.
Pominięcia czasowe wymagają wejścia wideo i keepBackgroundMusic=true. Nie można ich łączyć z keepOriginalVoice i nie mogą nakładać się na segmenty transkrypcji.

Odpowiedź

boolean
wymagane
Zawsze true dla udanych żądań
string
wymagane
Czytelny dla człowieka komunikat opisujący wynik
string
wymagane
Unikalny identyfikator utworzonego projektu tłumaczenia. Użyj tego identyfikatora, aby sprawdzić status.
number
wymagane
Przybliżony szacowany czas przetwarzania w minutach. Obecny szacunek to pięć minut przetwarzania na każdą rozpoczętą minutę mediów źródłowych.

Przykłady

Zapisane reguły glosariusz oraz niestandardowe instrukcje tłumaczenia z aktywnego konta lub zespołu są stosowane automatycznie.

Przykład odpowiedzi

Błędy