API Zadania Tłumaczenia

Utwórz zadanie tłumaczenia

POST/v1/translation/create

Utwórz nowe zadanie tłumaczenia dla tłumaczenia dokumentu/pliku.

Pełny adres: https://dltranslator.com/api/v1/translation/create
Uwierzytelnienie: Należy przekazać API Key w nagłówku żądania Authorization
Content-Type: multipart/form-data
Nieprawidłowy format: { "error": "Invalid API key." }

Uwagi

Utworzenie zadania powoduje natychmiastowe dodanie go do kolejki oczekiwania i zwraca taskId. Następnie można uzyskać postęp, koszty i link do pobrania za pomocą interfejsu zapytania o zadanie.

Saldo punktów na koncie musi wynosić co najmniej 2 credits, aby utworzyć zadanie. Gdy preview ma wartość true, generowany jest tylko podgląd i pobierane są punkty za podgląd.

Parametr glossary dopasowuje według nazwy glosariusza, można przekazać wiele pól o tej samej nazwie, aby określić wiele glosariuszy.

Przykład

curl

1curl -X POST 'https://dltranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese' \
6--form 'outputFormat=MD' \
7--form 'bilingualMode=Horizontal'

Parametry żądania

Parametry	Typ	Domyślny	Opis	Przykład
*file	binary	-	Plik wymagający tłumaczenia Obsługiwane typy plików: zapytanie	bitcoin.pdf
*fromLang	String	-	Język źródłowy, język źródłowy nie może być identyczny z językiem docelowym Obsługiwane języki: zapytanie	English
*toLang	String	-	Język docelowy, język docelowy nie może być identyczny z językiem źródłowym Obsługiwane języki: zapytanie	Simplified Chinese
model	String	-	Model AI do tłumaczenia Obsługiwane modele: zapytanie	-
fileDescription	String	-	Opis dokumentu - poprzez dostarczenie dodatkowych informacji można poprawić jakość tłumaczenia, na przykład dodając dodatkowe informacje kontekstowe o dokumencie i inne wymagania dotyczące tłumaczenia itp.	-
glossary	String	-	Nazwa glosariusza używanego podczas tłumaczenia	-
preview	Boolean	false	Czy generować tylko podgląd. Przy generowaniu tylko podglądu zapłać 2 kredyty, aby wygenerować podgląd tłumaczenia dokumentu	-
shouldTranslateImage	Boolean	false	Czy tłumaczyć obrazy w dokumencie Obsługuje wyłącznie PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Czy wymuszać użycie OCR do rozpoznawania zawartości dokumentu. Po włączeniu aktywowane zostanie również tłumaczenie obrazów.	-
shouldTranslateFileName	Boolean	true	Czy tłumaczyć nazwy plików	-
strictSourceLanguageCheck	Boolean	false	Czy tłumaczyć tylko tekst rozpoznany jako język źródłowy. Po włączeniu nastąpi bardziej rygorystyczne filtrowanie treści w języku innym niż źródłowy, a do obliczeń kosztów zostanie zastosowany bardziej rygorystyczny współczynnik.	-
outputFormat	String	-	Format wyjściowy. Po przekazaniu MD zostanie podjęta próba wygenerowania tłumaczenia w formacie Markdown.	MD
bilingualMode	String	Horizontal	Kierunek układu pliku dwujęzycznego. Horizontal oznacza zestawienie lewo-prawo, Vertical oznacza zestawienie góra-dół.	Horizontal
password	String	-	Hasło do otwierania pliku PDF	-
ignoreComments	Boolean	false	Czy ignorować komentarze w plikach DOCX, PPTX i XLSX	-
ignoreNotes	Boolean	false	Czy ignorować notatki w plikach PPTX	-
ignoreHeadersAndFooters	Boolean	false	Czy ignorować stopki i nagłówki w plikach DOCX	-
ignoreHidden	Boolean	false	Czy ignorować ukryte slajdy w plikach PPTX	-
ignoreMasters	Boolean	false	Czy ignorować tekst wzorca w plikach PPTX	-
ignoreSheetNames	Boolean	false	Czy nie tłumaczyć nazw arkuszy XLSX	-
extractTextRegExpPattern	String	-	Tłumacz wyłącznie zawartość pasującą do wyrażenia regularnego i zastąp ją tłumaczeniem Obsługuje wyłącznie txmsg	-
extractTextRegExpFlags	String	-	Flagi wyrażeń regularnych: g, s, m, u, y Obsługuje wyłącznie txmsg	-
allowFlip	Boolean	true	Czy zezwalać na odwracanie układu strony dla języków pisanych od prawej do lewej. Przekazanie false wyłączy jednocześnie odwracanie obrazów.	-
allowFlipImage	Boolean	true	Czy zezwalać na odwracanie zawartości obrazu dla języków pisanych od prawej do lewej.	-
webhookUrl	String	-	URL wywołania zwrotnego przy aktualizacji statusu, zawartość wywołania zwrotnego obejmuje: {taskId, progress, status}	-

Odpowiedź

Parametry	Typ	Domyślny	Opis	Przykład
taskId	String	-	ID zadania	-

Typowe błędy

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to create the task.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.

The provided source language is not supported.

400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.

The provided target language is not supported.

400 Missing required file upload: file.

Upload the source document in the file form field.

404 Glossary "[name]" not found.

The specified glossary does not exist or does not belong to the current API account.