象寄翻译服务#

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

官方资源#

• 官网: 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 YOUR_TEXT_TRANS_KEY \
  --texts "你好世界" \
  --source-language CHS \
  --target-language ENG

批量翻译#

bash

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

指定翻译引擎#

bash

python scripts/text_translate.py \
  --api-key YOUR_TEXT_TRANS_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阿里云翻译GoogleGoogle 翻译PapagoPapago 翻译（韩语优势）Baidu百度翻译DeepLDeepL 翻译（欧洲语言优势）ChatgptChatGPT 翻译GoogleLLMGoogle 大模型翻译

---

图片翻译#

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

本地文件翻译#

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

bash

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

URL 翻译（批量）#

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

bash

python scripts/image_translate.py \
  --img-key YOUR_IMG_TRANS_KEY \
  --user-key YOUR_USER_KEY \
  --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 YOUR_IMG_TRANS_KEY \
  --user-key YOUR_USER_KEY \
  --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 YOUR_IMG_KEY \
  --user-key YOUR_USER_KEY \
  --file /path/to/japanese_manga.png \
  --source-language JPN \
  --target-language ENG \
  --qos BestQuality

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

bash

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

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

bash

python scripts/image_translate.py \
  --img-key YOUR_IMG_KEY \
  --user-key YOUR_USER_KEY \
  --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 YOUR_API_KEY \
  --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/