For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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
xi-api-keystringOpcjonalny
Żądanie
This endpoint expects a multipart form with multiple files.
filefileOpcjonalny
Źródłowy plik multimedialny do dubbingu: plik audio lub wideo o maksymalnym rozmiarze 3 GiB. Podaj ten parametr albo source_url, nie oba.
source_urlstring or nullOpcjonalny
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.
referencestring or nullOpcjonalny
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.
source_languagestring or nullOpcjonalny
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_idenum or string or nullOpcjonalny
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.
keytermslist of stringsOpcjonalny
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.
webhook_idslist of stringsOpcjonalny
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](https://elevenlabs.io/docs/eleven-api/resources/webhooks), 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ń.
target_languagestring or nullOpcjonalny
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](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing), 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`.
transcriptfileOpcjonalny
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](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript). `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ź
project_idstring
Unikalny identyfikator projektu dubbingu.
statusenum
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.
Dozwolone wartości:
revisioninteger
Licznik monotoniczny zwiększany przy każdej edycji transkrypcji źródłowej (dodaniu, edycji lub usunięciu segmentu).
created_atstringformat: "date-time"
Kiedy utworzono projekt.
updated_atstringformat: "date-time"
Kiedy ostatnio zaktualizowano projekt.
referencestring or nullOpcjonalny
Dowolny ciąg podany jako reference podczas tworzenia projektu albo null, jeśli go nie podano.
source_languagestring or nullOpcjonalny
Tag językowy BCP-47 materiału źródłowego (null, jeśli wykryto automatycznie).
model_idstring or nullOpcjonalny
Model dubbingu używany dla każdego języka docelowego w tym projekcie. Ustalany podczas tworzenia i niewybieralny dla poszczególnych języków.
mediaobject or nullOpcjonalny
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.
language_idslist of stringsOpcjonalnyDomyślnie []
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.
webhook_idslist of stringsOpcjonalnyDomyślnie []
ID webhooków workspace powiadamianych, gdy ten projekt i jego języki osiągną status ready, completed lub failed.
errorobject or nullOpcjonalny
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.
warningslist of objectsOpcjonalny
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.
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.
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.
