🌍 QWenMT API 服務

基於通義千問的多格式翻譯 API 服務,相容 DeepLX、DeepL API 和 OpenAI 格式

🚀

高效能

基於通義千問大模型,提供高品質翻譯

🔄

多格式相容

支援 DeepLX、DeepL API 和 OpenAI 格式

🛡️

安全認證

多種認證方式,保護您的 API 使用

🤖

智能解析

支援自然語言翻譯指令解析

🔐 認證方式

本服務支援多種認證方式:

環境變數設定

可以透過以下環境變數設定服務:

  • AUTH_ENABLED: 設定為 true 啟用認證,預設為 false
  • API_KEY: 單個 API 金鑰
  • API_KEYS: 多個 API 金鑰,使用逗號分隔
  • PORT: 服務埠號,預設為 8000

設定範例:

export AUTH_ENABLED=true
export API_KEY=sk-your-api-key
# 或設定多個金鑰
export API_KEYS=sk-key1,sk-key2,sk-key3
export PORT=3000

認證請求範例

使用 Authorization Header
curl -X POST http://localhost:8000/translate   -H "Content-Type: application/json"   -H "Authorization: DeepL-Auth-Key sk-your-api-key"   -d '{
  "text": "Hello world",
  "source_lang": "auto",
  "target_lang": "ZH_TW"
}'
使用 X-API-Key Header
curl -X POST http://localhost:8000/translate   -H "Content-Type: application/json"   -H "X-API-Key: sk-your-api-key"   -d '{
  "text": "Hello world",
  "source_lang": "auto",
  "target_lang": "ZH_TW"
}'
使用 Query Parameter
curl -X POST "http://localhost:8000/translate?api_key=sk-your-api-key"   -H "Content-Type: application/json"   -d '{
  "text": "Hello world",
  "source_lang": "auto",
  "target_lang": "ZH_TW"
}'

🤖 OpenAI 相容介面

聊天完成介面 POST
/v1/chat/completions

相容 OpenAI 聊天完成 API 格式,支援自然語言翻譯指令。

請求範例
curl -X POST http://localhost:8000/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer sk-your-api-key"   -d '{
  "model": "qwen-mt-turbo",
  "messages": [
    {
      "role": "user",
      "content": "請將這段英文翻譯成中文:Hello world, how are you?"
    }
  ]
}'
模型列表介面 GET
/v1/models

取得可用的翻譯模型列表。

請求範例
curl -X GET http://localhost:8000/v1/models   -H "Authorization: Bearer sk-your-api-key"

支援的翻譯指令格式

指令範例

"請將英文翻譯成中文:Hello world"
"翻譯英文到中文:Hello world"
"把英文翻譯成中文:Hello world"
"translate English to Chinese: Hello world"

🚀 DeepL 相容介面

DeepLX 相容介面 POST
/translate

相容 DeepLX 格式的翻譯介面,適合需要替代方案的應用。

請求範例
curl -X POST http://localhost:8000/translate   -H "Content-Type: application/json"   -d '{
  "text": "Hello world",
  "source_lang": "auto",
  "target_lang": "ZH_TW"
}'
DeepL 相容介面 POST
/v2/translate

相容 DeepL API v2 格式的翻譯介面。

請求範例
curl -X POST http://localhost:8000/v2/translate   -H "Content-Type: application/json"   -d '{
  "text": ["Hello world"],
  "source_lang": "auto",
  "target_lang": "ZH_TW"
}'
原生 API 介面 POST
/api/translate

本服務原生的翻譯介面,功能與 /v2/translate 相同。

請求範例
curl -X POST http://localhost:8000/api/translate   -H "Content-Type: application/json"   -d '{
  "text": ["Hello world"],
  "source_lang": "auto",
  "target_lang": "ZH_TW"
}'
檢查服務狀態

版本: 0.0.2

由通義千問提供技術支援 ❤️ 大魔王