Skip to main content
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 Integrationsanleitung der Translate API detailliert erläutern, um Ihnen zu helfen, diese leistungsstarke API einfach zu integrieren und optimal zu nutzen. 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 im Ace Data Cloud Dashboard Ihr API-Token abrufen und für zukünftige Verwendung aufbewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um die API kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.
📘 Vollständige Dokumentation: Localization Translate API →

​
Anfragebeispiel

Wir nehmen ein englisches Eingangsbeispiel, 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 wird gezeigt, wie man den englischen Beschreibungstext hochlädt und das chinesische Übersetzungsergebnis erhält, das 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 verwendete Übersetzungsmodell, standardmäßig gpt-3.5.
Einstellung wie im folgenden Bild gezeigt:

​
Codebeispiel

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

Einige Codebeispiele sind wie folgt:

​
CURL

​
Python

​
Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die Ergebnisinformationen dieser Übersetzungsaufgabe zurück. Zum Beispiel:
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 Sprachmodell.
  • locale, der Typ der Übersetzungssprache dieser Übersetzungsaufgabe.

​
Fehlerbehandlung

Wenn bei der Nutzung 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

​
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 zu integrieren und zu nutzen. Bei Fragen wenden Sie sich bitte jederzeit an unser technisches Support-Team.