语种识别服务通过检测Query 短语 31 种语言和通用场景 35 种语言的ISO代码，优化电商短文本场景，支持搜索路由、客服分流及翻译前置判断。-电商经营助手-阿里云帮助中心

文档简介

自动识别输入文本的语种，返回ISO语言代码。Aidge的语种识别针对电商短文本做了优化（标题/搜索词/客服对话），对于纯数字、缩写、品牌名混杂的电商文本鲁棒性较高。

覆盖 Query 短语31 种语言和通用场景35 种语言，支持同步调用。

典型场景：

搜索词路由：跨境电商的搜索框接收多语言查询，识别后路由到对应的搜索引擎。
客服会话分流：根据来访者语种自动分配对应语种客服或翻译机器人。
翻译前置判断：在调用文本翻译前先识别源语种。
多语言素材分类：把混合语言的商品评论/详情按语种分桶，便于后续做语义分析。

接口

POST /ai/text/language/detection

快速开始

import json

data = json.dumps({"SourceText": "Bonjour, comment ça va?"})
result = make_signed_request("/ai/text/language/detection", data)

lang = result["Data"]["DetectedLanguage"]
print(f"识别语种: {lang}")  # "fr"

完整的请求签名说明，以及 Java / Python / Go 等多语言 SDK 调用示例与在线调试，详见阿里云 OpenAPI 开发者门户：语种识别 API（OpenAPI 门户）。

请求参数

参数	类型	必填	说明
`SourceText`	String	是	待识别的原始文本。短文本（标题 / 搜索词）通常 5 字以上准确率较稳；过短或纯符号 / 数字时识别可能不可靠。
`Scene`	String	否	默认common，如您是搜索短语的场景请传query，传错或者不传则走common通用识别（注：query请传入小写）

响应字段

字段	类型	说明
`Code`	String	业务状态码。成功为 `Success`，其他为命名错误码。
`Success`	Boolean	本次调用是否成功。
`RequestId`	String	请求唯一标识。
`Message`	String	报错信息（仅失败时返回）。
`Data.DetectedLanguage`	String	识别出的语言代码，见下方支持语向表。
`Data.UsageMap.InputCharacterCount`	Number	本次输入字符数，用于计费核对。

完整示例

请求示例

{
  "SourceText": "测试文本"
  "Scene": "query"   
}

响应示例

{
  "Code": "success",
  "Message": "Success",
  "Success": true,
  "RequestId": "2157065A-D6C8-1F3E-A4D0-B1234567890",
  "Data": {
    "DetectedLanguage": "zh",
    "UsageMap": { "InputCharacterCount": 4 }
  }
}

支持的语种

支持Query 短语 31 个和通用场景 35 个语种。完整语种列表与语言代码见语向映射的「语种识别支持语向」。

使用建议

避免无效翻译：在调用文本翻译前先识别源语种；如果 DetectedLanguage 已经等于目标语言，直接跳过翻译。
短文本兜底：对于 ≤ 3 字符或全数字 / 全符号的文本，建议客户端做白名单跳过识别，直接落到默认语言。
中繁简区分：本接口能区分 zh 与 zh-tw。如果你的下游翻译模型不支持 zh-tw，需要客户端做映射。
混合语言文本：返回主语种（占比最高的语言）。如需逐句识别，请客户端先分句再分别调用。

错误码

错误码	触发场景
`InvalidParameter`	`SourceText` 为空或超过长度上限。
`InputContentBlocked`	输入文本触发内容安全审核。
`FreeQuotaExhausted`	试用额度已耗尽。
`InternalError`	服务端内部错误。请保留 `RequestId` 联系技术支持。

完整错误码列表参见错误码。

使用限制

调用模式：同步。QPS 上限和超时设置详见频率限制。
计费：按 InputCharacterCount 字符计费。详见翻译类计费。

后续步骤

文本翻译 -- 识别完源语种后的下一步。
文本纠错 -- 翻译前的拼写预处理。