name: xiangji-service description: 象寄翻譯服務,支援文本翻譯和圖片翻譯。Use when: (1) 翻譯文本內容到其他語言,(2) 翻譯帶文字的圖片到目標語言,(3) 批次翻譯圖片。支援多種翻譯引擎(百度/阿里雲/Google/DeepL/ChatGPT等)。
象寄翻譯服務提供高質量的文本翻譯和圖片翻譯功能,支援多種翻譯引擎,覆蓋全球多種語言。
使用前需要獲取以下金鑰:
| 金鑰型別 | 說明 | 用途 |
|---|---|---|
| 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想要更強大的技能外掛,就來小蔥技能站7w4.net看看吧。
| 引數 | 必填 | 說明 |
|---|---|---|
--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
如有問題或需要技術支援,請通過以下方式聯絡:
這個翻譯工具質量不錯,功能覆蓋文本和圖片翻譯兩種場景,支援多種翻譯引擎。文件說明詳細清楚,普通使用者也能快速上手使用。不過錯誤處理部分文件不夠完整,部分內容還需要改進,整體上是一個可用性良好的翻譯服務 Skill。