ແປເອກະສານເປັນພາສາອິນໂດເນເຊຍຜ່ານ API | ໄວ ແລະ ຖືກຕ້ອງ

ສິ່ງທ້າທາຍຂອງການແປເອກະສານແບບໂປຣແກຣມ

ການເຮັດໃຫ້ການແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາອິນໂດເນເຊຍເປັນແບບອັດຕະໂນມັດ ແມ່ນເປັນອຸປະສັກດ້ານເຕັກນິກທີ່ສໍາຄັນສໍາລັບນັກພັດທະນາ.
API ການແປຂໍ້ຄວາມແບບງ່າຍໆ ແມ່ນບໍ່ພຽງພໍສຳລັບການຈັດການກັບຮູບແບບໄຟລ໌ທີ່ສັບສົນ ເຊັ່ນ: PDF, DOCX, ຫຼື PPTX.
ໄຟລ໌ເຫຼົ່ານີ້ບັນຈຸມີໂຄງສ້າງທີ່ລະອຽດ, ລວມທັງຕາຕະລາງ, ຮູບພາບ, ຫົວຂໍ້, ແລະ ຮູບແບບສະເພາະທີ່ຕ້ອງໄດ້ຮັບການຮັກສາໄວ້ເພື່ອຮັກສາຄວາມສົມບູນ ແລະ ຄວາມສາມາດໃນການອ່ານຂອງເອກະສານ.

ການພຽງແຕ່ສະກັດເອົາຂໍ້ຄວາມເພື່ອນຳໄປແປ ແລ້ວພະຍາຍາມສ້າງເອກະສານຄືນໃໝ່ ມັກຈະນຳໄປສູ່ຜົນລັບທີ່ຮ້າຍແຮງ.
ທ່ານສ່ຽງຕໍ່ການແຕກຮູບແບບ, ການວາງເນື້ອຫາຜິດບ່ອນ, ແລະ ການສູນເສຍສະພາບແວດລ້ອມທາງສາຍຕາເດີມທັງໝົດ.
ນອກຈາກນັ້ນ, ຄວາມແຕກຕ່າງຂອງການເຂົ້າລະຫັດຕົວອັກສອນລະຫວ່າງພາສາອັງກິດ ແລະ ພາສາອິນໂດເນເຊຍ ຕ້ອງໄດ້ຮັບການຈັດການຢ່າງສົມບູນແບບເພື່ອປ້ອງກັນຂໍ້ຄວາມທີ່ຜິດພາດ, ໂດຍສະເພາະເມື່ອຈັດການກັບຕົວອັກສອນ ຫຼື ສັນຍາລັກທີ່ເປັນເອກະລັກ, ເຮັດໃຫ້ການສ້າງ API ເພື່ອແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາອິນໂດເນເຊຍເປັນເຄື່ອງມືທີ່ສັບສົນທີ່ຈະສ້າງຂຶ້ນເອງພາຍໃນ.

ການນໍາສະເໜີ Doctranslate REST API

The Doctranslate API ແມ່ນເປັນວິທີແກ້ໄຂທີ່ສ້າງຂຶ້ນໂດຍສະເພາະເພື່ອເອົາຊະນະສິ່ງທ້າທາຍເຫຼົ່ານີ້.
ມັນໃຫ້ບໍລິການ RESTful ທີ່ແຂງແຮງ, ສາມາດປັບຂະໜາດໄດ້, ແລະ ງ່າຍຕໍ່ການເຊື່ອມໂຍງສໍາລັບການແປເອກະສານທີ່ມີຄວາມຖືກຕ້ອງສູງ.
ແທນທີ່ຈະຈັດການກັບການສະກັດເອົາຂໍ້ຄວາມ ແລະ ການສ້າງໄຟລ໌ຄືນໃໝ່ດ້ວຍຕົນເອງ, ທ່ານສາມາດສົ່ງໄຟລ໌ທັງໝົດ ແລະ ໄດ້ຮັບເອກະສານທີ່ຖືກແປຢ່າງສົມບູນແບບ ແລະ ຖືກຈັດຮູບແບບຢ່າງສົມບູນແບບຄືນມາ.

