Translate (2025-05-01-preview)

Mit der Textübersetzungs-API können Sie Ihren Quellsprachtext in einen angegebenen Zielsprachtext übersetzen.

Anfrage-URL

Globale Endpunktkonfiguration

Senden einer POST Anforderung:

Fenster

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?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/translate?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/translate?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/translate?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

Anforderungsheader umfassen:

Anforderungsparameter

Anforderungsparameter, die mit der Anforderung übergeben werden, sind wie folgt:

Zielarray (vom Benutzer angegebene Werte für übersetzten Text)

Geschlechtsspezifische Übersetzungen

In der folgenden Tabelle sind geschlechtsspezifische Übersetzungen mit dem optionalen Ziel-Gender-Parameter aufgeführt.

Anfragekörper

Der Anforderungstext wird als JSON-Array formatiert, wobei jedes Element ein JSON-Objekt ist. Jedes Objekt enthält eine erforderliche Eigenschaft namens text, die die zu übersetzende Zeichenfolge und ein erforderliches targets Array darstellt. Das targets Array enthält die erforderliche language Eigenschaft, die den Sprachcode für die Übersetzung angibt.

[
  {
    "text": "I would really like to drive your car around the block a few times.",
    "language": "en",
    "targets": [
      {
        "language": "es"
      }
    ]
  }
]

Informationen zu Zeichen- und Arraygrenzwerten finden Sie unterAnforderungsgrenzwerte.

Antworttext

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

• detectedLanguage: Ein Objekt, das die erkannte Sprache durch die folgenden Eigenschaften beschreibt:

  • language: Eine Zeichenfolge, die den Code der Quellsprache darstellt.

  • score: Ein Gleitkommawert zwischen Null und ein Wert, der die statistische Konfidenz und Genauigkeit darstellt, die die erkannte Sprache korrekt ist. Die Bewertung liegt zwischen Null und 1 und einem niedrigen Wert, was eine niedrige Konfidenz angibt.

  Die detectedLanguage Eigenschaft ist nur im Ergebnisobjekt vorhanden, wenn die Sprache autodetection angefordert wird.

• translations: Ein Array von Übersetzungsergebnissen. Die Größe des Arrays entspricht der Anzahl der im Abfrageparameter angegebenen to Zielsprachen. Jedes Element im Array umfasst Folgendes:

  • text: Eine Zeichenfolge, die den übersetzten Text angibt.

  • language: Eine Zeichenfolge, die den Sprachcode der Zielsprache darstellt.

  • transliteration: Ein Objekt, das den übersetzten Text in dem vom toScript Parameter angegebenen Skript angibt.

    • script: Eine Zeichenfolge, die das Zielskript angibt.

    • text: Eine Zeichenfolge, die den übersetzten Text im Zielskript angibt.

    Das transliteration Objekt ist nicht enthalten, wenn die Transliteration nicht stattfindet.

• sourceText: Ein Objekt mit einer einzelnen Zeichenfolgeneigenschaft namens text, die den Eingabetext im Standardskript der Quellsprache angibt. sourceText eigenschaft ist nur vorhanden, wenn die Eingabe in einem Skript ausgedrückt wird, das nicht das übliche Skript für die Sprache ist. Wenn die Eingabe beispielsweise arabisch in lateinischer Schrift geschrieben wurde, wäre derselbe sourceText.text arabische Text, der in arabische Schrift konvertiert wird.

Beispiele für JSON-Antworten finden Sie im Abschnitt "Beispiele ".

Antwortkopfzeilen

Examples

Übersetzen von Quelltext mithilfe von NMT

Bitten

 [
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es"
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "sourceCharacters": 72
      }
    ]
  }
]

Antwortheader

"sourceCharactersCharged": 72

Übersetzen von Quelltext in mehrere Sprachen mithilfe von NMT

Bitten

[
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es"
      },
      {
        "language": "de"
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "sourceCharacters": 72
      },
      {
        "text": "Der Arzt ist nächsten Montag verfügbar. Möchten Sie einen Termin vereinbaren?",
        "language": "de",
        "sourceCharacters": 72
      }
    ]
  }
]

Antwortheader

"sourceCharactersCharged": 144

Übersetzen mit großem Sprachmodell

