Utwórz projekt dubbingu
Utwórz projekt dubbingowy z przesłanego pliku (file) lub źródłowego adresu URL (source_url).
Zwraca wynik, gdy tylko istnieje rekord projektu, zanim źródło zostanie pobrane: projekt zaczyna ze statusem queued i osiąga status ready po transkrypcji źródła. Dodaj wersję językową dla każdego wybranego języka albo przekaż target_language, aby ustawić pierwszą w kolejce.
Utworzenie projektu wiąże się z minimalną opłatą za jeden język: podczas tworzenia projektu naliczana jest opłata za dubbing co najmniej jednego języka, zanim powstanie jakikolwiek wynik. Opłata ta opłaca z góry pierwszą wersję językową — pierwsza dodana wersja lub wersja ustawiona w kolejce przez target_language ją wykorzystuje — a każdy kolejny język jest rozliczany osobno.
Przygotowanie długiego źródła może potrwać kilka minut, dlatego zamiast odpytywać o status zalecamy przekazanie webhook_ids, aby otrzymać powiadomienie, gdy projekt osiągnie status ready lub failed.
Nagłówki
Żądanie
Źródłowy plik multimedialny do dubbingu: plik audio lub wideo o maksymalnym rozmiarze 3 GiB. Podaj ten parametr albo source_url, nie oba.
Publiczny adres URL HTTP(S), z którego media źródłowe są pobierane po stronie serwera; obowiązują te same limity rozmiaru i formatu co przy przesyłaniu. Podaj ten parametr albo file, nie oba.
Opcjonalny dowolny ciąg znaków (maks. 500 znaków) do identyfikacji projektu po twojej stronie. Jest przechowywany i zwracany bez zmian; nie wpływa na dubbing.
Tag językowy BCP-47 materiału źródłowego; musi wskazywać język obsługiwany przez model transkrypcji. Wszystkie podtagi regionu i pisma są ignorowane, ponieważ transkrypcja odbywa się według języka. Pomiń, aby wykryć automatycznie.
Model dubbingu (dubbing_v1 lub dubbing_v2) używany dla każdego języka docelowego w tym projekcie. Domyślnie dubbing_v2. Ustalany podczas tworzenia — źródło jest przygotowywane dla tego modelu, więc później nie można go zmienić ani dla projektu, ani dla pojedynczego języka docelowego.
Kluczowe terminy preferowane w transkrypcji i tłumaczeniu (na przykład nazwy produktów lub marek). Maksymalnie 1000 terminów; każdy do 50 znaków i 5 słów; znaki <>{}[]\ są niedozwolone. Terminy są przycinane i usuwane są duplikaty. Powtórz pole dla każdego terminu lub przekaż pojedynczą tablicę JSON.
ID webhooków workspace, które należy powiadamiać o postępie projektu — to zalecana przez nas alternatywa dla odpytywania. Każdy otrzyma zdarzenie dubbing_project_ready lub dubbing_project_failed dla projektu oraz zdarzenie dubbing_language_completed lub dubbing_language_failed dla każdego języka w projekcie; dubbing_language_completed zawiera adresy URL pobierania wyników. Maksymalnie 3 ID, każde już skonfigurowane w workspace — zobacz Webhooki, aby dowiedzieć się, jak go utworzyć i zweryfikować podpis. Powtórz pole dla każdego ID albo przekaż pojedynczą tablicę JSON lub ciąg rozdzielany przecinkami. Dostarczanie działa na zasadzie best-effort i może się powtarzać, dlatego zalecamy idempotentną obsługę zdarzeń.
Opcjonalny skrót: utwórz też docelowy język w tym języku BCP-47, który rozpocznie się, gdy projekt będzie gotowy — to odpowiednik utworzenia projektu, a następnie jednego docelowego języka. Musi to być jeden z języków obsługiwanych przez model dubbingu, a tag z regionem musi wskazywać obsługiwany dialekt. To pierwszy docelowy język, więc wykorzystuje minimalną opłatę za projekt, zamiast ją zwiększać. Jego ID jest zwracane w language_ids.
Tylko Enterprise. Opcjonalna transkrypcja JSON używana zamiast transkrypcji źródła: dokument {"segments": [...]}, maksymalnie 20 000 segmentów i 4 MiB. Pola segmentów i ich ograniczenia znajdziesz w artykule Użyj własnej transkrypcji. source_language jest wymagane, gdy podajesz transkrypcję. Jeśli którykolwiek segment zawiera translation, wymagane jest target_language i każdy segment musi je zawierać; te tłumaczenia inicjują cel utworzony przez target_language, który pomija wtedy tłumaczenie maszynowe.
Odpowiedź
Pomyślna odpowiedź
Status cyklu życia projektu: queued przed pobraniem źródła, preparing podczas transkrypcji, ready po zakończeniu transkrypcji, gdy można rozpocząć pracę z językami docelowymi, lub failed. Projekt nigdy nie ma statusu processing — ta wartość dotyczy języków docelowych.
Licznik monotoniczny zwiększany przy każdej edycji transkrypcji źródłowej (dodaniu, edycji lub usunięciu segmentu).
Dowolny ciąg podany jako reference podczas tworzenia projektu albo null, jeśli go nie podano.
Tag językowy BCP-47 materiału źródłowego (null, jeśli wykryto automatycznie).
Model dubbingu używany dla każdego języka docelowego w tym projekcie. Ustalany podczas tworzenia i niewybieralny dla poszczególnych języków.
Metadane mediów źródłowych, uzupełniane po pobraniu i zdekodowaniu źródła (krótko po utworzeniu, zanim projekt uzyska status ready); do tego czasu null.
Identyfikatory języków docelowych w tym projekcie. Uzupełniane podczas pobierania pojedynczego projektu oraz przy tworzeniu, gdy target_language utworzy język docelowy. W odpowiedziach listy zawsze są puste — zamiast tego wyświetl języki docelowe projektu.
ID webhooków workspace powiadamianych, gdy ten projekt i jego języki osiągną status ready, completed lub failed.
Dlaczego projekt się nie powiódł; null, chyba że status ma wartość failed. Również null dla nielicznych projektów, które nie powiodły się przed wprowadzeniem raportowania błędów.
Niekrytyczne problemy występujące podczas przygotowania źródła; jeśli ich nie ma, lista jest pusta. Odzwierciedla najnowsze przygotowanie. Problemy podczas dubbingu konkretnego języka są zgłaszane dla tego języka.