API ຂອງພວກເຮົາສ້າງຂຶ້ນບົນພື້ນຖານທີ່ໃຫ້ຄວາມສຳຄັນກັບ ການຮັກສາຮູບແບບ, ຄວາມຖືກຕ້ອງສູງ, ແລະ ຄວາມໄວ.
ມັນວິເຄາະເອກະສານຕົ້ນສະບັບຂອງທ່ານຢ່າງສະຫຼາດ, ແປເນື້ອໃນຂໍ້ຄວາມໃນຂະນະທີ່ຄໍານຶງເຖິງອົງປະກອບຂອງໂຄງສ້າງ, ແລະ ຫຼັງຈາກນັ້ນກໍ່ເອົາໄຟລ໌ມາປະກອບຄືນໃໝ່ເປັນພາສາເປົ້າໝາຍ.
ສໍາລັບນັກພັດທະນາທີ່ຕ້ອງການປັບປຸງຂັ້ນຕອນການເຮັດວຽກທົ່ວໂລກຂອງເຂົາເຈົ້າ, ທ່ານສາມາດ ນໍາໃຊ້ແພລດຟອມການແປເອກະສານທີ່ມີປະສິດທິພາບຂອງພວກເຮົາ ເພື່ອຈັດການກັບໄຟລ໌ທີ່ສັບສົນໄດ້ຢ່າງງ່າຍດາຍ, ເນື່ອງຈາກການຕອບສະໜອງທັງໝົດແມ່ນຖືກສົ່ງໃນຮູບແບບ JSON ທີ່ສະອາດເພື່ອການເຊື່ອມໂຍງທີ່ງ່າຍດາຍ.

ຄູ່ມືການເຊື່ອມໂຍງ API ເປັນແຕ່ລະຂັ້ນຕອນ

ການເຊື່ອມໂຍງ API ການແປເອກະສານຂອງພວກເຮົາເຂົ້າໃນແອັບພລິເຄຊັນຂອງທ່ານແມ່ນເປັນຂະບວນການທີ່ກົງໄປກົງມາ.
ຄູ່ມືນີ້ຈະນຳພາທ່ານຜ່ານຂັ້ນຕອນທີ່ຈຳເປັນໂດຍໃຊ້ Python, ຕັ້ງແຕ່ການກວດສອບຕົວຕົນຈົນເຖິງການດາວໂຫຼດໄຟລ໌ທີ່ຖືກແປຂອງທ່ານ.
ຫຼັກການດຽວກັນນີ້ແມ່ນໃຊ້ໄດ້ກັບພາສາໂປຣແກຣມໃດກໍຕາມ, ເຊັ່ນ: Node.js, Java, ຫຼື C#, ທີ່ສາມາດສ້າງຄຳຮ້ອງຂໍ HTTP ໄດ້.

ສິ່ງທີ່ຈໍາເປັນກ່ອນ

ກ່ອນທີ່ທ່ານຈະເລີ່ມຕົ້ນ, ໃຫ້ແນ່ໃຈວ່າທ່ານມີອົງປະກອບຕໍ່ໄປນີ້ພ້ອມສໍາລັບການເຊື່ອມໂຍງ.
ທ່ານຈະຕ້ອງມີຄີ API Doctranslate ທີ່ຖືກຕ້ອງສຳລັບການກວດສອບຕົວຕົນ, ເຊິ່ງທ່ານສາມາດເອົາມາຈາກແຜງຄວບຄຸມຂອງນັກພັດທະນາຂອງທ່ານ.
ນອກຈາກນັ້ນ, ທ່ານຄວນຕິດຕັ້ງ Python ຢູ່ໃນລະບົບຂອງທ່ານ ພ້ອມກັບຫ້ອງສະໝຸດ requests ທີ່ນິຍົມ ເພື່ອຈັດການການສື່ສານ HTTP ກັບຈຸດສິ້ນສຸດ API ຂອງພວກເຮົາ.

ຂັ້ນຕອນທີ 1: ກວດສອບຕົວຕົນ ແລະ ອັບໂຫລດເອກະສານຂອງທ່ານ