Diese Anforderung verwendet eine gpt-4o-mini-Modellinstanz mit einem benutzerdefinierten Namen (contoso-gpt-4o-mini). Wenn die Quellsprache nicht angegeben ist, erkennt das System sie automatisch.

[
  {
    "Text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "targets": [
      {
        "language": "es",
        "deploymentName": "contoso-gpt-4o-mini"
      }
    ]
  }
]

Übersetzen mithilfe der GPT-4o mini Bereitstellung und NMT

• Hier wird der Quelltext unter Verwendung eines angegebenen Modus (gpt-4o) und unter Verwendung des allgemeinen NMT-Modells in die spanische Sprache übersetzt.
• Die Verwendung eines LLM Modells erfordert, dass Sie über eine Azure AI Foundry-Ressource verfügen. Weitere Informationen finden Sie unterKonfigurieren von Azure AI-Ressourcen.

Bitten

 [
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es",
        " deploymentName": "your-gpt-4o-mini-deployment-name"
      },
      {
        "language": "de"
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "instructionTokens": 12,
        "sourceTokens": 14,
        "targetTokens": 16
      },
      {
        "text": "Der Arzt ist nächsten Montag verfügbar. Möchten Sie einen Termin vereinbaren?",
        "language": "de",
        "sourceCharacters": 72
      }
    ]
  }
]

Antwortheader

"sourceCharactersCharged": 72
"sourceTokensCharged": 26
"targetTokensCharged": 16

Übersetzen sie die Angabe von Geschlecht und Ton mithilfe der GPT-4o mini Bereitstellung

Die Verwendung eines LLM Modells erfordert, dass Sie über eine Azure AI Foundry-Ressource verfügen. Weitere Informationen finden Sie unterKonfigurieren von Azure AI-Ressourcen.

Bitten

[
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es",
        "deploymentName": "your-gpt-4omini-deployment-name",
        "tone": "formal",
        "gender": "female"
      },
      {
        "language": "es",
        "deploymentName": "your-gpt-4omini-deployment-name",
        "tone": "formal",
        "gender": "male"
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "promptTokens": 12,
        "sourceTokens": 14,
        "targetTokens": 16
      },
      {
        "text": "El médico estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "instructionTokens": 12,
        "sourceTokens": 14,
        "targetTokens": 16
      }
    ]
  }
]

Antwortheader

"sourceTokensCharged": 52
"targetTokensCharged": 32

Textübersetzungsanforderung beim Anwenden einer adaptiven benutzerdefinierten Übersetzung mit Dataset

Adaptive benutzerdefinierte Übersetzung wird in der Übersetzerdienstinfrastruktur bereitgestellt. Gebühren basieren auf Quellzeichen.

Bitten

[
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es",
        "adaptiveDatasetId": "TMS-en-es-hr-020"
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "sourceCharacters": 72,
        "targetChaaracters": 72
      }
    ]
  }
]

Antwortheader

"sourceCharactersCharged": 72 "targetChaaractersCharged": 72

Textübersetzungsanforderung beim Anwenden einer adaptiven benutzerdefinierten Übersetzung mit Referenzpaaren

Bitten

[
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es",
        "referenceTextPairs": [
          {
            "source": "text_in_en",
            "target": " text_in_es"
          },
          {
            "source": " text_in_en",
            "target": " text_in_es"
          }
        ]
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "sourceCharacters": 72,
        "targetCharacters": 72
      }
    ]
  }
]

Antwortheader

"sourceCharactersCharged": 72
"targetCharactersCharged": 72

Textübersetzungsanforderung mit benutzerdefinierter Übersetzung

Bitten

[
  {
    "text": "Doctor is available next Monday. Do you want to schedule an appointment?",
    "language": "en",
    "targets": [
      {
        "language": "es",
        "deploymentName": "f16e83fb-3af8-4d45-9290-10a516f9dfc4-GENERAL"
      }
    ]
  }
]

Antwort

[
  {
    "detectedLanguage": {
      "language": "en",
      "score": 1
    },
    "translations": [
      {
        "text": "La médica estará disponible el próximo lunes. ¿Desea programar una cita?",
        "language": "es",
        "sourceCharacters": 72
      }
    ]
  }
]

Antwortheader

"sourceCharactersCharged": 72

Nächste Schritte