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

接口信息

API Path
/aipaas/llm/v1/telechatZanghanfanyi/translation

请求协议
HTTPS

请求方法
POST

请求头部 ：

头部标签	必填	说明	类型	数据字典	限制	头部内容	示例
Content-Type	是	内容类型				application/json	application/json
X-APP-ID	是	控制台--应用管理--AppID
Device-Uuid	是	设备管理-设备uuid
Authorization	是	鉴权信息

请求参数 Json
Object

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

响应内容 ：

返回结果

成功 (200)
Json
Object

参数名	说明	必填	类型	数据字典	限制	示例
id	本轮对话id	是	[string]		0	7be10f14-9a4d-d7ee-5a54-de68cc7ef0c8
created	当前时间戳	是	[long]		0	1749468687
code	错误码	是	[string]		0	APP_ERR_OK
message	错误描述	是	[string]		0	请求正常
model	模型ID	是	[string]		0	classifications-v1
object	返回数据类型，固定object	是	[string]		0	object
data	翻译结果	是	[object]		0
data>>source_language	源语言代码	是	[string]		0	zh
data>>target_language	目标语言代码	是	[string]		0	ti
data>>used_context	是否使用了上下文进行翻译	是	[boolean]		0	false
data>>source_text	原始文本	是	[string]		0	今天天气很好，我们去公园散步吧。
data>>target_text	翻译后文本	是	[string]		0	དེ་རིང་གནམ་གཤིས་ཧ་ཅང་བཟང་། ང་ཚོ་ཚང་མ་ཁྲོམ་ར་ནང་དུ་གཉིད་སྒོམ་བྱེད་དགོས།
usage	token统计	否	[object]		0
usage>>completion_tokens	prompt的tokens	否	[int]		0
usage>>prompt_tokens	prompt的tokens	否	[int]		0
usage>>total_tokens	总tokens	否	[int]		0

接口参数错误 (422)
Json
Object

参数名	说明	必填	类型	数据字典	限制	示例
detail	错误详细说明	是	[array]		0
detail>>type	错误类型	是	[string]		0
detail>>loc	错误参数位置地址	是	[array]		0
detail>>msg	错误信息	是	[string]		0
detail>>input	原始输入	是	[object]		0
detail>>url	报错文档链接	是	[string]		0
detail>>ctx		否	[object]		0
detail>>ctx>>min_length	参数最小值	否	[int]		0

成功示例

{
    "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": "དེ་རིང་གནམ་གཤིས་ཧ་ཅང་བཟང་། ང་ཚོ་ཚང་མ་ཁྲོམ་ར་ནང་དུ་གཉིད་སྒོམ་བྱེད་དགོས།"
    }
}

1、能力简介

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

2、修订历史

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

3、服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。

4、请求参数说明

• 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字符，最大8192
• 12、source 最少1字符，最大128
• 13、target 最少1字符，最大128
• 14、context 最少1字符，最大128，最多允许传入6条

5、响应结果说明

• 无

6、请求示例

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

7、状态码说明

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

8、调用示例

8.1、java调用示例

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 = "算法调用地址";

            // 设置请求头
            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" +
"	\"translation_type\":\"LLM\",\n" +
"	\"source_language\":\"zh\",\n" +
"	\"target_language\":\"ti\",\n" +
"	\"context\":[],\n" +
"	\"model\":\"classifications-v1\",\n" +
"	\"text\":\"今天天气很好，我们去公园散步吧。\",\n" +
"	\"term_list\":[\n" +
"		{\n" +
"			\"source\":\"公园\",\n" +
"			\"target\":\"park\"\n" +
"		}\n" +
"	],\n" +
"	\"timestamp\":1749468686\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();
    }

}

8.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 = "算法调用地址"
# 请求数据
request_data = {
	"traceId":"7be10f14-9a4d-d7ee-5a54-de68cc7ef0c8",
	"translation_type":"LLM",
	"source_language":"zh",
	"target_language":"ti",
	"context":[],
	"model":"classifications-v1",
	"text":"今天天气很好，我们去公园散步吧。",
	"term_list":[
		{
			"source":"公园",
			"target":"park"
		}
	],
	"timestamp":1749468686
}
# 构建请求头
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}")