Transliterat (2025-05-01-Preview)

Die Texttransliterations-API ordnet Ihr Quellsprachenskript oder -alphabet einem Zielsprachenskript oder -alphabet zu. Im Gegensatz zur Übersetzung gibt transliteration nicht die Bedeutung zurück, nur die Art und Weise, wie der Text geschrieben wird.

Anfrage-URL

Globale Endpunktkonfiguration

Senden Sie eine POST Anforderung an:

curl -X POST https://api.cognitive.microsofttranslator.com/transliterate?api-version=2025-05-01-preview
 -H "Ocp-Apim-Subscription-Key:<your-key>" ^
 -H "Ocp-Apim-Subscription-Region:<your-resource-region>" ^
 -H "Content-Type: application/json" ^
 -d "<your-request-body>"

Linux oder macOS

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=2025-05-01-preview" \
-H "Ocp-Apim-Subscription-Key:<your-key>" \
-H "Ocp-Apim-Subscription-Region:<your-resource-region>" \
-H "Content-Type: application/json" \
-d "<your-request-body>"

Benutzerdefinierte Endpunktkonfiguration

Ihr benutzerdefinierter Domänenendpunkt ist eine URL, die mit Ihrem Ressourcennamen und Hostnamen formatiert ist und im Azure-Portal verfügbar ist. Wenn Sie Ihre Translator-Ressource erstellt haben, ist der Wert, den Sie im Name Feld eingegeben haben, der parameter für den benutzerdefinierten Domänennamen für den Endpunkt.

Senden einer POST Anforderung:

Fenster

curl -X POST "https://<your-resource-name>.cognitiveservices.azure.com//transliterate?api-version=2025-05-01-preview"^
    -H "Ocp-Apim-Subscription-Key:<your-key>"^
    -H "Ocp-Apim-Subscription-Region:<your-resource-region>"^
    -H "Content-Type: application/json"^
    -d "<your-request-body>"

Linux oder macOS

curl -X POST "https://<your-resource-name>.cognitiveservices.azure.com//transliterate?api-version=2025-05-01-preview" \
    -H "Ocp-Apim-Subscription-Key:<your-key>" \
    -H "Ocp-Apim-Subscription-Region:<your-resource-region>" \
    -H "Content-Type: application/json" \
    -d "<your-request-body>"

Privater Endpunkt

Weitere Informationen zum ausgewählten Übersetzerdienst und zur Konfiguration und Unterstützung privater Endpunkte finden Sie unterVirtual Network Support.For more information on Translator service selected network configuration and private endpoint configuration and support, see Virtual Network Support.

Anforderungsheader

Anforderungsparameter

Anforderungsparameter, die an die Abfragezeichenfolgenbereiche übergeben werden, sind wie folgt:

Anfragekörper

Der Textkörper der Anforderung ist ein JSON-Array. Jedes Arrayelement ist ein JSON-Objekt mit einer Zeichenfolgeneigenschaft namens Text, die die zu konvertierende Zeichenfolge darstellt.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Es gelten die folgenden Einschränkungen:

• Das Array kann höchstens 10 Elemente aufweisen.
• Der Textwert eines Arrayelements darf 1.000 Zeichen einschließlich Leerzeichen nicht überschreiten.
• Der gesamte text, der in der Anforderung enthalten ist, darf 5.000 Zeichen einschließlich Leerzeichen nicht überschreiten.

Antworttext

Eine erfolgreiche Antwort ist ein JSON-Array mit einem Ergebnis für jedes Element im Eingabearray. Ein Ergebnisobjekt enthält die folgenden Eigenschaften:

• text: Eine Zeichenfolge, die aus der Konvertierung der Eingabezeichenfolge in das Ausgabeskript resultiert.

• script: Eine Zeichenfolge, die das in der Ausgabe verwendete Skript angibt.

Beispiel für eine JSON-Antwort:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

Antwortkopfzeilen

Example

Das folgende Beispiel zeigt, wie zwei japanische Zeichenfolgen in romanisiertes Japanisch konvertiert werden.

  curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=2025-05-01-preview&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt

Die JSON-Nutzlast für die Anforderung in diesem Beispiel:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Statuscodes für Antworten

Im Folgenden finden Sie die möglichen HTTP-Statuscodes, die eine Anforderung zurückgeben kann.

Wenn ein Fehler auftritt, gibt die Anforderung auch eine JSON-Fehlerantwort zurück. Der Fehlercode ist eine 6-stellige Zahl, die den 3-stelligen HTTP-Statuscode kombiniert, gefolgt von einer 3-stelligen Zahl, um den Fehler weiter zu kategorisieren. Allgemeine Fehlercodes finden Sie auf der Statuscodereferenzseite.

Nächste Schritte