API Tugasan Terjemahan

Cipta Tugasan Terjemahan

POST/v1/translation/create

Cipta tugasan terjemahan baharu untuk terjemahan dokumen/fail.

Alamat lengkap: https://otranslator.com/api/v1/translation/create
Pengesahan: Perlu memasukkan API Key dalam pengepala permintaan Authorization
Content-Type: multipart/form-data
Format salah: { "error": "Invalid API key." }

Perkara Perhatian

Membuat tugas akan segera memasuki barisan menunggu, dan mengembalikan taskId. Seterusnya boleh mendapatkan kemajuan, kos dan pautan muat turun melalui antara muka pertanyaan tugas.

Baki kredit akaun perlu sekurang-kurangnya 2 credits untuk mencipta tugasan. Apabila preview adalah true, hanya pratonton dijana dan kredit pratonton dibayar.

Parameter glossary sepadan dengan nama glosari, boleh diulang dengan menghantar berbilang medan bernama sama untuk menentukan berbilang glosari.

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	Lalai	Keterangan	Contoh
*file	binary	-	Fail yang perlu diterjemahkan Jenis fail yang disokong: pertanyaan	bitcoin.pdf
*fromLang	String	-	Bahasa asal, bahasa asal tidak boleh sama dengan bahasa sasaran Bahasa yang disokong: pertanyaan	English
*toLang	String	-	Bahasa sasaran, bahasa sasaran tidak boleh sama dengan bahasa asal Bahasa yang disokong: pertanyaan	Simplified Chinese
model	String	-	Model AI untuk terjemahan Model yang disokong: pertanyaan	-
fileDescription	String	-	Penerangan dokumen, meningkatkan kualiti terjemahan dengan menyediakan maklumat tambahan, contohnya menambah maklumat latar belakang dokumen tambahan dan keperluan terjemahan lain	-
glossary	String	-	Nama glosari yang digunakan untuk penterjemahan	-
preview	Boolean	false	Adakah hanya menjana pratonton. Apabila hanya menjana pratonton, bayar 2 credits untuk menjana pratonton terjemahan dokumen	-
shouldTranslateImage	Boolean	false	Sama ada untuk menterjemah imej dalam dokumen Hanya menyokong PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Sama ada memaksa penggunaan OCR untuk mengenal pasti kandungan dokumen. Selepas diaktifkan, terjemahan imej juga akan diaktifkan.	-
shouldTranslateFileName	Boolean	true	Sama ada menterjemah nama fail	-
strictSourceLanguageCheck	Boolean	false	Sama ada hanya menterjemah teks yang dikenalpasti sebagai bahasa asal. Selepas diaktifkan, kandungan bukan bahasa sumber akan ditapis dengan lebih ketat, dan pengiraan kos juga akan menggunakan pekali yang lebih ketat.	-
outputFormat	String	-	Format output. Apabila MD dihantar, sistem akan cuba menjana terjemahan Markdown.	MD
bilingualMode	String	Horizontal	Arah susun atur fail dwibahasa. Horizontal bermaksud paparan kiri-kanan, Vertical bermaksud paparan atas-bawah.	Horizontal
password	String	-	Kata laluan pembukaan fail PDF	-
ignoreComments	Boolean	false	Adakah mengabaikan ulasan dalam DOCX dan PPTX, XLSX	-
ignoreNotes	Boolean	false	Adakah mengabaikan nota PPTX	-
ignoreHeadersAndFooters	Boolean	false	Adakah mengabaikan pengaki dan pengepala DOCX	-
ignoreHidden	Boolean	false	Adakah mengabaikan halaman tersembunyi PPTX	-
ignoreMasters	Boolean	false	Adakah mengabaikan teks induk PPTX	-
ignoreSheetNames	Boolean	false	Sama ada tidak menterjemah nama jadual XLSX	-
extractTextRegExpPattern	String	-	Hanya menterjemah kandungan yang sepadan dengan ungkapan nalar, dan menggantikannya dengan terjemahan Hanya menyokong txmsg	-
extractTextRegExpFlags	String	-	Flags ungkapan biasa: g, s, m, u, y Hanya menyokong txmsg	-
allowFlip	Boolean	true	Membenarkan pembalikan susun atur halaman untuk bahasa dari kanan ke kiri. Menghantar false akan turut mematikan pembalikan imej.	-
allowFlipImage	Boolean	true	Membenarkan pembalikan kandungan imej untuk bahasa dari kanan ke kiri.	-
webhookUrl	String	-	URL panggilan balik semasa kemaskini status, kandungan panggilan balik mengandungi: {taskId, progress, status}	-

Respons

Parameter	Jenis	Lalai	Keterangan	Contoh
taskId	String	-	ID Tugasan	-

Ralat Biasa

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.