象寄翻译服务

象寄翻译服务提供高质量的文本翻译和图片翻译功能，支持多种翻译引擎，覆盖全球多种语言。

官方资源

• - 官网: https://www.xiangjifanyi.com/
• API 文档: https://openapi-doc.xiangjifanyi.com/
• 微信客服: xiangjifanyi（扫码或直接添加微信在线客服）

功能特点

• - 文本翻译: 支持多语言文本翻译，可选择不同翻译引擎
• 图片翻译: 智能识别图片中的文字并翻译，支持本地文件和URL两种方式
• 批量处理: 支持批量翻译多张图片
• 多种引擎: 支持阿里云、Google、百度、DeepL、ChatGPT 等多种翻译引擎

---

前置条件

使用前需要获取以下密钥：

密钥类型	说明	用途
TextTransKey	文本翻译密钥	文本翻译，在请求头 X-API-Key 中传递
ImgTransKey

图片翻译服务标识码 | 图片翻译，用于签名计算 |
| UserKey | 用户密钥 | 图片翻译，用于签名计算 |

获取密钥: 登录 象寄控制台 获取相关密钥。

---

文本翻译

使用 scripts/text_translate.py 进行文本翻译。

基本用法

bash
python scripts/text_translate.py \
--api-key YOURTEXTTRANS_KEY \
--texts 你好世界 \
--source-language CHS \
--target-language ENG

批量翻译

bash
python scripts/text_translate.py \
--api-key YOURTEXTTRANS_KEY \
--texts 你好世界 今天天气很好 欢迎使用象寄翻译 \
--source-language CHS \
--target-language ENG

指定翻译引擎

bash
python scripts/text_translate.py \
--api-key YOURTEXTTRANS_KEY \
--texts Hello, how are you? \
--source-language ENG \
--target-language CHS \
--vendor DeepL

参数说明

参数	必填	说明
--api-key	是	文本翻译密钥 (TextTransKey)
--texts

是 | 要翻译的文本（可多个，空格分隔） | | --source-language | 是 | 源语言代码 | | --target-language | 是 | 目标语言代码 | | --vendor | 否 | 翻译引擎，可选值见下表 |

支持的翻译引擎

Vendor	说明
Aliyun	阿里云翻译
Google

Google 翻译 | | Papago | Papago 翻译（韩语优势） | | Baidu | 百度翻译 | | DeepL | DeepL 翻译（欧洲语言优势） | | Chatgpt | ChatGPT 翻译 | | GoogleLLM | Google 大模型翻译 |

---

图片翻译

使用 scripts/image_translate.py 进行图片翻译，支持本地文件和 URL 两种方式。

本地文件翻译

翻译本地图片文件中的文字：

bash
python scripts/image_translate.py \
--img-key YOURIMGTRANS_KEY \
--user-key YOURUSERKEY \
--file /path/to/image.png \
--source-language JPN \
--target-language ENG

URL 翻译（批量）

翻译网络图片（支持批量）：

bash
python scripts/image_translate.py \
--img-key YOURIMGTRANS_KEY \
--user-key YOURUSERKEY \
--urls https://example.com/image1.jpg https://example.com/image2.jpg \
--source-language CHS \
--target-language ENG

高质量翻译

使用 BestQuality 模式获得更高质量的翻译结果：

bash
python scripts/image_translate.py \
--img-key YOURIMGTRANS_KEY \
--user-key YOURUSERKEY \
--file /path/to/image.png \
--source-language JPN \
--target-language ENG \
--qos BestQuality

参数说明

参数	必填	说明
--img-key	是	图片翻译服务标识码 (ImgTransKey)
--user-key

是 | 用户密钥 (UserKey)，用于签名 | | --file | 二选一 | 本地图片文件路径 | | --urls | 二选一 | 图片 URL 列表（可多个，空格分隔） | | --source-language | 是 | 源语言代码 | | --target-language | 是 | 目标语言代码 | | --qos | 否 | 翻译质量：LowLatency（偏好速度）或 BestQuality（偏好质量） | | --need-watermark | 否 | 是否添加水印：1=是，0=否（默认 1） | | --need-rm-url | 否 | 是否返回去文字图片链接：1=是 | | --engine-type | 否 | 翻译引擎类型（5=ChatGPT） | | --sync | 否 | URL 翻译时：1=同步返回（默认），2=异步返回 |

签名计算

图片翻译接口需要签名验证，签名方法：

python
Sign = md5(CommitTime + + UserKey + + ImgTransKey).lower()

脚本会自动计算签名，只需提供 --user-key 和 --img-key。

---

支持的语言

常用语言代码

代码	语言	代码	语言
CHS	中文简体	CHT	中文繁体
ENG

英语 | JPN | 日语 | | KOR | 韩语 | DEU | 德语 | | FRA | 法语 | ESP | 西班牙语 | | RUS | 俄语 | PT | 葡萄牙语 | | ITA | 意大利语 | TH | 泰语 | | VIN | 越南语 | ID | 印尼语 |

完整语言列表见 references/languages.md

---

API 端点

功能	端点
文本翻译	POST https://api.tosoiot.com/task/v1/text/translate
图片翻译（文件）

POST https://api2.tosoiot.com/ | | 图片翻译（URL 批量） | POST https://api.tosoiot.com/ |

---

错误码

Code	说明
200	响应成功
101

请求超时 | | 102 | 系统错误 | | 104 | 参数错误 | | 105 | 该语向不支持 | | 107 | 翻译错误 | | 110 | 账号没有开通服务 | | 113 | 账号服务没有开通或者欠费 | | 120 | 额度不足 |

---

使用示例

示例 1：翻译日文图片为英文

bash
python scripts/image_translate.py \
--img-key YOURIMGKEY \
--user-key YOURUSERKEY \
--file /path/to/japanese_manga.png \
--source-language JPN \
--target-language ENG \
--qos BestQuality

示例 2：翻译中文文本为日语

bash
python scripts/text_translate.py \
--api-key YOURAPIKEY \
--texts 你好，欢迎使用象寄翻译服务 \
--source-language CHS \
--target-language JPN \
--vendor Chatgpt

示例 3：批量翻译电商图片

bash
python scripts/image_translate.py \
--img-key YOURIMGKEY \
--user-key YOURUSERKEY \
--urls https://example.com/product1.jpg https://example.com/product2.jpg \
--source-language CHS \
--target-language ENG

示例 4：使用 DeepL 翻译欧洲语言

bash
python scripts/text_translate.py \
--api-key YOURAPIKEY \
--texts Guten Tag, wie geht es Ihnen? \
--source-language DEU \
--target-language FRA \
--vendor DeepL

---

联系方式

如有问题或需要技术支持，请通过以下方式联系：

• - 微信客服: xiangjifanyi（扫码或直接添加微信在线客服）
• 官网: https://www.xiangjifanyi.com/
• API 文档: https://openapi-doc.xiangjifanyi.com/