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

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

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

หมายเหตุ¶

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

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

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

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

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

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

ภาษาในการสนับสนุนการแปล¶

ภาษาที่รองรับการแปลโดย Hive มีทั้งหมด 16 ภาษา ดังที่ระบุไว้ด้านล่าง

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

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

1. ตรวจสอบคีย์บริการและคีย์ลับ¶

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

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

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

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

• ลายเซ็นคือค่าที่เข้ารหัส Base64 ด้วย HmacSHA256 โดยใช้กุญแจบริการและกุญแจลับ

import hmac
import hashlib
import base64

service_key = "your_service_key"
secret_key = "your_secret_key"

# การใช้ hmac sha-256
signature_bytes = hmac.new(secret_key.encode('utf-8'), service_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 serviceKey = "your_service_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(serviceKey.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":{
                "service_key":"802890479467404e"
        },
        "text":"คำขอสำหรับขั้นตอนการสร้างแอปพลิเคชันบัญชีเซิร์ฟเวอร์และการจัดการเนื้อหาหลายภาษา",
        "to":"en,fr,de",
        "from" : "ko"
        }'

    import requests

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

    payload = {
            "info": {"service_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        \"service_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 คำขอการแปลแบบอะซิงโครนัส' สำหรับคำขอและ 'API ตรวจสอบผลการแปลแบบอะซิงโครนัส' สำหรับการตอบกลับ.

นี่คือข้อความการแปลประเภทสำหรับเนื้อหา ซึ่งรองรับรูปแบบข้อความมาร์กดาวน์ที่ต้องการการประมวลผลก่อน/หลัง

URL การร้องขอ¶

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

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

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

การตอบกลับ¶

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

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

    curl --request POST \
    --url https://ats.withhive.com/api/translate/async \
    --header 'Content-Type: application/json' \
    --header 'Signature: pczeZ91N/ijDBZ80ktNdTDPhnmEK98a3AIsTui46o9c=' \
    --data '{
        "info":{
                "service_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": {"service_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        \"service_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"
                                            }
                                    ]
                            }
                    ]
            }
    }
}