Definiera anpassade översättningar

  • 5 minuter

Standardöversättningsmodellen som används av Azure AI Translator är effektiv för allmän översättning, men du kan behöva utveckla en översättningslösning för företag eller branscher i som har specifika ordförråd med termer som kräver anpassad översättning.

För att lösa det här problemet kan du skapa en anpassad modell som mappar dina egna uppsättningar med käll- och målvillkor för översättning. Om du vill skapa en anpassad modell använder du Custom Translator-portalen för att:

  1. Skapa en arbetsyta som är länkad till din Azure AI Translator-resurs.
  2. Skapa ett projekt.
  3. Ladda upp träningsdatafiler och träna en modell.
  4. Testa din modell och publicera din modell.
  5. Gör översättningsanrop till API:et.

Screenshot showing the Custom Translator portal.

Din anpassade modell tilldelas ett unikt kategori-ID (markerat i skärmbilden), som du kan ange i översätta anrop till din Azure AI Translator-resurs med hjälp av kategoriparametern , vilket gör att översättningen utförs av din anpassade modell i stället för standardmodellen.

Så här anropar du API:t

Om du vill initiera en översättning skickar du en POST-begäran till följande begärande-URL:

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

Din begäran måste innehålla ett par parametrar:

  • api-version: Den nödvändiga versionen av API:et.
  • to: Målspråket att översätta till. Till exempel: to=fr för franska.
  • category: Ditt kategori-ID.

Din begäran måste också innehålla ett antal nödvändiga rubriker:

  • Ocp-Apim-Subscription-Key. Rubrik för klientnyckeln. Exempel: Ocp-Apim-Subscription-Key=<your-client-key>.
  • Content-Type. Nyttolastens innehållstyp. Det format som krävs är: Content-Type: application/json; charset=UTF-8.

Begärandetexten ska innehålla en matris som innehåller ett JSON-objekt med en Text egenskap som anger den text som du vill översätta:

[
    {"Text":"Where can I find my employee details?"}
]

Det finns olika sätt att skicka din begäran till API:et, inklusive att använda C#, Python och curl. Om du till exempel vill göra ett snabbanrop kan du skicka en POST-begäran med curl:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

Begäran ovan gör ett anrop för att översätta en mening från engelska till nederländska.

Svaret returnerades

Svaret returnerar en svarskod 200 för om begäran lyckades. Den returnerar också en svarstext som innehåller den översatta texten, så här:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Om begäran inte lyckades kan ett antal olika statuskoder returneras beroende på feltypen, till exempel 400 (saknade eller ogiltiga frågeparametrar). Se Svarsstatuskoder för en fullständig lista över koder och deras förklaring.

Kommentar

Mer information om anpassad översättning finns i Snabbstart: Skapa, publicera och översätta med anpassade modeller.