API งานการแปล
สร้างงานแปล
สร้างงานแปลใหม่สำหรับการแปลเอกสาร/ไฟล์
- ที่อยู่แบบเต็ม
- https://dltranslator.com/api/v1/translation/create
- การรับรอง
- ต้องส่งผ่าน API Key ในส่วนหัวคำขอ Authorization
- Content-Type
- multipart/form-data
- รูปแบบผิดพลาด
- { "error": "Invalid API key." }
ข้อควรระวัง
การสร้างงานจะเข้าสู่คิวรอทันทีและส่งคืน taskId ซึ่งสามารถใช้ตรวจสอบความคืบหน้า ค่าใช้จ่าย และลิงก์ดาวน์โหลดผ่านอินเทอร์เฟซสอบถามงานได้ในภายหลัง
ยอดคงเหลือคะแนนในบัญชีต้องมีอย่างน้อย 2 credits เพื่อสร้างงานเมื่อ preview เป็น true จะสร้างเฉพาะตัวอย่างและชำระคะแนนสำหรับตัวอย่าง
พารามิเตอร์ glossary จับคู่ตามชื่ออภิธานศัพท์ สามารถส่งค่าฟิลด์ชื่อเดียวกันได้หลายครั้งเพื่อระบุอภิธานศัพท์หลายรายการ
ตัวอย่าง
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' พารามิเตอร์ของคำขอ
| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | คำอธิบาย | ตัวอย่าง |
|---|---|---|---|---|
| *file | binary | - |
| bitcoin.pdf |
| *fromLang | String | - |
| English |
| *toLang | String | - |
| Simplified Chinese |
| model | String | - |
| - |
| fileDescription | String | - | คำอธิบายเอกสาร ปรับปรุงคุณภาพการแปลด้วยการให้ข้อมูลเพิ่มเติม เช่น การเพิ่มข้อมูลพื้นหลังของเอกสารและความต้องการด้านการแปลอื่นๆ | - |
| glossary | String | - | ชื่อคำศัพท์เฉพาะที่ใช้ในการแปล | - |
| preview | Boolean | false | สร้างเฉพาะตัวอย่างหรือไม่เมื่อสร้างเฉพาะตัวอย่าง จ่าย 2 credits เพื่อสร้างตัวอย่างการแปลเอกสาร | - |
| shouldTranslateImage | Boolean | false |
| - |
| forceOCR | Boolean | false | บังคับให้ใช้ OCR ในการจดจำเนื้อหาเอกสาร เมื่อเปิดใช้งานจะเปิดใช้งานการแปลภาพพร้อมกันด้วย | - |
| shouldTranslateFileName | Boolean | true | แปลชื่อไฟล์หรือไม่ | - |
| strictSourceLanguageCheck | Boolean | false | แปลเฉพาะข้อความที่ระบุเป็นภาษาต้นทางหรือไม่เมื่อเปิดใช้งานจะกรองเนื้อหาที่ไม่ใช่ภาษาต้นทางอย่างเข้มงวดยิ่งขึ้น และการคำนวณค่าใช้จ่ายจะใช้สัมประสิทธิ์ที่เข้มงวดยิ่งขึ้นเช่นกัน | - |
| outputFormat | String | - | รูปแบบการแสดงผลเมื่อส่ง MD จะพยายามสร้างผลแปลในรูปแบบ Markdown | MD |
| bilingualMode | String | Horizontal | ทิศทางการจัดวางไฟล์สองภาษาHorizontal หมายถึงการแสดงแบบซ้ายขวา, Vertical หมายถึงการแสดงแบบบนล่าง | Horizontal |
| password | String | - | รหัสผ่านสำหรับเปิดไฟล์ PDF | - |
| ignoreComments | Boolean | false | ละเว้นความคิดเห็นใน DOCX และ PPTX, XLSX หรือไม่ | - |
| ignoreNotes | Boolean | false | ละเว้นหมายเหตุของ PPTX หรือไม่ | - |
| ignoreHeadersAndFooters | Boolean | false | ละเว้นส่วนท้ายและส่วนหัวของ DOCX หรือไม่ | - |
| ignoreHidden | Boolean | false | ละเว้นหน้าที่ซ่อนอยู่ของ PPTX หรือไม่ | - |
| ignoreMasters | Boolean | false | ละเว้นข้อความต้นแบบของ PPTX หรือไม่ | - |
| ignoreSheetNames | Boolean | false | ไม่แปลชื่อแผ่นงานของ XLSX หรือไม่ | - |
| extractTextRegExpPattern | String | - |
| - |
| extractTextRegExpFlags | String | - |
| - |
| allowFlip | Boolean | true | อนุญาตให้พลิกเค้าโครงหน้าเพจสำหรับภาษาที่เขียนจากขวาไปซ้ายหรือไม่ เมื่อกำหนดเป็น false จะปิดการพลิกรูปภาพด้วย | - |
| allowFlipImage | Boolean | true | อนุญาตให้พลิกเนื้อหารูปภาพสำหรับภาษาที่เขียนจากขวาไปซ้ายหรือไม่ | - |
| webhookUrl | String | - | URL สำหรับ callback เมื่อมีการอัปเดตสถานะ เนื้อหาของ callback ประกอบด้วย: {taskId, progress, status} | - |
การตอบสนอง
| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | คำอธิบาย | ตัวอย่าง |
|---|---|---|---|---|
| taskId | String | - | รหัสงาน | - |
ข้อผิดพลาดทั่วไป
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.