API แปลภาษาอัตโนมัติ

API การแปลอัตโนมัติเป็น API ที่ช่วยให้คุณตั้งค่าประเภทการแปลและนักแปลได้อย่างง่ายดาย รองรับทั้งการแปลแบบซิงโครนัสแบบเรียลไทม์และการแปลแบบอะซิงโครนัส โดยให้สภาพแวดล้อมการแปลที่ยืดหยุ่น

มี API การแปลอัตโนมัติสองประเภท:

API การแปลแบบซิงโครนัส ที่อนุญาตให้แปลแบบเรียลไทม์, API การร้องขอการแปลแบบอะซิงโครนัส ที่ไม่อนุญาตให้แปลแบบเรียลไทม์, และ API การยืนยันผลการแปลแบบอะซิงโครนัส.

หมายเหตุ¶

รูปแบบข้อความที่รองรับ¶

รูปแบบข้อความที่รองรับโดย API การแปลแบบซิงโครนัสและ API การแปลแบบอะซิงโครนัสมีดังนี้

• API แปลแบบซิงโครนัส: รองรับรูปแบบข้อความธรรมดาและ HTML
• API การแปลแบบอะซิงโครนัส: รองรับรูปแบบ Markdown

วิธีการจับคู่โครงการ¶

API การแปลอัตโนมัติให้วิธีการสองวิธีในการจับคู่บริการการแปลสำหรับแต่ละโครงการเกมที่ลงทะเบียนใน App Center.

• การจับคู่ 1:1 กับบริการแปลอัตโนมัติ: ลงทะเบียนบริการที่ใช้สำหรับแต่ละโครงการ
• เมื่อเรียกใช้บริการแปลอัตโนมัติหนึ่งรายการ ให้ป้อนรหัสโครงการเพื่อให้ตรงกัน: เรียกใช้ API โดยการเพิ่มรหัสโครงการแต่ละรายการ

ภาษาแปลที่รองรับ¶

แพลตฟอร์ม Hive รองรับการแปลทั้งหมด 16 ภาษา ดังนี้

ข้อกำหนดเบื้องต้น¶

ข้อกำหนดเบื้องต้นสำหรับการใช้ API การแปลอัตโนมัติมีดังนี้

1. ตรวจสอบคีย์บริการ (appKey), คีย์ลับ¶

1. ลงทะเบียนบริการใน Hive Console > AI Service > Automatic Translation > Automatic Translation System > Service Management.
2. ตรวจสอบคีย์บริการ (คีย์แอปเก่า) และคีย์ลับสำหรับผลิตภัณฑ์

2. ตรวจสอบลายเซ็น¶

สำนักงานด้านหลังของเซิร์ฟเวอร์ API สร้างลายเซ็นโดยใช้คีย์บริการและคีย์ลับ

ตรวจสอบลายเซ็นที่สร้างขึ้นโดยการเลือกการจัดการคีย์ใน Hive Console > AI Service > Automatic Translation > Automatic Translation System > Service Management ตัวอย่างของโค้ดลายเซ็นที่สร้างขึ้นมีดังนี้

※ ลายเซ็นคือค่าที่เข้ารหัส Base64 ด้วย HmacSHA256 โดยใช้คีย์แอปและคีย์การเข้ารหัส

import hmac
import hashlib
import base64

app_key = "your_app_key"
secret_key = "your_secret_key"

# ใช้ HMAC SHA-256
signature_bytes = hmac.new(secret_key.encode('utf-8'), app_key.encode('utf-8'), hashlib.sha256).digest()
signature = base64.b64encode(signature_bytes).decode('utf-8')

# เพิ่มลายเซ็นไปยังคำขอ HTTP
# ...

public static void main(String[] args) throws NoSuchAlgorithmException, InvalidKeyException {
String appKey = "your_app_key";
String secretKey = "your_secret_key";

// ใช้ HMAC SHA-256
Mac sha256_HMAC = Mac.getInstance("HmacSHA256");
SecretKeySpec secretKeySpec = new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
sha256_HMAC.init(secretKeySpec);

// สร้างลายเซ็น
byte[] signatureBytes = sha256_HMAC.doFinal(appKey.getBytes(StandardCharsets.UTF_8));
String signature = Base64.getEncoder().encodeToString(signatureBytes);

// เพิ่มลายเซ็นต์ไปยังคำขอ HTTP
// ...
}

API การแปลแบบซิงโครนัส¶

