藏汉翻译大模型 (算法编码：8005300019)

协议类型：HTTPS（POST）

---

一、接入点

环境	地址
公网	https://api-maas.teleai.com.cn/aipaas/llm/v1/telechatZanghanfanyi/translation

• API Path：/aipaas/llm/v1/telechatZanghanfanyi/translation
• 请求方法：POST
• Content-Type：application/json

---

二、鉴权

采用请求头携带鉴权信息：

Authorization: <鉴权信息>

• 鉴权规则请参见：开发指南 - 签名认证方式。
• 鉴权在线生成工具：API在线签名计算工具。

请求头	必填	说明
Content-Type	是	内容类型，固定application/json
X-APP-ID	是	控制台 → 应用管理 → AppID
Device-Uuid	是	设备uuid
Authorization	是	鉴权信息

---

三、能力简介

主要用于藏汉文本翻译任务，输入汉语或藏语，对应翻译输出藏语或汉语。

3.1 修订历史

修订日期	算法版本号	修订内容
2026-01-08	V1.1.2	更新挂载包
2026-01-08	V1.1.1	更新挂载包
2026-01-07	V1.1.0	相比上一版本，本次发版加入宗教数据进行微调，构建宗教领域的翻译能力
2026-01-01	V1.0.0	首版本发布

---

四、请求与响应

4.1 请求参数

字段	类型	必填	说明
traceId	string	否	接口跟踪 ID，每次调用需不同，可使用 UUID，用于日志排除、链路跟踪，最大长度为 64
timestamp	long	否	当前时间戳
model	string	是	模型 ID（需要全局唯一），示例：classifications-v1
source_language	string	是	源语言代码，示例：zh
target_language	string	是	目标语言代码，示例：ti
translation_type	string	是	翻译类型：MT 或 LLM
text	string	是	待翻译文本，示例：今天天气很好，我们去公园散步吧。
term_list	array	否	术语列表【传入模型参考，不同场景不一定使用】
context	array	否	历史上下文对话，用于支持多轮翻译【目前不生效】，示例：["昨天我们去了超市。", "今天我们计划去哪里？"]

4.1.1 术语列表 term_list[]

字段	类型	必填	说明
source	string	是	源术语，示例：公园
target	string	是	目标术语，示例：park

4.1.2 请求参数说明

• 1、当前模型未具备定向翻译的能力，但使用时 source_language 和 target_language 请严格使用，后续会更新相关能力
• 2、大模型翻译时 translation_type 仅支持 LLM 输入
• 3、当前模型不支持 term_list 定向翻译
• 4、当前模型不支持 context 多轮翻译
• 5、traceId 最少 1 字符，最大 64
• 6、timestamp 限制 int
• 7、model 最少 1 字符，最大 64
• 8、source_language 最少 1 字符，最大 64
• 9、target_language 最少 1 字符，最大 64
• 10、translation_type 可选项 MT、LLM
• 11、text 最少 1 字符，最大 1024
• 12、source 最少 1 字符，最大 128
• 13、target 最少 1 字符，最大 128
• 14、context 最少 1 字符，最大 128，最多允许传入 6 条

4.2 响应体

4.2.1 顶层字段

字段	类型	说明
id	string	本轮对话 id
created	long	当前时间戳
code	string	错误码
message	string	错误描述
model	string	模型 ID
object	string	返回数据类型，固定object
data	object	翻译结果

4.2.2 翻译结果 data

字段	类型	说明
source_language	string	源语言代码
target_language	string	目标语言代码
used_context	boolean	是否使用了上下文进行翻译
source_text	string	原始文本
target_text	string	翻译后文本

4.3 请求与响应示例

请求示例：

{
    "traceId": "7be10f14-9a4d-d7ee-5a54-de68cc7ef0c8",
    "timestamp": 1749468686,
    "model": "llm-ti-zh",
    "source_language": "zh",
    "target_language": "ti",
    "translation_type": "LLM",
    "text": "今天天气很好，我们去公园散步吧。"
}

成功响应示例：

{
    "id": "7be10f14-9a4d-d7ee-5a54-de68cc7ef0c8",
    "created": 1749468687,
    "code": "APP_ERR_OK",
    "message": "请求正常",
    "model": "llm-ti-zh",
    "object": "object",
    "data": {
        "source_language": "zh",
        "target_language": "ti",
        "used_context": false,
        "source_text": "今天天气很好，我们去公园散步吧。",
        "target_text": "དེ་རིང་གནམ་གཤིས་ཧ་ཅང་བཟང་། ང་ཚོ་ཚང་མ་ཁྲོམ་ར་ནང་དུ་གཉིད་སྒོམ་བྱེད་དགོས།"
    }
}

---

五、状态码说明

5.1 算法状态码

