> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Anbindung und Nutzung der Localization Translate API

> Localization translation 集成指南 - XHuoAPI

Die Hauptfunktion der Localization Translate API besteht darin, durch Eingabe des zu übersetzenden Textes den übersetzten Text zu erhalten. Die Zielsprache der Übersetzung kann dabei individuell festgelegt werden, und die Übersetzungsergebnisse können in den beiden gängigen Formaten `json` und `markdown` ausgegeben werden.

Dieses Dokument wird die Anbindung der Translate API detailliert erläutern und Ihnen helfen, diese API einfach zu integrieren und ihre leistungsstarken Funktionen voll auszuschöpfen. Mit der Translate API können Sie den eingegebenen Text mühelos in eine bestimmte Sprache übersetzen und unterstützen spezifische Methoden zur Ausgabe der Übersetzungsergebnisse.

## Antragsprozess

Um die Localization Translate API zu nutzen, müssen Sie zunächst auf die Anmeldeseite [Localization Translate API](https://api.xhuoapi.ai/documents/6dcc60d0-a973-4ad2-92d8-11f4d3775532) gehen und den entsprechenden Dienst beantragen. Nach dem Betreten der Seite klicken Sie auf die Schaltfläche „Acquire“, wie im Bild gezeigt:

![Anmeldeseite](https://cdn.xhuoapi.ai/rci31i.png)

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur [Anmeldeseite](https://api.xhuoapi.ai) weitergeleitet, um sich zu registrieren und anzumelden. Nach der Anmeldung werden Sie automatisch zur aktuellen Seite zurückgeleitet.

Bei der ersten Antragstellung gibt es ein kostenloses Kontingent, mit dem Sie die API kostenlos nutzen können.

## Anfragebeispiel

Wir nehmen ein Beispiel mit einer englischen Eingabe, um zu demonstrieren, wie man die API verwendet. Angenommen, der englische Beschreibungstext lautet: `# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.`, im Folgenden zeigen wir, wie man den englischen Beschreibungstext hochlädt und die chinesische Übersetzung erhält, die gleichzeitig im Markdown-Format angezeigt wird.

### Anfrageheader und Anfragekörper festlegen

**Request Headers** umfassen:

* `accept`: Gibt an, dass die Antwort im JSON-Format empfangen werden soll, hier eingetragen als `application/json`.
* `authorization`: Der Schlüssel zur Nutzung der API, nach der Beantragung kann dieser direkt ausgewählt werden.

**Request Body** umfasst:

* `input`: Der hochzuladende Text, der übersetzt werden soll.
* `locale`: Die zu übersetzende Sprache.
* `extension`: Die gewünschte Darstellungsform des Übersetzungsergebnisses.
* `model`: Das große Modell, das für die Übersetzung verwendet wird, standardmäßig gpt-3.5.

Einstellung wie im folgenden Bild gezeigt:

<p>
  <img src="https://cdn.xhuoapi.ai/d4uqst.png" width="500" className="m-auto" />
</p>

### Codebeispiel

Es ist zu erkennen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie im Bild gezeigt:

<p>
  <img src="https://cdn.xhuoapi.ai/tn5nno.png" width="500" className="m-auto" />
</p>

Einige Codebeispiele sind wie folgt:

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
  "locale": "zh-CN",
  "extension": "md"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/localization/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
    "locale": "zh-CN",
    "extension": "md"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

### Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die Ergebnisinformationen dieser Übersetzungsaufgabe zurück. Zum Beispiel:

```json theme={null}
{
  "data": "# 标题 1\n\n这是一个段落。\n\n## 标题 2\n\n这是另一个段落。",
  "usage": {
    "prompt_tokens": 172,
    "completion_tokens": 25
  },
  "model": "gpt-3.5-turbo-16k",
  "locale": "zh-CN"
}
```

Es ist zu erkennen, dass das Ergebnis ein `data`-Feld enthält, das die übersetzte chinesische Version enthält und im Markdown-Format zurückgegeben wird. Weitere Informationen sind wie folgt:

* `data`, das Ergebnis dieser Übersetzungsaufgabe.
* `model`, das für diese Übersetzungsaufgabe verwendete große Sprachmodell.
* `locale`, der Typ der Übersetzungssprache dieser Übersetzungsaufgabe.

## Fehlerbehandlung

Wenn bei der Verwendung der API Fehler auftreten, gibt die API die entsprechenden Fehlercodes und -informationen zurück. Zum Beispiel:

* `400 token_mismatched`: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
* `400 api_not_implemented`: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
* `401 invalid_token`: Unbefugt, ungültiger oder fehlender Autorisierungstoken.
* `429 too_many_requests`: Zu viele Anfragen, Sie haben das Kontingent überschritten.
* `500 api_error`: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

### Fehlerantwortbeispiel

```json theme={null}
{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```

## Fazit

Durch dieses Dokument haben Sie erfahren, wie Sie die Localization Translate API nutzen können, um den eingegebenen Text mühelos in eine bestimmte Sprache zu übersetzen und spezifische Methoden zur Ausgabe der Übersetzungsergebnisse zu unterstützen. Wir hoffen, dass dieses Dokument Ihnen hilft, die API besser anzubinden und zu nutzen. Bei Fragen wenden Sie sich bitte jederzeit an unser technisches Support-Team.