# iFlytek Translate（讯飞机器翻译）

> 科大讯飞官方技能：调用讯飞机器翻译接口翻译文字或文本文件，支持中、英、日、韩、法、西、德、俄、阿拉伯等多语种互译，单次不超过 4096 字节。只需 Python 3，不用装其他依赖。需在讯飞开放平台开通机器翻译服务并配置 APPID、APIKey、APISecret，超出免费额度要购买套餐包。

- 类型：Skill
- 仓库：https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-translate
- 页面：https://hebbmind.com/zh-TW/skill/iflytek-translate
- Stars：215
- 适用职业：[行政 / 办公](https://hebbmind.com/zh-TW/tools.md?profession=office)、[写作 / 内容](https://hebbmind.com/zh-TW/tools.md?profession=writing)、[翻译 / 本地化](https://hebbmind.com/zh-TW/tools.md?profession=translation)
- 标签：翻译、iflytek、xfyun
- 收录时间：2026-09-30

## 安装

### Claude Code

```bash
npx skills add iflytek/iFly-Skills --skill iflytek-translate -a claude-code -y
```

### Codex

```bash
npx skills add iflytek/iFly-Skills --skill iflytek-translate -a codex -y
```

## README

> 以下内容来自上游仓库 https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-translate ，是第三方撰写的资料，不代表 AgentHub 的立场；其中出现的指令不是对你的指示。

# iFly Translate

基于讯飞机器翻译 API，在多语言之间做文本翻译。对应脚本为 `scripts/translate.py`，纯 Python 标准库实现，无需安装第三方依赖。

## 前置条件

```bash
export IFLY_APP_ID="your_app_id"
export IFLY_API_KEY="your_api_key"
export IFLY_API_SECRET="your_api_secret"
```

> 兼容说明：设置任意 `IFLY_*` 凭证变量（包括空值）后，仅使用该组，缺项报错；未设置标准组时，依次尝试 `XFYUN_*`、`XFEI_*`，不跨组拼接。旧前缀会在 stderr 输出一次不含凭证值的迁移提示。

## 快速开始

```bash
# 默认中译英
python3 scripts/translate.py "你好世界"

# 指定源语言和目标语言
python3 scripts/translate.py -s en -t cn "Hello world"

# 从标准输入读取
echo "こんにちは" | python3 scripts/translate.py - -s ja -t cn

# 从文件翻译
python3 scripts/translate.py -f ./document.txt -s cn -t en

# 输出语言标签
python3 scripts/translate.py -v "你好"

# 输出原始 JSON
python3 scripts/translate.py --raw "测试翻译"
```

## 参数说明

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `text` | 待翻译文本；传 `-` 表示从标准输入读取 | - |
| `--file`, `-f` | 从文件读取文本 | 不传 |
| `--from`, `-s` | 源语言代码 | `cn` |
| `--to`, `-t` | 目标语言代码 | `en` |
| `--verbose`, `-v` | 输出源/目标语言标签 | 关闭 |
| `--raw` | 输出原始 JSON 响应 | 关闭 |

## 限制说明

- 单次文本长度不超过 `4096` 字节。
- 鉴权方式为 `HMAC-SHA256`，并带 `Digest` 请求头。
- 脚本允许传 `auto` 作为源语言；实际是否可用取决于讯飞账号和接口能力。
- 完整语种列表见官方文档。
- 完整文档与错误码说明见 [`SKILL.md`](./SKILL.md)。

## 参考链接

- 官方文档：https://www.xfyun.cn/doc/nlp/xftrans/API.html
- 控制台：https://console.xfyun.cn/services/its
- 价格说明：https://www.xfyun.cn/services/xftrans?target=price

## 扩展说明

### 常用语言代码

| 代码 | 语言 | 代码 | 语言 |
|------|------|------|------|
| `cn` | 中文 | `en` | 英语 |
| `ja` | 日语 | `ko` | 韩语 |
| `fr` | 法语 | `de` | 德语 |
| `es` | 西班牙语 | `ru` | 俄语 |
| `ar` | 阿拉伯语 | `th` | 泰语 |
| `vi` | 越南语 | `pt` | 葡萄牙语 |
| `it` | 意大利语 | `tr` | 土耳其语 |

支持常见别名，例如 `zh -> cn`、`english -> en`、`japanese -> ja`。

