mirror of
https://github.com/xxnuo/MTranServer.git
synced 2026-05-08 14:36:07 +08:00
81 lines
2.5 KiB
Markdown
81 lines
2.5 KiB
Markdown
# MTranServer Erweiterte Konfigurationsanleitung
|
|
|
|
[中文](../API.md) | [English](API_en.md) | [日本語](API_ja.md) | [Français](API_fr.md) | [Deutsch](API_de.md)
|
|
|
|
### Umgebungsvariablenkonfiguration
|
|
|
|
| Umgebungsvariable | Beschreibung | Standardwert | Optionen |
|
|
| ----------------- | ------------ | ------------ | -------- |
|
|
| MT_LOG_LEVEL | Protokollierungsgrad | warn | debug, info, warn, error |
|
|
| MT_CONFIG_DIR | Konfigurationsverzeichnis | ~/.config/mtran/server | Beliebiger Pfad |
|
|
| MT_MODEL_DIR | Modellverzeichnis | ~/.config/mtran/models | Beliebiger Pfad |
|
|
| MT_HOST | Server-Abhöradresse | 0.0.0.0 | Beliebige IP-Adresse |
|
|
| MT_PORT | Server-Port | 8989 | 1-65535 |
|
|
| MT_ENABLE_UI | Web-UI aktivieren | true | true, false |
|
|
| MT_OFFLINE | Offline-Modus, neue Sprachmodelle nicht automatisch herunterladen, nur heruntergeladene Modelle verwenden | false | true, false |
|
|
| MT_WORKER_IDLE_TIMEOUT | Worker-Leerlauf-Timeout (Sekunden) | 300 | Beliebige positive ganze Zahl |
|
|
| MT_API_TOKEN | API-Zugriffstoken | Leer | Beliebige Zeichenfolge |
|
|
|
|
Beispiel:
|
|
|
|
```bash
|
|
# Protokollierungsgrad auf debug setzen
|
|
export MT_LOG_LEVEL=debug
|
|
|
|
# Port auf 9000 setzen
|
|
export MT_PORT=9000
|
|
|
|
# Dienst starten
|
|
./mtranserver
|
|
```
|
|
|
|
### API-Schnittstellenbeschreibung
|
|
|
|
#### Systemschnittstellen
|
|
|
|
| Schnittstelle | Methode | Beschreibung | Authentifizierung |
|
|
| ------------- | ------- | ------------ | ----------------- |
|
|
| `/version` | GET | Dienstversion abrufen | Nein |
|
|
| `/health` | GET | Gesundheitscheck | Nein |
|
|
| `/__heartbeat__` | GET | Heartbeat-Check | Nein |
|
|
| `/__lbheartbeat__` | GET | Load Balancer Heartbeat-Check | Nein |
|
|
| `/docs/*` | GET | Swagger API-Dokumentation | Nein |
|
|
|
|
#### Übersetzungsschnittstellen
|
|
|
|
| Schnittstelle | Methode | Beschreibung | Authentifizierung |
|
|
| ------------- | ------- | ------------ | ----------------- |
|
|
| `/languages` | GET | Liste der unterstützten Sprachen abrufen | Ja |
|
|
| `/translate` | POST | Einzeltextübersetzung | Ja |
|
|
| `/translate/batch` | POST | Stapelübersetzung | Ja |
|
|
|
|
**Beispiel für Einzeltextübersetzungsanfrage:**
|
|
|
|
```json
|
|
{
|
|
"from": "en",
|
|
"to": "zh-Hans",
|
|
"text": "Hello, world!",
|
|
"html": false
|
|
}
|
|
```
|
|
|
|
**Beispiel für Stapelübersetzungsanfrage:**
|
|
|
|
```json
|
|
{
|
|
"from": "en",
|
|
"to": "zh-Hans",
|
|
"texts": ["Hello, world!", "Good morning!"],
|
|
"html": false
|
|
}
|
|
```
|
|
|
|
**Authentifizierungsmethoden:**
|
|
|
|
- Header: `Authorization: Bearer <token>`
|
|
- Query: `?token=<token>`
|
|
|
|
|
|
Weitere Informationen finden Sie in der API-Dokumentation nach dem Start des Servers.
|