参数名	类型	必填	说明	示例
type	string	是	翻译来源，目前仅支持有道（youdao）及翻译君（qqfy）	youdao
from	string	是	需要翻译的语言类型，其中type为youdao时仅可为中文、英文、日语、韩语、西班牙语、俄语、法语、德语、葡萄牙语】，为qqfy时仅可为【中文、英文、日语、韩语、西班牙语、俄语、法语、德语、泰语、越南语、印尼语、马来语、葡萄牙语、土耳其语】	英文
to	string	是	翻译为的内容，其中type为youdao时仅可为【中文、英文、日语、韩语、西班牙语、俄语、法语、德语、葡萄牙语】，为qqfy时仅可为【中文、英文、日语、韩语、西班牙语、俄语、法语、德语、泰语、越南语、印尼语、马来语、葡萄牙语、土耳其语】	中文
msg	string	是	需要翻译的内容，如存在特使符号时，需要进行url编码处理	hello

翻译

接口说明

翻译接口提供多语种文本互译能力，支持有道与翻译君两个翻译来源，覆盖中、英、日、韩、西、俄、法、德、葡等主流语言。适用于需要将文本在多种语言之间转换的开发者与业务场景，调用免费，无需密钥。

调用地址

https://xiaoapi.cn/v1/zs_fanyi.php

该接口为翻译服务，支持多语种互译。翻译来源包含有道翻译与翻译君两种：有道支持中文、英文、日语、韩语、西班牙语、俄语、法语、德语、葡萄牙语互译；翻译君支持中文、英文、日语、韩语、西班牙语、俄语、法语、德语、泰语、越南语、印尼语、马来语、葡萄牙语、土耳其语等主流语言互译。

请求方式

本接口支持 GET 与 POST 两种请求方式，请求参数可使用查询字符串或表单形式提交。当翻译内容中包含特殊符号时，需要先对其进行 URL 编码处理。

鉴权说明

本接口无需密钥，可直接调用，且不收取费用。

请求参数

参数名	类型	必填	说明
type	string	是	翻译来源，目前仅支持有道（`youdao`）及翻译君（`qqfy`）
from	string	是	源语言类型，即待翻译内容所使用的语言
to	string	是	目标语言类型，即翻译结果所使用的语言
msg	string	是	需要翻译的内容；若包含特殊符号，需先进行 URL 编码处理

参数取值说明

type

youdao：有道翻译
qqfy：翻译君

from / to

两种翻译来源支持的语言范围不同，from 与 to 需与 type 对应：

type 为 youdao 时，可选：中文、英文、日语、韩语、西班牙语、俄语、法语、德语、葡萄牙语
type 为 qqfy 时，可选：中文、英文、日语、韩语、西班牙语、俄语、法语、德语、泰语、越南语、印尼语、马来语、葡萄牙语、土耳其语

取值直接使用语言中文名称，例如 英文、中文。源语言与目标语言不可为同一种语言。

msg

传入待翻译文本。文本中含空格、&、+、=、?、# 等特殊符号时，请先做 URL 编码，避免参数被截断或解析错误。

成功响应示例

{
  "code": 200,
  "type": "有道翻译",
  "types": "英文",
  "text": "你好",
  "msg": "Hello",
  "tips": "慕名API：https://xiaoapi.cn/"
}

响应字段说明

字段	类型	说明
code	integer	业务状态码，200 表示本次翻译请求处理成功
type	string	实际使用的翻译来源名称，与请求参数 type 对应
types	string	本次翻译的源语言名称，与请求参数 from 对应
text	string	翻译结果，即目标语言内容
msg	string	原始待翻译内容，与请求参数 msg 一致
tips	string	平台提示信息

说明：以上字段在翻译成功时返回；text 为本次请求的最终译文，直接取用即可。

错误响应示例

当请求未能正常完成时，接口统一返回 JSON 格式的错误信息，code 为 0，并在 errcode 字段中给出具体的业务错误码，msg 为对应的文字说明。

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

{
  "code": 0,
  "msg": "请求过于频繁（QPM 限制）",
  "errcode": 11005
}

{
  "code": 0,
  "msg": "接口不存在",
  "errcode": 11013
}

{
  "code": 0,
  "msg": "服务暂不可用",
  "errcode": 11017
}

本接口为免费接口，正常调用时返回业务数据；若出现错误，请以响应中的 errcode 为准进行排查。

业务错误码说明

