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 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 problemlos 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, wo Sie sich registrieren und anmelden können. 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, die englische Beschreibung lautet: # Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph., im Folgenden zeigen wir, wie man die englische Beschreibung hochlädt und das chinesische Übersetzungsergebnis erhält, während wir es in markdown-Form präsentieren.

​
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 zum Aufrufen der API, nach der Beantragung kann er direkt ausgewählt werden.
Request Body umfasst:
  • input: Der zu übersetzende Inhalt. Bei extension=md wird ein String übergeben, bei extension=json ein JSON-Objekt.
  • locale: Die zu übersetzende Sprache.
  • extension: Das Format des Eingabetyps, optional md oder json.
  • model: Das große Modell, das für die Übersetzung verwendet wird, standardmäßig gpt-3.5.
extension muss mit dem input Typ übereinstimmen; Strings können nicht json verwenden, JSON-Objekte können nicht md verwenden. Einstellungen 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 sehen, dass das Ergebnis ein data-Feld enthält, das die übersetzte chinesische Version enthält und in markdown-Form zurückgegeben wird. Weitere Informationen sind wie folgt:
  • data, das Ergebnis dieser Übersetzungsaufgabe.
  • model, das große Sprachmodell, das für diese Übersetzungsaufgabe verwendet wurde.
  • 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ültiges oder fehlendes Autorisierungstoken.
  • 429 too_many_requests: Zu viele Anfragen, Sie haben das Rate-Limit ü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 problemlos 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.