Hi Translate API Documentation

Fast, accurate translation services designed for global markets including Africa, South Asia, Southeast Asia, and Latin America.

Introduction

Designed specificially for Transsion markets (Africa, South Asia, SE Asia, Latin America, EE1, etc.), this text translation interface provides rapid and precise linguistic processing. Our goal is to empower users to cross language barriers and communicate effectively on a global scale.

Base URL

All endpoints below are relative to the following base URL.

Productionhttps://api.translasion.com

Authentication & Security

Access is restricted to authorized partners. After onboarding, you will receive an app_key (identifier) and a secret (used for verification).

Signature Generation Interface

1. Generate Noncenonce = 4-digit random string

2. Concatenate String (Order matters)str = sprintf("%s&%s&%s&%s&%s", app_key, to, timestamp, secret, nonce)

3. Calculate MD5 Hashsig = md5(str)

Request Headers

Header Key	Type	Required	Fixed Value / Note
Content-Type	string	Yes	application/json
X-Trace-Id	string	Yes	Unique UUID per request
X-Install-Id	string	No	Browser flag or unique installation ID

API 1: Multi-text Translation

Post multiple strings for batch processing.

POST/v2/translate

Parameter	Type	Required	Description
app_key	string	Yes	Platform-assigned app key
to	string	Yes	Target language code
texts	string[]	Yes	Array of strings to translate
from	string	No	Source language code (defaults to auto-detect)
timestamp	int	Yes	Current timestamp (secs). Valid for 5 mins.
nonce	string	Yes	4-digit random string
sig	string	Yes	Generated signature (MD5)
override_from_flag	string	No	1: force source lang, 0: detect
system_lang	string	No	System language code

Multi-text Request JSONjson

{
    "app_key": "10025",
    "to": "en",
    "texts": [
        "Hello",
        "Good morning",
        "Welcome"
    ],
    "from": "auto",
    "timestamp": 1712345678,
    "nonce": "acbf",
    "sig": "f4e5a6b7c8d9e0f1g2h3i4j5"
}

API 2: Single-text Translation

Post a single string for immediate translation.

POST/v2/translate(same endpoint as API 1)

Parameter	Type	Required	Description
app_key	string	Yes	Platform-assigned app key
to	string	Yes	Target language code
text	string	Yes	A single string to translate
from	string	No	Source language (auto-detect if empty)
timestamp	int	Yes	Unix timestamp (seconds)
nonce	string	Yes	4-digit random string
sig	string	Yes	MD5 validation signature
system_lang	string	No	System language code

Single-text Request JSONjson

{
    "app_key": "10025",
    "to": "en",
    "text": "你好啊",
    "from": "zh",
    "timestamp": 1712345678,
    "nonce": "acbf",
    "sig": "f4e5a6b7c8d9e0f1g2h3i4j5"
}

Response Structure

1000: SUCCESSERROR: SIGNATURE / EXPIRED / KEY

• "app key incorrect" - Invalid app_key identifier
• "token expired" - Timestamp exceeds 5 min window
• "sig incorrect" - Signature verification failed

API 1 Response Example (Multi-text: result.texts is an array)json

{
    "code": 1000,
    "message": "SUCCESS",
    "engine": "server",
    "result": {
        "source": "en",
        "texts": [
            "Translate content 1",
            "Translate content 2"
        ]
    },
    "track": "cd6e8bb1-5819-4c3b-8407-a2c20c096b45"
}

API 2 Response Example (Single-text: result.text is a string)json

{
    "code": 1000,
    "message": "SUCCESS",
    "engine": "server",
    "result": {
        "source": "zh",
        "text": "hello"
    },
    "track": "gen-dd0f7aef-a879-4595-afaf-328172169b35"
}

API 3: Language List API

Query the list of supported languages for different translation modules.

Request FormatGET /v1/language_list?type=1&to=zh

Query Param	Type	Required	Description / Support Types
type	int	Yes	1:Text, 2:STT, 3:TTS, 4:OCR, 5:TMS, 6:Human
to	string	Yes	Lang code for the "name" field localization

Language List Response Examplejson

{
    "code": 1000,
    "data": [
        {
            "code": "vi",
            "name": "tiếng việt"
        },
        {
            "code": "en",
            "name": "English"
        },
        {
            "code": "zh",
            "name": "简体中文"
        }
    ],
    "message": "success"
}