ประมวลผลคำขอการแปลและผลลัพธ์การแปลเป็นคำขอและการตอบสนอง API หนึ่งรายการในลักษณะซิงโครนัสแบบเรียลไทม์ เนื่องจากผลลัพธ์การแปลถูกจัดเตรียมโดยตรงในคำตอบ API จึงไม่มี API เพื่อตรวจสอบผลลัพธ์การแปล

เป็นประเภทข้อความการแปลแบบซิงโครนัส รองรับรูปแบบข้อความธรรมดาและข้อความ HTML ที่ไม่ต้องการการประมวลผลก่อนหรือหลัง

URL การร้องขอ¶

เส้นทางการร้องขอ¶

หัวข้อคำขอ¶

เนื้อหาคำขอ¶

การตอบกลับ¶

รหัสการตอบกลับ¶

ตัวอย่างคำขอ¶

    curl --request POST \
    --url https://ats.withhive.com/api/translate/sync \
    --header 'Content-Type: application/json' \
    --header 'Signature: IWusOMIBN8D/0HqgZ7/58e4rgS05E+nka3Ya9vc+yiY=' \
    --data '{
        "info":{
                "app_key":"802890479467404e"
        },
        "text": "การสร้างบัญชีผู้ใช้บัญชีเซิร์ฟเวอร์การจัดการเนื้อหาหลายภาษา",
        "to":"en,fr,de",
        "from": "ko"
        }'

    import requests

    url = "https://ats.withhive.com/api/translate/sync"

    payload = {
            "info": {"app_key": "802890479467404e"},
            "text": "การสร้างบัญชีแอปพลิเคชันบัญชีเซิร์ฟเวอร์การจัดการเนื้อหาหลายภาษา",
            "to": "en,fr,de",
            "from": "ko"
    }
    headers = {
            "Content-Type": "application/json",
            "Signature": "IWusOMIBN8D/0HqgZ7/58e4rgS05E+nka3Ya9vc+yiY="
    }

    response = requests.request("POST", url, json=payload, headers=headers)

    print(response.text)

    OkHttpClient client = new OkHttpClient();

    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{\n    \"info\":{\n        \"app_key\":\"802890479467404e\"\n    },\n    \"text\":\"การสอบถามเกี่ยวกับการสร้างบัญชีแอปพลิเคชันบัญชีเซิร์ฟเวอร์เกี่ยวกับการจัดการเนื้อหาหลายภาษา\",\n    \"to\":\"en,fr,de\",\n    \"from\" : \"ko\"\n}");
    Request request = new Request.Builder()
        .url("https://ats.withhive.com/api/translate/sync")
        .post(body)
        .addHeader("Content-Type", "application/json")
        .addHeader("Signature", "IWusOMIBN8D/0HqgZ7/58e4rgS05E+nka3Ya9vc+yiY=")
        .build();

    Response response = client.newCall(request).execute();

ตัวอย่างการตอบกลับ¶

    {
    "result" : {
    "code" : 200,
    "msg" : "Success"  
    },
    "content" : {
        "data" : {
            "translateMsg":[{
                "detectedLanguage":{
                    "language":"ko",
                    "score":-1.0
                },
                "translations":[{
                        "text":"Server Account Application Create an account Inquiries about the multilingual content management process",
                        "to":"en"
                    },
                    {
                        "text":"Demande de compte serveur Créer un compte Demandes de renseignements sur le processus de gestion de contenu multilingue",
                        "to":"fr"
                    },
                    {
                    "text":"Server-Konto-Anwendung Konto erstellen Anfragen zum mehrsprachigen Content-Management-Prozess",
                    "to":"de"
                }]
            }]
        }
    }
  }

API ขอแปลแบบอะซิงโครนัส¶

API การแปลแบบอะซิงโครนัสแบ่งออกเป็นสอง API คือ การขอการแปลและการตอบกลับการแปล ซึ่งจะถูกประมวลผลดังนี้ มี 'API ขอแปลแบบอะซิงโครนัส' ที่สอดคล้องกับคำขอและ 'API ยืนยันผลการแปลแบบอะซิงโครนัส' ที่สอดคล้องกับการตอบกลับ

เป็นประเภทข้อความการแปลแบบซิงโครนัส และรองรับรูปแบบข้อความ Markdown ที่ต้องการการประมวลผลก่อน/หลัง

URL ที่ร้องขอ¶

เส้นทางการร้องขอ¶

ส่วนหัวคำขอ¶