errcode	含义	常见触发场景
11001	未提供调用密钥	需要密钥的接口未携带密钥
11002	密钥错误	密钥填写有误或与本站不匹配
11003	密钥已禁用	密钥被停用
11004	积分余额不足	账户剩余积分不足以支付本次调用
11005	请求过于频繁（QPM 限制）	单位时间内请求次数超出限制
11006	接口维护中	接口处于计划内维护状态
11007	接口已禁用	接口已被关闭
11008	接口不可用	接口当前无法正常提供服务
11009	密钥校验暂不可用	校验环节临时异常
11010	积分系统暂不可用	计费环节临时异常
11011	收费接口须提供有效密钥	付费类接口未携带或携带无效密钥
11012	鉴权方式错误	密钥传递方式不符合要求
11013	接口不存在	请求路径有误或接口已下线
11014	目标地址无效	转发目标地址格式或内容无效
11015	目标地址不允许	目标地址不在允许范围内
11016	目标请求失败	目标地址返回异常或连接失败
11017	服务暂不可用	服务整体临时不可用
11018	请求方式不允许	使用了不支持的请求方法
11019	当前IP不在白名单内	调用方 IP 未被列入允许名单
11020	启用出口通道须提供有效密钥	开启出口通道能力时未携带有效密钥
11021	未配置可用出口通道	尚无可用出口通道配置
11022	出口通道不可用	出口通道连接异常或不可达
11023	密钥已过期	密钥超出有效期
11024	令牌分配积分不足	令牌可用积分不足以完成本次调用

处理建议：11001～11004、11011～11012、11019、11020、11023～11024 多与密钥及额度相关，请核对密钥、鉴权方式与账户额度；11005 请降低调用频率后重试；11006～11010、11017、11021～11022 属于服务侧临时状态，稍后重试即可；11013～11016、11018 请检查请求地址、请求方式与参数是否合法。

调用示例

请求地址为 https://xiaoapi.cn/v1/zs_fanyi.php，无需密钥，可直接发起调用。

终端 curl（bash）

curl "https://xiaoapi.cn/v1/zs_fanyi.php?type=youdao&from=英文&to=中文&msg=hello"

当翻译内容包含特殊符号时，请先对 msg 做 URL 编码，例如：

curl -G "https://xiaoapi.cn/v1/zs_fanyi.php" \
  --data-urlencode "type=qqfy" \
  --data-urlencode "from=中文" \
  --data-urlencode "to=英文" \
  --data-urlencode "msg=你好，世界！"

PHP

// PHP 示例
$params = [
    'type' => 'youdao',
    'from' => '英文',
    'to'   => '中文',
    'msg'  => 'hello',
];

$url = 'https://xiaoapi.cn/v1/zs_fanyi.php?' . http_build_query($params);

$response = file_get_contents($url);
echo $response;

返回结果示例：

{
  "code": 200,
  "type": "有道翻译",
  "types": "英文",
  "text": "你好",
  "msg": "Hello",
  "tips": "慕名API：http://xiaoapi.cn"
}

注意事项

接口无需密钥即可调用，但仍建议避免在公开页面直接暴露完整的服务地址与调用逻辑，防止被恶意刷量。
请求中的 msg 若含空格、&、+、#、中文等特殊字符，需先做 URL 编码后再提交，否则可能出现内容截断或翻译结果与原文不符。
type、from、to、msg 四项均为必填，缺任意一项都可能返回错误；type 仅支持 youdao 与 qqfy 两种取值。
from 与 to 必须在所选 type 支持的语言集合内，且二者不能超出该集合范围；跨集合取值不会自动降级，请先按要求核对语言名称的写法。
例如选择 youdao 时，泰语、越南语等不在支持范围内；选择 qqfy 时语言范围更广，但具体能力仍以实际返回为准。
返回中的 types 字段表示实际识别的源语言，text 为译文，msg 回显原文，建议以 code 判断是否成功。
请对同一内容做本地缓存，重复相同的翻译请求既浪费带宽，也容易触发频率限制。
建议为调用方设置合理的请求间隔与超时（如 5～10 秒），并对失败请求做有限次重试，不要高频轮询。
接口支持 GET 与 POST，较长文本建议使用 POST 提交，避免 URL 长度限制导致参数丢失。
仅在 HTTPS 下调用本站地址，防止翻译内容在传输过程中被窃听或篡改。
翻译结果由自动化引擎生成，可能存在语义偏差，请勿直接用于法律、医疗、合同等对准确性要求极高的场景。

翻译

请求参数

返回示例

详细文档

翻译

接口说明

调用地址

请求方式

鉴权说明

请求参数

参数取值说明

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

酷我音乐