MTranServer 高度な設定説明

December 28, 2025 · View on GitHub

中文 | English | 日本語 | Français | Deutsch

環境変数設定

環境変数説明デフォルト値選択肢
MT_LOG_LEVELログレベルwarndebug, info, warn, error
MT_CONFIG_DIR設定ディレクトリ~/.config/mtran/server任意のパス
MT_MODEL_DIRモデルディレクトリ~/.config/mtran/models任意のパス
MT_HOSTサーバーリッスンアドレス0.0.0.0任意のIPアドレス
MT_PORTサーバーポート89891-65535
MT_ENABLE_UIWeb UI を有効にするtruetrue, false
MT_OFFLINEオフラインモード。新しい言語モデルを自動ダウンロードせず、ダウンロード済みのモデルのみ使用falsetrue, false
MT_WORKER_IDLE_TIMEOUTWorker アイドルタイムアウト(秒)300任意の正の整数
MT_API_TOKENAPI アクセストークン任意の文字列

例:

# ログレベルを debug に設定
export MT_LOG_LEVEL=debug

# ポートを 9000 に設定
export MT_PORT=9000

# サービスを起動
./mtranserver

API インターフェース説明

システムインターフェース

インターフェースメソッド説明認証
/versionGETサービスバージョンを取得いいえ
/healthGETヘルスチェックいいえ
/__heartbeat__GETハートビートチェックいいえ
/__lbheartbeat__GETロードバランサーハートビートチェックいいえ
/docs/*GETSwagger API ドキュメントいいえ

翻訳インターフェース

インターフェースメソッド説明認証
/languagesGETサポートされている言語リストを取得はい
/translatePOST単一テキスト翻訳はい
/translate/batchPOST一括翻訳はい

単一テキスト翻訳リクエスト例:

{
  "from": "en",
  "to": "zh-Hans",
  "text": "Hello, world!",
  "html": false
}

一括翻訳リクエスト例:

{
  "from": "en",
  "to": "zh-Hans",
  "texts": ["Hello, world!", "Good morning!"],
  "html": false
}

認証方式:

  • Header: Authorization: Bearer <token>
  • Query: ?token=<token>

詳細については、サーバー起動後の API ドキュメントを参照してください。