เนื้อหาคำขอ¶

การตอบกลับ¶

รหัสการตอบกลับ¶

ตัวอย่างคำขอ¶

    curl --request POST \
    --url https://ats.withhive.com/api/translate/async \
    --header 'Content-Type: application/json' \
    --header 'Signature: pczeZ91N/ijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c=' \
    --data '{
        "info":{
                "app_key":"815e3d8d6e7443ba"
        },
        "text":"# Markdown Cheat Sheet ......",
        "to":"ko,ja,zh-hant",
                "from":"en"
    }'

    import requests

    url = "https://ats.withhive.com/api/translate/async"

    payload = {
            "info": {"app_key": "815e3d8d6e7443ba"},
            "text": "# Markdown Cheat Sheet ......",
            "to": "ko,ja,zh-hant",
            "from": "en"
    }
    headers = {
            "Content-Type": "application/json",
            "Signature": "pczeZ91N/ijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c="
    }

    response = requests.request("POST", url, json=payload, headers=headers)

    print(response.text)

    OkHttpClient client = new OkHttpClient();

    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{\n    \"info\":{\n        \"app_key\":\"815e3d8d6e7443ba\"\n    },\n\t\"text\":\"# Markdown Cheat Sheet 
    ......\",\n    \"to\":\"ko,ja,zh-hant\",\n\t\t\"from\":\"en\"\n}\n");
    Request request = new Request.Builder()
        .url("https://ats.withhive.com/api/translate/async")
        .post(body)
        .addHeader("Content-Type", "application/json")
        .addHeader("Signature", "pczeZ91N/ijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c=")
        .build();

    Response response = client.newCall(request).execute();

ตัวอย่างการตอบกลับ¶

{
    "result": {
        "code": 200,
        "msg": "Success"
    },
    "content": {
        "uuid": "d2a36ba1-1bb3-43aa-ac57-46576d27eb37",
        "resultUrl": "https://test-ats.withhive.com/api/translate/async/result/d2a36ba1-1bb3-43aa-ac57-46576d27eb37"
    }
 }

API ตรวจสอบผลลัพธ์การแปลแบบอะซิงโครนัส¶

API ตรวจสอบผลลัพธ์การแปลแบบอะซิงโครนัสจะส่งคืนผลลัพธ์การแปลสำหรับคำขอการแปลแบบอะซิงโครนัส กล่าวอีกนัยหนึ่ง มันเป็น API ที่สอดคล้องกับการตอบสนองในหมู่ API แบบอะซิงโครนัสที่ประมวลผลคำขอและการตอบสนองแยกกัน

URL การร้องขอ¶

เส้นทางการร้องขอ¶

หัวข้อการร้องขอ¶

การตอบกลับ¶

รหัสการตอบกลับ¶

ตัวอย่างคำขอ¶

    curl --request GET 
    --url https://test-ats.withhive.com/api/translate/asyncresult/3f8891e9-513a-4e91-b0b6-ac9aabbbf6d2 
    --header 'Content-Type: application/json' 
    --header 'Signature: pczeZ91NijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c='

import requests

url = "https://ats.withhive.com/api/translate/async/result/3f8891e9-513a-4e91-b0b6-ac9aabbbf6d2"

headers = {
        "Content-Type": "application/json",
        "Signature": "pczeZ91N/ijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c="
}

response = requests.request("GET", url, headers=headers)

print(response.text)

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
    .url("https://ats.withhive.com/api/translate/async/result/3f8891e9-513a-4e91-b0b6-ac9aabbbf6d2")
    .get()
    .addHeader("Content-Type", "application/json")
    .addHeader("Signature", "pczeZ91N/ijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c=")
    .build();

Response response = client.newCall(request).execute();

ตัวอย่างการตอบกลับ¶

{
    "result": {
            "code": 200,
            "msg": "Success"
    },
    "content": {
            "status": {
                    "code": 100,
                    "msg": "completed"
            },
            "data": {
                    "translateMsg": [
                            {
                                    "translations": [
                                            {
                                                    "text": "# Markdown 치트 시트\r\n\r\n......",
                                                    "to": "ko"
                                            },
                                            {
                                                    "text": "# Markdownチートシート\r\n\r\n......",
                                                    "to": "ja"
                                            },
                                            {
                                                    "text": "# Markdown 備忘單\r\n\r\n......",
                                                    "to": "zh-hant"
                                            }
                                    ]
                            }
                    ]
            }
    }
}