ຂັ້ນຕອນທໍາອິດແມ່ນການສົ່ງເອກະສານຂອງທ່ານໄປຫາ API ເພື່ອແປ.
ສິ່ງນີ້ແມ່ນເຮັດຜ່ານຄໍາຮ້ອງຂໍ POST ໄປຫາຈຸດສິ້ນສຸດ /v2/document/translate.
ທ່ານຕ້ອງໃສ່ຄີ API ຂອງທ່ານໃນຫົວຂໍ້ Authorization ແລະ ສົ່ງຂໍ້ມູນໄຟລ໌ເປັນ multipart/form-data.

ນອກຈາກນີ້ທ່ານຈະກໍານົດພາສາຕົ້ນສະບັບ ແລະ ພາສາເປົ້າໝາຍໂດຍໃຊ້ລະຫັດພາສາຂອງມັນ.
ສໍາລັບຄູ່ມືນີ້, ທ່ານຈະໃຊ້ "source_lang": "en" ສໍາລັບພາສາອັງກິດ ແລະ "target_lang": "id" ສໍາລັບພາສາອິນໂດເນເຊຍ.
ຈາກນັ້ນ API ຈະນຳເອົາເອກະສານຂອງທ່ານເຂົ້າຄິວເພື່ອແປ ແລະ ສົ່ງຄືນ ID ເອກະສານທີ່ເປັນເອກະລັກເພື່ອຕິດຕາມຄວາມຄືບໜ້າຂອງມັນ.

ຂັ້ນຕອນທີ 2: ກວດເບິ່ງສະຖານະການແປ

ການແປເອກະສານແມ່ນເປັນຂະບວນການແບບ asynchronous, ເນື່ອງຈາກມັນສາມາດໃຊ້ເວລາໄດ້ຂຶ້ນຢູ່ກັບຂະໜາດ ແລະ ຄວາມສັບສົນຂອງໄຟລ໌.
ຫຼັງຈາກອັບໂຫລດ, ທ່ານຈໍາເປັນຕ້ອງໄດ້ກວດສອບສະຖານະການແປເປັນໄລຍະໂດຍໃຊ້ ID ເອກະສານທີ່ໄດ້ຮັບໃນຂັ້ນຕອນກ່ອນໜ້າ.
ທ່ານສາມາດເຮັດໄດ້ໂດຍການສ້າງຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດສິ້ນສຸດ /v2/document/status/{document_id}.

API ຈະຕອບສະໜອງດ້ວຍສະຖານະປັດຈຸບັນ, ເຊັ່ນ: ‘processing’, ‘done’, ຫຼື ‘error’.
ມັນຖືກແນະນໍາໃຫ້ຈັດຕັ້ງປະຕິບັດກົນໄກການສຳຫຼວດດ້ວຍການລໍຖ້າທີ່ເໝາະສົມ (ເຊັ່ນ: ທຸກໆ 5-10 ວິນາທີ) ເພື່ອຫຼີກເວັ້ນຄໍາຮ້ອງຂໍທີ່ຫຼາຍເກີນໄປ.
ເມື່ອສະຖານະກັບຄືນເປັນ ‘done’, ທ່ານສາມາດດຳເນີນການຕໍ່ໄປຫາຂັ້ນຕອນສຸດທ້າຍຂອງການດາວໂຫຼດໄຟລ໌ທີ່ຖືກແປ.

ຂັ້ນຕອນທີ 3: ດາວໂຫຼດເອກະສານທີ່ຖືກແປ

ເມື່ອການແປສຳເລັດຜົນ, ຂັ້ນຕອນສຸດທ້າຍແມ່ນການດຶງເອົາເອກະສານຂອງທ່ານ.
ທ່ານຈະສ້າງຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດສິ້ນສຸດ /v2/document/download/{document_id}.
API ຈະຕອບສະໜອງດ້ວຍຂໍ້ມູນ binary ຂອງເອກະສານທີ່ຖືກແປ, ເຊິ່ງທ່ານສາມາດບັນທຶກໂດຍກົງໃສ່ໄຟລ໌ໄດ້.