状态码	状态描述	状态说明
APP_ERR_OK	请求成功	请求正常
APP_ERROR	请求失败	算法调用失败
APP_ERR_INVALID_PARAM	参数异常	请求参数不合法

5.2 公共状态码

• 接口响应的公共状态码由网关统一定义，一般用于标识鉴权失败、限流或服务异常，具体业务错误码、错误信息及排查建议请参考：开发指南-公共信息及状态码。

---

六、调用示例

Python

import json
import hashlib
import hmac
import time
import re
import urllib.parse
import requests
import warnings
from datetime import datetime
import logging

# 配置日志，设置日志级别为INFO，并指定日志格式
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')

# 配置环境变量
X_APP_ID = "yourAppId"
AUTHORIZATION = "yourAuthorization"
# 请求的URL
url = "https://api-maas.teleai.com.cn/aipaas/llm/v1/telechatZanghanfanyi/translation"
# 请求数据
request_data = {
    "traceId": "7be10f14-9a4d-d7ee-5a54-de68cc7ef0c8",
    "timestamp": 1749468686,
    "model": "llm-ti-zh",
    "source_language": "zh",
    "target_language": "ti",
    "translation_type": "LLM",
    "text": "今天天气很好，我们去公园散步吧。"
}
# 构建请求头
headers = {
    "Content-Type": "application/json",
    "Device-Uuid": "2018619061498245122",
    "X-APP-ID": X_APP_ID,
    "Authorization": AUTHORIZATION
}

def timeSimple(timestamp):
    # 将时间戳转换为HH:MM:SS格式的时间字符串
    dt_object = datetime.fromtimestamp(timestamp)
    formatted_time = dt_object.strftime("%H:%M:%S")
    return formatted_time

def send_request(url):
    try:
        start_time = time.time()
        logging.info(f"请求路径: {url}")
        logging.info(f"开始发送: {timeSimple(start_time)}")

        with requests.post(
            url, json=request_data, headers=headers, stream=True, verify=False
        ) as response:
            first_packet_time = None
            if response.status_code == 200:
                logging.info(f"接受到返回: {timeSimple(time.time())}")

                for chunk in response.iter_content(chunk_size=1024):
                    if chunk:
                        if first_packet_time is None:
                            first_packet_time = time.time()
                        logging.info(
                            f"Received chunk: {timeSimple(time.time())} {chunk.decode('utf-8')}"
                        )

                end_time = time.time()
                logging.info(f"Time to first byte (TTFB): {first_packet_time - start_time:.3f} seconds")
                logging.info(f"Request completed in {end_time - start_time:.3f} seconds")
            else:
                logging.error(f"Request failed with status code {response.status_code}")
    except Exception as e:
        logging.error(f"An error occurred: {e}")

# 发送请求
send_request(url)
logging.info(f"headers = {headers}")

Java（使用 Hutool + FastJSON）

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import com.alibaba.fastjson.JSONObject;

import java.util.HashMap;
import java.util.Map;

/**
 * 为保证示例可以正常运行，请确认maven中是否存在以下依赖：
 * <dependency>
 *     <groupId>cn.hutool</groupId>
 *     <artifactId>hutool-all</artifactId>
 *     <version>5.8.29</version>
 * </dependency>
 * <dependency>
 *     <groupId>com.alibaba</groupId>
 *     <artifactId>fastjson</artifactId>
 *     <version>1.2.83</version>
 * </dependency>
 */
public class Example {

    public static void example() {
        try {
            // 算法调用地址，请根据实际情况修改
            String url = "https://api-maas.teleai.com.cn/aipaas/llm/v1/telechatZanghanfanyi/translation";

            // 设置请求头
            Map<String, String> headers = new HashMap<>();
            headers.put("Content-Type", "application/json");
            headers.put("Device-Uuid", "2018619061498245122");
            headers.put("X-APP-ID", "你实际的AppId");
            headers.put("Authorization", "你实际的Authorization");

            // 设置请求参数，请根据实际情况修改
            String requestString = "{\n" +
                    "    \"traceId\": \"7be10f14-9a4d-d7ee-5a54-de68cc7ef0c8\",\n" +
                    "    \"timestamp\": 1749468686,\n" +
                    "    \"model\": \"llm-ti-zh\",\n" +
                    "    \"source_language\": \"zh\",\n" +
                    "    \"target_language\": \"ti\",\n" +
                    "    \"translation_type\": \"LLM\",\n" +
                    "    \"text\": \"今天天气很好，我们去公园散步吧。\"\n" +
                    "}";

            // 发起HTTP请求
            HttpResponse response = HttpRequest.post(url)
                    .headerMap(headers, true)
                    .body(requestString)
                    .execute();
            // 输出响应结果
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        example();
    }
}