iflytek ifly-translate
Translate text using iFlytek's Machine Translation API (机器翻译). Supports 70+ language pairs.
Setup
- Create an app at 讯飞控制台 with 机器翻译 service enabled
- Set environment variables:
export XFYUN_APP_ID="your_app_id" export XFYUN_API_KEY="your_api_key" export XFYUN_API_SECRET="your_api_secret"
Usage
Basic translation (Chinese → English by default)
python3 scripts/translate.py "你好世界"
Specify source and target language
python3 scripts/translate.py -s en -t cn "Hello world"
Read from stdin
echo "こんにちは" | python3 scripts/translate.py - -s ja -t cn
Read from file
python3 scripts/translate.py -f document.txt -s cn -t en
Options
| Flag | Short | Description |
|---|---|---|
text |
Text to translate (use - for stdin) |
|
--file |
-f |
Read text from a file |
--from |
-s |
Source language code (default: cn) |
--to |
-t |
Target language code (default: en) |
--verbose |
-v |
Show source/target language labels |
--raw |
Output raw JSON response |
Common language codes
| Code | Language | Code | Language |
|---|---|---|---|
cn |
中文 | en |
English |
ja |
日语 | ko |
韩语 |
fr |
法语 | de |
德语 |
es |
西班牙语 | ru |
俄语 |
ar |
阿拉伯语 | th |
泰语 |
vi |
越南语 | pt |
葡萄牙语 |
it |
意大利语 | tr |
土耳其语 |
Aliases are supported: zh→cn, chinese→cn, english→en, japanese→ja, etc.
Full language list: https://www.xfyun.cn/doc/nlp/xftrans/API.html
Examples
# Chinese to English
python3 scripts/translate.py "人工智能改变世界"
# English to Chinese
python3 scripts/translate.py -s en -t cn "Artificial intelligence changes the world"
# Japanese to Chinese
python3 scripts/translate.py -s ja -t cn "おはようございます"
# Verbose output with language labels
python3 scripts/translate.py -v "你好"
# Raw JSON for debugging
python3 scripts/translate.py --raw "测试翻译"
Output
- Default: translated text only (stdout)
--verbose: shows source and target with language labels--raw: full API JSON response
Notes
- Auth: HMAC-SHA256 with Digest header (SHA-256 of body) — different from some other xfyun APIs
- Endpoint:
POST https://itrans.xfyun.cn/v2/its - Env vars:
XFYUN_APP_ID,XFYUN_API_KEY,XFYUN_API_SECRET - Text is base64-encoded in the request body
- No pip deps: Uses only Python stdlib (
urllib,hmac,hashlib,json, etc.)
常见问题 FAQ (´,,•ω•,,)♡
机器翻译的主要功能是什么？
答：支持文本到文本的机器翻译 ✨
机器翻译支持哪些语种？
答：目前支持包括英、日、法、西、俄等70多种语言，详细的语种可见 语种列表~
机器翻译支持什么应用平台？
答：目前仅支持webapi接口哦 (,,•́ . •̀,,)
机器翻译支持的文本长度是多少？
答：单次文本长度不得超过4096字节~
是否支持源语种的自动识别？
答：目前不支持，后续会开放，新消息请关注平台动态 (◕‿◕)
机器翻译如何购买？
答：机器翻译产品页对应产品价格 → 点击申请购买，填好相关信息，商务工作人员会及时与您联系~
❌ 常见错误及解决方案 (´,,•ω•,,)♡
错误：认证失败 / Invalid credential
表现：返回 401 Unauthorized 或 authentication error
可能原因：
- API Key 或 API Secret 填写错误啦 (´；ω；`)
- 环境变量没有正确设置
解决方法：
- 确认你正确设置了环境变量：
export XFYUN_APP_ID="你的APP_ID" export XFYUN_API_KEY="你的API_KEY" export XFYUN_API_SECRET="你的API_SECRET" - 检查是否有空格或多余的引号哦 ✧(≖ ◡ ≖)
- 去 讯飞控制台 确认你的密钥是否正确复制~
错误：服务未开通 / Service not enabled
表现：返回 403 Forbidden 或提示服务未开通
可能原因：
- 机器翻译服务还没有开通呢 (；´Д`A)
解决方法：
- 登录 讯飞控制台
- 点击「创建新应用」或选择已有应用
- 在「产品服务」中找到「机器翻译」并开通
- 开通后可能需要几分钟生效，稍等一下下~ (,,•́ . •̀,,)
错误：额度不足 / Quota exceeded
表现：返回 402 Payment Required 或提示额度不足
可能原因：
- 免费额度用完啦，或者套餐包到期了 (╥_╥)
解决方法：
错误：文本过长 / Text too long
表现：返回错误提示文本过长
可能原因：
- 单次翻译的文本超过4096字节啦 (⊙_⊙)
解决方法：
- 将长文本拆分成多个小段落进行翻译
- 每个段落单独调用翻译接口
- 最后将结果拼接起来~ ✨
错误：网络连接失败 / Connection error
表现：连接超时或网络错误
可能原因：
- 网络不稳定 or 防火墙拦截了 (；・∀・)
解决方法：
- 检查网络连接是否正常
- 如果是企业网络，尝试关闭防火墙或代理
- 确认
itrans.xfyun.cn是否可访问 - 可以ping一下试试看：
ping itrans.xfyun.cn
错误：语种不支持 / Language not supported
表现：返回语种错误或无法识别
可能原因：
- 使用的语言代码不在支持列表中 (￣▽￣)
解决方法：
- 请参考上方「Common language codes」表格
- 语言代码要使用标准的双字母代码哦，比如
cn、en、ja - 支持的语言列表详见：讯飞机器翻译API文档
❓ 其他常见问题
Q: 为什么翻译结果返回为空？
A: 检查一下输入的文本是否为空，或者是否包含特殊字符导致编码问题哦~ (｡・`ω´・)
Q: 翻译速度很慢怎么办？
A: 可以检查一下网络状况，或者将长文本拆分处理~
Q: 如何查看我的使用量？
A: 登录 讯飞控制台 即可查看详细的使用统计和账单信息！
💡 小提示：