ມັນເປັນສິ່ງສໍາຄັນທີ່ຈະຈັດການການຕອບສະໜອງ binary ຢ່າງຖືກຕ້ອງໃນລະຫັດຂອງທ່ານ.
ໃຫ້ແນ່ໃຈວ່າທ່ານເປີດໄຟລ໌ຜົນອອກໃນໂໝດຂຽນ binary ('wb' ໃນ Python) ເພື່ອຮັກສາຄວາມສົມບູນຂອງໄຟລ໌.
ສິ່ງນີ້ຮັບປະກັນວ່າ DOCX, PDF, ຫຼື ຮູບແບບອື່ນໆທີ່ຖືກດາວໂຫຼດມາບໍ່ເສຍຫາຍ ແລະ ສາມາດເປີດໄດ້ໂດຍແອັບພລິເຄຊັນມາດຕະຖານ.

ຕົວຢ່າງ: ລະຫັດການເຊື່ອມໂຍງ Python

ນີ້ແມ່ນສະຄຣິບ Python ທີ່ສົມບູນທີ່ສະແດງໃຫ້ເຫັນເຖິງຂັ້ນຕອນການເຮັດວຽກທັງໝົດ.
ລະຫັດນີ້ຈັດການການອັບໂຫລດເອກະສານ, ການສຳຫຼວດຫາສະຖານະຂອງມັນ, ແລະ ການດາວໂຫຼດສະບັບແປສຸດທ້າຍ.
ຢ່າລືມປ່ຽນແທນ 'YOUR_API_KEY' ແລະ 'path/to/your/document.docx' ດ້ວຍຂໍ້ມູນປະຈຳຕົວຕົວຈິງຂອງທ່ານ ແລະ ເສັ້ນທາງໄຟລ໌.

import requests
import time
import os

# Configuration
API_KEY = 'YOUR_API_KEY' # Replace with your actual API key
BASE_URL = 'https://developer.doctranslate.io/api'
FILE_PATH = 'path/to/your/document.docx' # Replace with your file path
SOURCE_LANG = 'en'
TARGET_LANG = 'id'

# Step 1: Upload the document for translation
def upload_document():
    print(f"Uploading {os.path.basename(FILE_PATH)} for translation...")
    url = f"{BASE_URL}/v2/document/translate"
    headers = {
        'Authorization': f'Bearer {API_KEY}'
    }
    files = {'file': open(FILE_PATH, 'rb')}
    data = {
        'source_lang': SOURCE_LANG,
        'target_lang': TARGET_LANG
    }

    try:
        response = requests.post(url, headers=headers, files=files, data=data)
        response.raise_for_status() # Raise an exception for bad status codes
        result = response.json()
        print("Upload successful.")
        return result.get('document_id')
    except requests.exceptions.RequestException as e:
        print(f"Error during upload: {e}")
        return None

# Step 2: Check the translation status
def check_status(document_id):
    url = f"{BASE_URL}/v2/document/status/{document_id}"
    headers = {'Authorization': f'Bearer {API_KEY}'}
    
    while True:
        try:
            response = requests.get(url, headers=headers)
            response.raise_for_status()
            status_data = response.json()
            status = status_data.get('status')
            print(f"Current translation status: {status}")

            if status == 'done':
                return True
            elif status == 'error':
                print(f"Translation failed with error: {status_data.get('message')}")
                return False

            # Wait for 10 seconds before checking again
            time.sleep(10)
        except requests.exceptions.RequestException as e:
            print(f"Error checking status: {e}")
            return False

