API Tác vụ Dịch thuật

Tạo tác vụ dịch thuật

POST/v1/translation/create

Tạo tác vụ dịch thuật mới cho việc dịch tài liệu/tệp.

Địa chỉ đầy đủ: https://otranslator.com/api/v1/translation/create
Xác thực: Cần truyền API Key vào request header Authorization
Content-Type: multipart/form-data
Lỗi định dạng: { "error": "Invalid API key." }

Lưu ý

Tạo tác vụ sẽ ngay lập tức vào hàng đợi và trả về taskId. Sau đó có thể lấy thông tin về tiến độ, chi phí và liên kết tải xuống thông qua giao diện truy vấn tác vụ.

Số dư điểm tài khoản cần ít nhất 2 credits để tạo nhiệm vụ. Khi preview là true chỉ tạo bản xem trước và thanh toán điểm xem trước.

Tham số glossary được khớp theo tên bảng thuật ngữ, có thể truyền vào lặp lại nhiều trường cùng tên để chỉ định nhiều bảng thuật ngữ.

Ví dụ

curl

1curl -X POST 'https://otranslator.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'

Tham Số Yêu Cầu

Tham số	Loại	Mặc Định	Mô Tả	Ví dụ
*file	binary	-	Tệp cần dịch Loại tệp được hỗ trợ: truy vấn	bitcoin.pdf
*fromLang	String	-	Ngôn ngữ nguồn, ngôn ngữ nguồn không được trùng với ngôn ngữ đích Các ngôn ngữ được hỗ trợ: truy vấn	English
*toLang	String	-	Ngôn ngữ đích, ngôn ngữ đích không thể trùng với ngôn ngữ gốc Ngôn ngữ được hỗ trợ: truy vấn	Simplified Chinese
model	String	-	Mô hình AI dịch thuật Mô hình được hỗ trợ: truy vấn	-
fileDescription	String	-	Mô tả tài liệu, thông qua việc cung cấp thông tin bổ sung để nâng cao chất lượng dịch thuật, ví dụ như bổ sung thông tin bối cảnh tài liệu và các yêu cầu dịch thuật khác	-
glossary	String	-	Tên bảng thuật ngữ được sử dụng trong dịch thuật	-
preview	Boolean	false	Có chỉ tạo bản xem trước không. Khi chỉ tạo bản xem trước, thanh toán 2 credits để tạo bản xem trước dịch thuật tài liệu	-
shouldTranslateImage	Boolean	false	Có dịch hình ảnh trong tài liệu hay không Chỉ hỗ trợ PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Có cưỡng chế sử dụng OCR để nhận diện nội dung tài liệu hay không. Khi bật sẽ đồng thời kích hoạt tính năng dịch ảnh.	-
shouldTranslateFileName	Boolean	true	Có dịch tên tệp không	-
strictSourceLanguageCheck	Boolean	false	Chỉ dịch văn bản được nhận diện là ngôn ngữ gốc. Khi bật, sẽ lọc chặt chẽ hơn nội dung không phải ngôn ngữ nguồn, việc tính phí cũng sẽ áp dụng hệ số chặt chẽ hơn.	-
outputFormat	String	-	Định dạng đầu ra. Khi truyền vào MD sẽ thử tạo bản dịch Markdown.	MD
bilingualMode	String	Horizontal	Hướng bố trí tệp song ngữ. Horizontal có nghĩa là đối chiếu trái phải, Vertical là đối chiếu trên dưới.	Horizontal
password	String	-	Mật khẩu mở tệp PDF	-
ignoreComments	Boolean	false	Có bỏ qua các chú thích trong DOCX, PPTX và XLSX không	-
ignoreNotes	Boolean	false	Có bỏ qua ghi chú của PPTX không	-
ignoreHeadersAndFooters	Boolean	false	Có bỏ qua chân trang và đầu trang của DOCX không	-
ignoreHidden	Boolean	false	Có bỏ qua các trang ẩn của PPTX không	-
ignoreMasters	Boolean	false	Có bỏ qua văn bản slide mẫu của PPTX không	-
ignoreSheetNames	Boolean	false	Có không dịch tên sheet của XLSX	-
extractTextRegExpPattern	String	-	Chỉ dịch nội dung khớp với biểu thức chính quy và thay thế bằng bản dịch Chỉ hỗ trợ txmsg	-
extractTextRegExpFlags	String	-	Các Flags của biểu thức chính quy: g, s, m, u, y Chỉ hỗ trợ txmsg	-
allowFlip	Boolean	true	Cho phép lật bố cục trang đối với ngôn ngữ từ phải sang trái. Khi truyền false sẽ đồng thời tắt tính năng lật hình ảnh.	-
allowFlipImage	Boolean	true	Cho phép lật nội dung hình ảnh đối với ngôn ngữ từ phải sang trái.	-
webhookUrl	String	-	URL callback khi cập nhật trạng thái, nội dung callback bao gồm: {taskId, progress, status}	-

Phản Hồi

Tham số	Loại	Mặc Định	Mô Tả	Ví dụ
taskId	String	-	ID tác vụ	-

Lỗi thường gặp

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.