Aangepaste vertalingen definiëren

Voltooid

Hoewel het standaardvertalingsmodel dat wordt gebruikt door Azure AI Vertalen effectief is voor algemene vertaling, moet u mogelijk een vertaaloplossing ontwikkelen voor bedrijven of branches met specifieke woordenschats van termen waarvoor aangepaste vertaling is vereist.

U kunt dit probleem oplossen door een aangepast model te maken waarmee uw eigen sets bron- en doeltermen voor vertaling worden toegewezen. Als u een aangepast model wilt maken, gebruikt u de portal Aangepaste Vertalen om het volgende te doen:

1. Maak een werkruimte die is gekoppeld aan uw Azure AI-Vertalen-resource.
2. Maak een project.
3. Upload trainingsgegevensbestanden en train een model.
4. Test uw model en publiceer uw model.
5. Vertaaloproepen naar de API maken.

Aan uw aangepaste model wordt een unieke categorie-id toegewezen (gemarkeerd in de schermopname), die u kunt opgeven bij het omzetten van aanroepen naar uw Azure AI-Vertalen-resource met behulp van de categorieparameter, waardoor vertaling wordt uitgevoerd door uw aangepaste model in plaats van het standaardmodel.

De API aanroepen

Als u een vertaling wilt initiëren, verzendt u een POST-aanvraag naar de volgende aanvraag-URL:

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

Uw aanvraag moet een aantal parameters bevatten:

• api-version: de vereiste versie van de API.
• to: De doeltaal om naar te vertalen. Bijvoorbeeld: to=fr voor Frans.
• category: Uw categorie-id.

Uw aanvraag moet ook een aantal vereiste headers bevatten:

• Ocp-Apim-Subscription-Key. Header voor uw clientsleutel. Voorbeeld: Ocp-Apim-Subscription-Key=<your-client-key>.
• Content-Type. Het inhoudstype van de nettolading. De vereiste indeling is: Content-Type: application/json; charset=UTF-8.

De hoofdtekst van de aanvraag moet een matrix bevatten die een JSON-object bevat met een Text eigenschap waarmee de tekst wordt opgegeven die u wilt vertalen:

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

Er zijn verschillende manieren waarop u uw aanvraag naar de API kunt verzenden, waaronder het gebruik van C#, Python en curl. Als u bijvoorbeeld snel wilt bellen, kunt u een POST-aanvraag verzenden met behulp van 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?'}]"

De bovenstaande aanvraag doet een oproep om een zin van het Engels naar het Nederlands te vertalen.

Antwoord geretourneerd

Het antwoord retourneert een antwoordcode van 200 als de aanvraag is geslaagd. Het retourneert ook een antwoordtekst die de vertaalde tekst bevat, zoals deze:

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

Als de aanvraag niet is geslaagd, kan een aantal verschillende statuscodes worden geretourneerd, afhankelijk van het fouttype, zoals 400 (ontbrekende of ongeldige queryparameters). Zie antwoordstatuscodes voor een volledige lijst met codes en hun uitleg.

Notitie

Zie quickstart: Bouwen, publiceren en vertalen met aangepaste modellen voor meer informatie over aangepaste vertaling.