ifly-translate

Translate text using iFlytek's Machine Translation API (机器翻译). Supports 70+ language pairs.

Setup

1. 1. Create an app at 讯飞控制台 with 机器翻译 service enabled
2. Set environment variables:

Usage

Basic translation (Chinese → English by default)

CODEBLOCK1

Specify source and target language

CODEBLOCK2

Read from stdin

CODEBLOCK3

Read from file

CODEBLOCK4

Options

Common language codes

Aliases are supported: zh→cn, chinese→cn, english→en, japanese→ja, etc.

Full language list:

Examples

CODEBLOCK5

Output

• - Default: translated text only (stdout)
• INLINECODE35: shows source and target with language labels
• INLINECODE36: full API JSON response

Notes

• - Auth: HMAC-SHA256 with Digest header (SHA-256 of body) — different from some other xfyun APIs
• Endpoint: INLINECODE37
• Env vars: XFYUN_APP_ID, XFYUN_API_KEY, INLINECODE40
• Text is base64-encoded in the request body
• No pip deps: Uses only Python stdlib (urllib, hmac, hashlib, json, etc.)

常见问题 FAQ (´,,•ω•,,)♡

机器翻译的主要功能是什么？

机器翻译支持哪些语种？

机器翻译支持什么应用平台？

机器翻译支持的文本长度是多少？

是否支持源语种的自动识别？

机器翻译如何购买？

• - 📦 查看套餐包：讯飞控制台
• 💰 价格详情：价格页面

❌ 常见错误及解决方案 (´,,•ω•,,)♡

错误：认证失败 / Invalid credential

可能原因：

• - API Key 或 API Secret 填写错误啦 (´；ω；) - 环境变量没有正确设置 **解决方法**： 1. 确认你正确设置了环境变量： CODEBLOCK6 2. 检查是否有空格或多余的引号哦 ✧(≖ ◡ ≖) 3. 去 [讯飞控制台](https://console.xfyun.cn) 确认你的密钥是否正确复制~ --- ### 错误：服务未开通 / Service not enabled **表现**：返回 403 Forbidden 或提示服务未开通 **可能原因**： - 机器翻译服务还没有开通呢 (；´ДA)

解决方法：

1. 1. 登录 讯飞控制台
2. 点击「创建新应用」或选择已有应用
3. 在「产品服务」中找到「机器翻译」并开通
4. 开通后可能需要几分钟生效，稍等一下下~ (,,•́ . •̀,,)

错误：额度不足 / Quota exceeded

可能原因：

• - 免费额度用完啦，或者套餐包到期了 (╥_╥)

解决方法：

1. 1. 登录 讯飞控制台 查看剩余额度
2. 如果需要更多资源，可以：

错误：文本过长 / Text too long

可能原因：

• - 单次翻译的文本超过4096字节啦 (⊙_⊙)

解决方法：

1. 1. 将长文本拆分成多个小段落进行翻译
2. 每个段落单独调用翻译接口
3. 最后将结果拼接起来~ ✨

错误：网络连接失败 / Connection error

可能原因：

• - 网络不稳定 or 防火墙拦截了 (；・∀・)

解决方法：

1. 1. 检查网络连接是否正常
2. 如果是企业网络，尝试关闭防火墙或代理
3. 确认 itrans.xfyun.cn 是否可访问
4. 可以ping一下试试看：INLINECODE51

错误：语种不支持 / Language not supported

可能原因：

• - 使用的语言代码不在支持列表中 (￣▽￣)

解决方法：

1. 1. 请参考上方「Common language codes」表格
2. 语言代码要使用标准的双字母代码哦，比如 cn、en、INLINECODE54
3. 支持的语言列表详见：讯飞机器翻译API文档

❓ 其他常见问题

Q: 为什么翻译结果返回为空？

A: 检查一下输入的文本是否为空，或者是否包含特殊字符导致编码问题哦~ (｡・ω´・) **Q: 翻译速度很慢怎么办？** > A: 可以检查一下网络状况，或者将长文本拆分处理~ **Q: 如何查看我的使用量？** > A: 登录 [讯飞控制台](https://console.xfyun.cn/services/its) 即可查看详细的使用统计和账单信息！ --- 💡 **小提示**： - 使用 --raw` 参数可以看到完整的API响应，方便调试哦~

• - 遇到不确定的错误时，可以把错误信息复制到搜索引擎搜索一下，或者查看 官方文档 寻求帮助 (◕‿◕)
• 购买套餐包请访问：讯飞控制台 或 价格页面 ✨