API Tugas Terjemahan

Buat Tugas Terjemahan

POST/v1/translation/create

Buat tugas terjemahan baru untuk penerjemahan dokumen/file.

Alamat lengkap: https://otranslator.com/api/v1/translation/create
Autentikasi: Perlu menyertakan API Key di header permintaan Authorization
Content-Type: multipart/form-data
Format error: { "error": "Invalid API key." }

Hal-hal yang Perlu Diperhatikan

Membuat tugas akan langsung masuk ke antrian tunggu dan mengembalikan taskId. Selanjutnya dapat memperoleh progres, biaya, dan tautan unduh melalui antarmuka kueri tugas.

Saldo poin akun minimal memerlukan 2 credits untuk membuat tugas. Ketika preview bernilai true, hanya akan menghasilkan pratinjau dan membayar poin pratinjau.

Parameter glossary dicocokkan berdasarkan nama glosarium, dapat dimasukkan secara berulang dengan beberapa field bernama sama untuk menentukan beberapa glosarium.

Contoh

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'

Parameter Permintaan

Parameter	Jenis	Bawaan	Deskripsi	Contoh
*file	binary	-	File yang perlu diterjemahkan Jenis file yang didukung: kueri	bitcoin.pdf
*fromLang	String	-	Bahasa sumber, bahasa sumber tidak boleh sama dengan bahasa target Bahasa yang didukung: kueri	English
*toLang	String	-	Bahasa target, bahasa target tidak boleh sama dengan bahasa sumber Bahasa yang didukung: kueri	Simplified Chinese
model	String	-	Model AI untuk penerjemahan Model yang didukung: kueri	-
fileDescription	String	-	Deskripsi dokumen: meningkatkan kualitas terjemahan dengan menyediakan informasi tambahan, seperti menambahkan informasi latar belakang dokumen dan kebutuhan terjemahan lainnya	-
glossary	String	-	Nama glosarium yang digunakan untuk terjemahan	-
preview	Boolean	false	Apakah hanya menghasilkan pratinjau. Ketika hanya menghasilkan pratinjau, bayar 2 credits untuk menghasilkan pratinjau terjemahan dokumen	-
shouldTranslateImage	Boolean	false	Apakah akan menerjemahkan gambar dalam dokumen Hanya mendukung PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Paksa penggunaan OCR untuk mengenali konten dokumen. Setelah diaktifkan akan juga mengaktifkan terjemahan gambar.	-
shouldTranslateFileName	Boolean	true	Apakah menerjemahkan nama file	-
strictSourceLanguageCheck	Boolean	false	Apakah hanya menerjemahkan teks yang teridentifikasi sebagai bahasa sumber. Setelah diaktifkan akan memfilter konten non-bahasa sumber secara lebih ketat, perhitungan biaya juga akan menggunakan koefisien yang lebih ketat.	-
outputFormat	String	-	Format output. Ketika meneruskan MD, akan mencoba menghasilkan terjemahan Markdown.	MD
bilingualMode	String	Horizontal	Arah tata letak file bilingual. Horizontal menunjukkan perbandingan kiri-kanan, Vertical menunjukkan perbandingan atas-bawah.	Horizontal
password	String	-	Kata sandi pembuka file PDF	-
ignoreComments	Boolean	false	Apakah mengabaikan komentar pada DOCX, PPTX, dan XLSX	-
ignoreNotes	Boolean	false	Apakah mengabaikan catatan PPTX	-
ignoreHeadersAndFooters	Boolean	false	Apakah mengabaikan footer dan header DOCX	-
ignoreHidden	Boolean	false	Apakah mengabaikan slide tersembunyi PPTX	-
ignoreMasters	Boolean	false	Apakah mengabaikan teks master PPTX	-
ignoreSheetNames	Boolean	false	Apakah tidak menerjemahkan nama sheet XLSX	-
extractTextRegExpPattern	String	-	Hanya menerjemahkan konten yang sesuai dengan regular expression, dan menggantinya dengan hasil terjemahan Hanya mendukung txmsg	-
extractTextRegExpFlags	String	-	Flags ekspresi reguler: g, s, m, u, y Hanya mendukung txmsg	-
allowFlip	Boolean	true	Apakah diizinkan membalik tata letak halaman untuk bahasa dari kanan ke kiri. Saat diatur ke false akan sekaligus menonaktifkan pembalikan gambar.	-
allowFlipImage	Boolean	true	Apakah diizinkan membalik konten gambar untuk bahasa dari kanan ke kiri.	-
webhookUrl	String	-	URL callback untuk pembaruan status, konten callback meliputi: {taskId, progress, status}	-

Respons

Parameter	Jenis	Bawaan	Deskripsi	Contoh
taskId	String	-	ID Tugas	-

Kesalahan Umum

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.