# Step 3: Download the translated document
def download_document(document_id):
    url = f"{BASE_URL}/v2/document/download/{document_id}"
    headers = {'Authorization': f'Bearer {API_KEY}'}
    output_filename = f"translated_{os.path.basename(FILE_PATH)}"

    print(f"Downloading translated file to {output_filename}...")
    try:
        response = requests.get(url, headers=headers, stream=True)
        response.raise_for_status()

        with open(output_filename, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        
        print("Download complete.")
    except requests.exceptions.RequestException as e:
        print(f"Error during download: {e}")

# Main execution flow
if __name__ == "__main__":
    doc_id = upload_document()
    if doc_id:
        if check_status(doc_id):
            download_document(doc_id)

ຂໍ້ພິຈາລະນາທີ່ສໍາຄັນສໍາລັບລັກສະນະສະເພາະຂອງພາສາອິນໂດເນເຊຍ
ການແປເນື້ອໃນເປັນພາສາອິນໂດເນເຊຍ (Bahasa Indonesia) ແມ່ນກ່ຽວຂ້ອງກັບຫຼາຍກວ່າການປ່ຽນຄຳຕໍ່ຄຳແບບຊື່ໆ.
 ພາສານີ້ມີໂຄງສ້າງໄວຍາກອນທີ່ເປັນເອກະລັກ, ລະດັບຄວາມເປັນທາງການ, ແລະ ຄວາມແຕກຕ່າງທາງດ້ານວັດທະນະທໍາທີ່ເຄື່ອງມືການແປທີ່ມີຄຸນນະພາບສູງຕ້ອງຈັດການ.
 API ຂອງພວກເຮົາໄດ້ຮັບການຝຶກຝົນກ່ຽວກັບຊຸດຂໍ້ມູນຂະໜາດໃຫຍ່ເພື່ອເຂົ້າໃຈ ແລະ ນຳໃຊ້ຄວາມສັບສົນເຫຼົ່ານີ້ຢ່າງຖືກຕ້ອງເພື່ອໃຫ້ໄດ້ຜົນລັບທີ່ດີກວ່າ.
ຄວາມເປັນທາງການ ແລະ ສຳນຽງ
ພາສາອິນໂດເນເຊຍມີລະດັບການໃຊ້ທີ່ເປັນທາງການ ແລະ ບໍ່ເປັນທາງການທີ່ແຕກຕ່າງກັນ ເຊິ່ງເປັນສິ່ງສໍາຄັນສໍາລັບເອກະສານທຸລະກິດ ແລະ ເຕັກນິກ.
 ການໃຊ້ລະດັບຄວາມເປັນທາງການທີ່ຜິດພາດສາມາດເຮັດໃຫ້ເບິ່ງຄືວ່າບໍ່ເປັນມືອາຊີບ ຫຼື ສັບສົນຕໍ່ຜູ້ຊົມເປົ້າໝາຍ.
 ຮູບແບບການແປພາສາເຄື່ອງປະສາດຂັ້ນສູງຂອງ Doctranslate API ແມ່ນຮັບຮູ້ສະພາບແວດລ້ອມ, ຮັບປະກັນວ່າສໍາ​ນຽງທີ່ເໝາະສົມຖືກນໍາໃຊ້, ບໍ່ວ່າເອກະສານຕົ້ນສະບັບຈະເປັນສັນຍາທາງດ້ານກົດໝາຍ, ຄູ່ມືຜູ້ໃຊ້, ຫຼື ແຜ່ນພັບການຕະຫຼາດ.
ຄຳປະສົມ ແລະ ຄຳປະກອບ
ໄວຍາກອນພາສາອິນໂດເນເຊຍໃຊ້ຄໍາປະກອບ (prefixes (awalan)), ຄໍາຕໍ່ທ້າຍ (suffixes (akhiran)), ແລະ ຄໍາແຊກກາງ (infixes (sisipan)) ຢ່າງກວ້າງຂວາງ ເພື່ອປ່ຽນແປງຄວາມໝາຍຂອງຄຳຮາກສັບ.
 ການແປພາສາແບບງ່າຍໆໂດຍອີງໃສ່ຄໍາສັບສາມາດລົ້ມເຫຼວໃນການເກັບກໍາຄວາມໝາຍທີ່ຖືກຕ້ອງຂອງຄໍາປະສົມທີ່ສັບສົນເຫຼົ່ານີ້ໄດ້ຢ່າງງ່າຍດາຍ.
 ເຄື່ອງມືການແປຂອງພວກເຮົາຖືກອອກແບບມາສະເພາະເພື່ອວິເຄາະໂຄງສ້າງທາງດ້ານສັນຖານເຫຼົ່ານີ້, ຮັບປະກັນວ່າຄໍາສັບຕ່າງໆເຊັ່ນ ‘memperbaharui’ (ເພື່ອຕໍ່ອາຍຸ/ອັບເດດ) ຖືກແປດ້ວຍຄວາມໝາຍໃນການເຮັດວຽກທີ່ຕັ້ງໃຈໄວ້, ບໍ່ແມ່ນພຽງແຕ່ເປັນການລວບລວມຂອງສ່ວນຕ່າງໆເທົ່ານັ້ນ.
ຄຳສັບດ້ານວິຊາການ ແລະ ຄຳຢືມ
ເຊັ່ນດຽວກັນກັບຫຼາຍໆພາສາ, ພາສາອິນໂດເນເຊຍໄດ້ນໍາໃຊ້ຄໍາຢືມຈໍານວນຫຼວງຫຼາຍຈາກພາສາອັງກິດ ແລະ ພາສາອື່ນໆ, ໂດຍສະເພາະໃນຂົງເຂດດ້ານວິຊາການ ແລະ ວິທະຍາສາດ.
 ລະບົບການແປທີ່ມີຄວາມສາມາດຕ້ອງຮັບຮູ້ວ່າເວລາໃດຄວນແປຄໍາສັບ ແລະ ເວລາໃດຄວນຮັກສາສະບັບເປັນພາສາອັງກິດທີ່ເຂົ້າໃຈໂດຍທົ່ວໄປໂດຍຜູ້ຊ່ຽວຊານໃນປະເທດອິນໂດເນເຊຍ.
 API ຂອງພວກເຮົາໃຊ້ຮູບແບບສະເພາະຂົງເຂດເພື່ອຕັດສິນໃຈຢ່າງສະຫຼາດເຫຼົ່ານີ້, ສົ່ງຜົນໃຫ້ການແປທີ່ທັງຖືກຕ້ອງ ແລະ ມີສຽງທີ່ເປັນທໍາມະຊາດສໍາລັບຜູ້ເວົ້າພື້ນເມືອງໃນຂົງເຂດດັ່ງກ່າວ.
ບົດສະຫຼຸບ ແລະ ຂັ້ນຕອນຕໍ່ໄປ
ການເຮັດໃຫ້ຂັ້ນຕອນການແປເອກະສານພາສາອັງກິດເປັນພາສາອິນໂດເນເຊຍຂອງທ່ານເປັນແບບອັດຕະໂນມັດດ້ວຍ Doctranslate API ໃຫ້ຂໍ້ໄດ້ປຽບດ້ານການແຂ່ງຂັນທີ່ສໍາຄັນ.
 ທ່ານສາມາດປະຢັດຊົ່ວໂມງຂອງການເຮັດວຽກດ້ວຍຕົນເອງ, ຮັບປະກັນຄວາມສອດຄ່ອງຂອງຮູບແບບ, ແລະ ສົ່ງການແປທີ່ມີຄວາມຖືກຕ້ອງສູງໃນຂະໜາດໃຫຍ່.
 ໂດຍການໂອນຄວາມສັບສົນຂອງການວິເຄາະໄຟລ໌ ແລະ ຄວາມແຕກຕ່າງທາງດ້ານພາສາໄປໃຫ້ບໍລິການສະເພາະຂອງພວກເຮົາ, ທີມງານພັດທະນາຂອງທ່ານສາມາດສຸມໃສ່ລັກສະນະຫຼັກຂອງແອັບພລິເຄຊັນໄດ້.
ເພື່ອເລີ່ມຕົ້ນ, ພວກເຮົາຊຸກຍູ້ໃຫ້ທ່ານສໍາຫຼວດເອກະສານ API ຢ່າງເປັນທາງການສໍາລັບຂໍ້ມູນລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບຕົວກໍານົດທີ່ມີຢູ່ ແລະ ຄຸນສົມບັດຂັ້ນສູງ.
 ການເຊື່ອມໂຍງເຄື່ອງມືທີ່ມີປະສິດທິພາບນີ້ຈະເພີ່ມຄວາມສາມາດຂອງທ່ານໃນການເຂົ້າເຖິງຜູ້ຊົມທີ່ເວົ້າພາສາອິນໂດເນເຊຍດ້ວຍເອກະສານທີ່ຊັດເຈນ ແລະ ເປັນມືອາຊີບ.
 ລົງທະບຽນສໍາລັບຄີ API ມື້ນີ້ເພື່ອເລີ່ມຕົ້ນການສ້າງແອັບພລິເຄຊັນທີ່ມີປະສິດທິພາບຫຼາຍຂຶ້ນ, ເປັນສາກົນດ້ວຍຄວາມສາມາດໃນການແປທີ່ບໍ່ມີຮອຍຕໍ່.