Translate text or extract and translate text from images or image URLs using multiple engines including Baidu, Google, DeepL, and ChatGPT, supporting batch p...
象寄翻译服务提供高质量的文本翻译和图片翻译功能，支持多种翻译引擎，覆盖全球多种语言。
使用前需要获取以下密钥：
| 密钥类型 | 说明 | 用途 |
|---|---|---|
| TextTransKey | 文本翻译密钥 | 文本翻译，在请求头 X-API-Key 中传递 |
| ImgTransKey | 图片翻译服务标识码 | 图片翻译，用于签名计算 |
| UserKey | 用户密钥 | 图片翻译，用于签名计算 |
获取密钥: 登录 象寄控制台 获取相关密钥。
使用 scripts/text_translate.py 进行文本翻译。
python scripts/text_translate.py \
--api-key YOUR_TEXT_TRANS_KEY \
--texts "你好世界" \
--source-language CHS \
--target-language ENG
python scripts/text_translate.py \
--api-key YOUR_TEXT_TRANS_KEY \
--texts "你好世界" "今天天气很好" "欢迎使用象寄翻译" \
--source-language CHS \
--target-language ENG
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 | 阿里云翻译 |
| Google 翻译 | |
| Papago | Papago 翻译（韩语优势） |
| Baidu | 百度翻译 |
| DeepL | DeepL 翻译（欧洲语言优势） |
| Chatgpt | ChatGPT 翻译 |
| GoogleLLM | Google 大模型翻译 |
使用 scripts/image_translate.py 进行图片翻译，支持本地文件和 URL 两种方式。
翻译本地图片文件中的文字：
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
翻译网络图片（支持批量）：
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 模式获得更高质量的翻译结果：
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=异步返回 |
图片翻译接口需要签名验证，签名方法：
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
| 功能 | 端点 |
|---|---|
| 文本翻译 | 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 | 额度不足 |
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
python scripts/text_translate.py \
--api-key YOUR_API_KEY \
--texts "你好，欢迎使用象寄翻译服务" \
--source-language CHS \
--target-language JPN \
--vendor Chatgpt
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
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
如有问题或需要技术支持，请通过以下方式联系：
ZIP package — ready to use