Translator 3.0: Vertalen

Artikel
09/27/2024

Hiermee wordt tekst vertaald.

Aanvraag-URL

Een aanvraag POST versturen naar:

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

Zie Virtual Network Support for Translator service selected network and private endpoint configuration and support.

Aanvraagparameters

Aanvraagparameters die worden doorgegeven aan de queryreeks zijn:

Vereiste parameters

Queryparameter	Beschrijving
api-versie	Vereiste parameter. Versie van de API die door de client is aangevraagd. Waarde moet zijn `3.0`.
to	Vereiste parameter. Hiermee geeft u de taal van de uitvoertekst. De doeltaal moet een van de ondersteunde talen in het `translation` bereik zijn. Gebruik bijvoorbeeld `to=de` om te vertalen naar het Duits. Het is mogelijk om te vertalen naar meerdere talen tegelijk door de parameter in de querytekenreeks te herhalen. Gebruik bijvoorbeeld `to=de&to=it` om te vertalen naar Duits en Italiaans.

Optionele parameters

Queryparameter	Beschrijving
van	Optionele parameter. Hiermee geeft u de taal van de invoertekst. Zoek vanuit welke talen u kunt vertalen door ondersteunde talen op te zoeken met behulp van het `translation` bereik. Als de `from` parameter niet is opgegeven, wordt automatische taaldetectie toegepast om de brontaal te bepalen. U moet de `from` parameter gebruiken in plaats van automatisch uit te voeren bij het gebruik van de functie dynamische woordenlijst . Opmerking: de functie dynamische woordenlijst is hoofdlettergevoelig.
textType	Optionele parameter. Hiermee bepaalt u of de tekst die wordt vertaald tekst zonder opmaak of HTML-tekst is. Elke HTML moet een goed gevormd, volledig element zijn. Mogelijke waarden zijn: `plain` (standaard) of `html`.
category	Optionele parameter. Een tekenreeks die de categorie (domein) van de vertaling aangeeft. Deze parameter wordt gebruikt om vertalingen op te halen van een aangepast systeem dat is gebouwd met Custom Translator. Als u het geïmplementeerde aangepaste systeem wilt gebruiken, voegt u de categorie-id van het Custom Translator-project toe aan de categorieparameter. Standaardwaarde is: `general`.
grof taalgebruik	Optionele parameter. Hiermee geeft u op hoe grof taalproblemen moeten worden behandeld in vertalingen. Mogelijke waarden zijn: `NoAction` (standaard), `Marked`of `Deleted`. Zie Afhandeling van grof taalgebruik voor meer informatie over manieren om grof taalgebruik te behandelen.
profanityMarker	Optionele parameter. Hiermee geeft u op hoe grof taalproblemen moeten worden gemarkeerd in vertalingen. Mogelijke waarden zijn: `Asterisk` (standaard) of `Tag`. Zie Afhandeling van grof taalgebruik voor meer informatie over manieren om grof taalgebruik te behandelen.
includeAlignment	Optionele parameter. Hiermee geeft u op of uitlijningsprojectie van brontekst naar vertaalde tekst moet worden opgenomen. Mogelijke waarden zijn: `true` of `false` (standaard).
includeSentenceLength	Optionele parameter. Hiermee geeft u op of zingrenzen moeten worden opgenomen voor de invoertekst en de vertaalde tekst. Mogelijke waarden zijn: `true` of `false` (standaard).
suggestedFrom	Optionele parameter. Hiermee geeft u een terugvaltaal op als de taal van de invoertekst niet kan worden geïdentificeerd. Taal autodetection wordt toegepast wanneer de `from` parameter wordt weggelaten. Als de detectie mislukt, wordt ervan uitgegaan dat de `suggestedFrom` taal wordt gebruikt.
fromScript	Optionele parameter. Hiermee geeft u het script van de invoertekst.
toScript	Optionele parameter. Hiermee geeft u het script van de vertaalde tekst.
allowFallback	Optionele parameter. Hiermee geeft u op dat de service mag terugvallen op een algemeen systeem wanneer er geen aangepast systeem bestaat. Mogelijke waarden zijn: `true` (standaard) of `false`. `allowFallback=false` geeft aan dat de vertaling alleen systemen mag gebruiken die zijn getraind voor de `category` opgegeven door de aanvraag. Als voor een vertaling van taal X naar taal Y een draaitaal E is vereist, moeten alle systemen in de keten (X → E en E → Y) aangepast zijn en dezelfde categorie hebben. Als er geen systeem met de specifieke categorie wordt gevonden, retourneert de aanvraag een statuscode van 400. `allowFallback=true` geeft aan dat de service mag terugvallen op een algemeen systeem wanneer er geen aangepast systeem bestaat.

Aanvraagheaders zijn onder andere:

Kopteksten	Beschrijving
Verificatieheaders	Vereiste aanvraagheader. Zie Beschikbare opties voor verificatie.
Inhoudstype	Vereiste aanvraagheader. Hiermee geeft u het inhoudstype van de payload op. De geaccepteerde waarde is `application/json; charset=UTF-8`.
Content-Length	Optioneel. De lengte van de aanvraagtekst.
X-ClientTraceId	Optioneel. Een door de client gegenereerde GUID om de aanvraag op unieke wijze te identificeren. U kunt deze header weglaten als u de tracerings-id in de queryreeks opneemt middels een queryparameter met de naam `ClientTraceId`.

Aanvraagtekst

De hoofdtekst van de aanvraag is een JSON-matrix. Elk matrixelement is een JSON-object met een tekenreekseigenschap met de naam Text, die de tekenreeks vertegenwoordigt die moet worden vertaald.

[
    {"Text":"I would really like to drive your car around the block a few times."}
]

Zie Aanvraaglimieten voor informatie over teken- en matrixlimieten.

Hoofdtekst van de reactie

Een geslaagd antwoord is een JSON-matrix met één resultaat voor elke tekenreeks in de invoermatrix. Een resultaatobject bevat de volgende eigenschappen:

detectedLanguage: Een object dat de gedetecteerde taal beschrijft via de volgende eigenschappen:
- language: Een tekenreeks die de code van de gedetecteerde taal vertegenwoordigt.
- score: Een float-waarde die het vertrouwen in het resultaat aangeeft. De score ligt tussen nul en één en een lage score geeft een lage betrouwbaarheid aan.
De detectedLanguage eigenschap is alleen aanwezig in het resultaatobject wanneer automatisch bepalen van taal wordt aangevraagd.
translations: Een matrix met vertaalresultaten. De grootte van de matrix komt overeen met het aantal doeltalen dat is opgegeven via de to queryparameter. Elk element in de matrix omvat:
- to: Een tekenreeks die de taalcode van de doeltaal vertegenwoordigt.
- text: Een tekenreeks die de vertaalde tekst geeft.
- transliteration: Een object dat de vertaalde tekst aangeeft in het script dat is opgegeven door de toScript parameter.
  - script: Een tekenreeks die het doelscript opgeeft.
  - text: Een tekenreeks die de vertaalde tekst in het doelscript geeft.
  Het transliteration object is niet opgenomen als transliteratie niet plaatsvindt.
  - alignment: Een object met één tekenreekseigenschap genaamd proj, waarmee invoertekst wordt toegewezen aan vertaalde tekst. De uitlijningsgegevens worden alleen verstrekt wanneer de aanvraagparameter includeAlignment is true. Uitlijning wordt geretourneerd als tekenreekswaarde van de volgende indeling: [[SourceTextStartIndex]:[SourceTextEndIndex]–[TgtTextStartIndex]:[TgtTextEndIndex]]. De dubbele punt scheidt de begin- en eindindex, het streepje scheidt de talen en de spatie scheidt de woorden. Eén woord kan worden uitgelijnd met nul, één of meerdere woorden in de andere taal en de uitgelijnde woorden kunnen niet-aaneengesloten zijn. Als er geen uitlijningsgegevens beschikbaar zijn, is het uitlijningselement leeg. Zie Uitlijningsgegevens verkrijgen voor een voorbeeld en beperkingen.
- sentLen: Een object dat zinsgrenzen retourneert in de in- en uitvoerteksten.
  - srcSentLen: Een matrix met gehele getallen die de lengte van de zinnen in de invoertekst aangeeft. De lengte van de matrix is het aantal zinnen en de waarden zijn de lengte van elke zin.
  - transSentLen: Een matrix met gehele getallen die de lengte van de zinnen in de vertaalde tekst aangeeft. De lengte van de matrix is het aantal zinnen en de waarden zijn de lengte van elke zin.
  Zingrenzen worden alleen opgenomen wanneer de aanvraagparameter includeSentenceLength is true.
sourceText: Een object met één tekenreekseigenschap met de naam text, die de invoertekst in het standaardscript van de brontaal geeft. sourceText eigenschap is alleen aanwezig wanneer de invoer wordt uitgedrukt in een script dat niet het gebruikelijke script voor de taal is. Als de invoer bijvoorbeeld Arabisch is geschreven in het Latijnse script, sourceText.text dan zou dezelfde Arabische tekst zijn geconverteerd naar het Arabische script.

Voorbeelden van JSON-antwoorden vindt u in de sectie voorbeelden .

Responsheaders

Kopteksten	Beschrijving
X-requestid	Waarde die door de service wordt gegenereerd om de aanvraag te identificeren die wordt gebruikt voor het oplossen van problemen.
X-mt-system	Hiermee geeft u het systeemtype op dat is gebruikt voor vertaling voor elke 'to'-taal die is aangevraagd voor vertaling. De waarde is een door komma's gescheiden lijst met tekenreeksen. Elke tekenreeks geeft een type aan: Aangepast - Aanvraag bevat een aangepast systeem en ten minste één aangepast systeem is gebruikt tijdens de vertaling. Team - Alle andere aanvragen
X-gebruik naar gebruik	Hiermee geeft u het verbruik op (het aantal tekens waarvoor de gebruiker in rekening wordt gebracht) voor de vertaaltaakaanvraag. Als het woord 'Hallo' bijvoorbeeld wordt vertaald van het Engels (en) naar het Frans (fr), retourneert dit veld de waarde `5`.

Antwoordstatuscodes

Hier volgen de mogelijke HTTP-statuscodes die een aanvraag retourneert.

Statuscode	Beschrijving
200	Geslaagd.
400	Een van de queryparameters ontbreekt of is ongeldig. Corrigeer aanvraagparameters voordat u het opnieuw probeert.
401	De aanvraag kan niet worden geverifieerd. Controleer of referenties zijn opgegeven en geldig zijn.
403	De aanvraag is niet geautoriseerd. Controleer het foutbericht met details. Deze statuscode geeft vaak aan dat u alle gratis vertalingen hebt gebruikt die zijn geleverd met een proefabonnement.
408	De aanvraag kan niet worden uitgevoerd omdat er een resource ontbreekt. Controleer het foutbericht met details. Wanneer de aanvraag een aangepaste categorie bevat, geeft deze statuscode vaak aan dat het aangepaste vertaalsysteem nog niet beschikbaar is om aanvragen te verwerken. De aanvraag moet opnieuw worden geprobeerd na een wachttijd (bijvoorbeeld 1 minuut).
429	De server heeft de aanvraag geweigerd omdat de client de aanvraaglimieten heeft overschreden.
500	Er is een onverwachte fout opgetreden. Als de fout zich blijft voordoen, meldt u deze met: datum en tijd van de fout, aanvraag-id van antwoordheader X-RequestId en client-id van aanvraagheader X-ClientTraceId.
503	Server is tijdelijk niet beschikbaar. Probeer de aanvraag opnieuw. Als de fout zich blijft voordoen, meldt u deze met: datum en tijd van de fout, aanvraag-id van antwoordheader X-RequestId en client-id van aanvraagheader X-ClientTraceId.

Als er een fout optreedt, retourneert de aanvraag een JSON-foutreactie. De foutcode is een getal van 6 cijfers dat de HTTP-statuscode van 3 cijfers combineert, gevolgd door een 3-cijferig getal om de fout verder te categoriseren. Algemene foutcodes vindt u op de naslagpagina van v3 Translator.

Voorbeelden

Eén invoer vertalen

In dit voorbeeld ziet u hoe u één zin van het Engels naar vereenvoudigd Chinees vertaalt.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Hello, what is your name?'}]"

De hoofdtekst van het antwoord is:

[
    {
        "translations":[
            {"text":"你好, 你叫什么名字？","to":"zh-Hans"}
        ]
    }
]

De translations matrix bevat één element, waarmee de vertaling van het ene stuk tekst in de invoer wordt gegeven.

Eén invoer vertalen met taal autodetection

In dit voorbeeld ziet u hoe u één zin van het Engels naar vereenvoudigd Chinees vertaalt. De aanvraag geeft de invoertaal niet op. Automatische verwijdering van de brontaal wordt in plaats daarvan gebruikt.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Hello, what is your name?'}]"

De hoofdtekst van het antwoord is:

[
    {
        "detectedLanguage": {"language": "en", "score": 1.0},
        "translations":[
            {"text": "你好, 你叫什么名字？", "to": "zh-Hans"}
        ]
    }
]

Het antwoord is vergelijkbaar met het antwoord uit het vorige voorbeeld. Omdat automatisch bepalen van de taal is aangevraagd, bevat het antwoord ook informatie over de taal die is gedetecteerd voor de invoertekst. De taal autodetection werkt beter met langere invoertekst.

Vertalen met transliteratie

Laten we het vorige voorbeeld uitbreiden door transliteratie toe te voegen. De volgende aanvraag vraagt om een Chinese vertaling die in het Latijnse schrift is geschreven.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&to=zh-Hans&toScript=Latn" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Hello, what is your name?'}]"

De hoofdtekst van het antwoord is:

[
    {
        "detectedLanguage":{"language":"en","score":1.0},
        "translations":[
            {
                "text":"你好, 你叫什么名字？",
                "transliteration":{"script":"Latn", "text":"nǐ hǎo , nǐ jiào shén me míng zì ？"},
                "to":"zh-Hans"
            }
        ]
    }
]

Het vertaalresultaat bevat nu een transliteration eigenschap die de vertaalde tekst met Latijnse tekens geeft.

Meerdere stukken tekst vertalen

Het vertalen van meerdere tekenreeksen tegelijk is een kwestie van het opgeven van een matrix met tekenreeksen in de hoofdtekst van de aanvraag.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Hello, what is your name?'}, {'Text':'I am fine, thank you.'}]"

Het antwoord bevat de vertaling van alle stukken tekst in exact dezelfde volgorde als in de aanvraag. De hoofdtekst van het antwoord is:

[
    {
        "translations":[
            {"text":"你好, 你叫什么名字？","to":"zh-Hans"}
        ]
    },
    {
        "translations":[
            {"text":"我很好，谢谢你。","to":"zh-Hans"}
        ]
    }
]

Vertalen naar meerdere talen

In dit voorbeeld ziet u hoe u dezelfde invoer in meerdere talen in één aanvraag kunt vertalen.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=zh-Hans&to=de" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Hello, what is your name?'}]"

De hoofdtekst van het antwoord is:

[
    {
        "translations":[
            {"text":"你好, 你叫什么名字？","to":"zh-Hans"},
            {"text":"Hallo, was ist dein Name?","to":"de"}
        ]
    }
]

Grof taalgebruik afhandelen

Normaal gesproken behoudt de Translator-service grof taalgebruik dat aanwezig is in de bron in de vertaling. De mate van grof taalgebruik en de context die woorden scheldwoorden maakt verschillen tussen culturen, en als gevolg hiervan kan de mate van grof taalgebruik in de doeltaal worden versterkt of verminderd.

Als u wilt voorkomen dat u grof taalgebruik in de vertaling krijgt, ongeacht de aanwezigheid van grof taalgebruik in de brontekst, kunt u de filteroptie voor grof taalgebruik gebruiken. Met de optie kunt u kiezen of u grof taalgebruik wilt verwijderen, gemarkeerd met de juiste tags (zodat u uw eigen naverwerking kunt toevoegen) of zonder actie te ondernemen. De geaccepteerde waarden ProfanityAction zijn Deleted, Markeden NoAction (standaard).

Geaccepteerde waarde ProfanityAction	Waarde van ProfanityMarker	Actie	Voorbeeld: Bron - Spaans	Voorbeeld: Doel - Engels
NoAction		Standaard. Hetzelfde als het niet instellen van de optie. Scheldwoorden gaan van bron naar doel.	`Que coche de`<insert-profane-woord>	Wat een <insert-profane-woord> auto
Gemarkeerd	Sterretje	Sterretjes vervangen scheldwoorden (standaard).	`Que coche de`<insert-profane-woord>	Wat een *** auto
Gemarkeerd	Tag	Scheldwoorden worden omgeven door XML-tags <scheldwoorden>...</grof taalgebruik>.	`Que coche de`<insert-profane-woord>	Wat een <scheldwoord><invoegen/><grof> taalgebruik auto
Verwijderd		Scheldwoorden worden uit de uitvoer verwijderd zonder vervanging.	`Que coche de`<insert-profane-woord>	Wat een auto

In de bovenstaande voorbeelden <is insert-profane-woord> een tijdelijke aanduiding voor scheldwoorden.

Voorbeeld:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=de&profanityAction=Marked" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'This is an <expletive> good idea.'}]"

Deze aanvraag retourneert:

[
    {
        "translations":[
            {"text":"Das ist eine *** gute Idee.","to":"de"}
        ]
    }
]

Vergelijken met:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=de&profanityAction=Marked&profanityMarker=Tag" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'This is an <expletive> good idea.'}]"

Deze laatste aanvraag retourneert:

[
    {
        "translations":[
            {"text":"Das ist eine <profanity>verdammt</profanity> gute Idee.","to":"de"}
        ]
    }
]

Inhoud vertalen die markeringen bevat

Het is gebruikelijk om inhoud te vertalen die markeringen bevat, zoals inhoud van een HTML-pagina of inhoud uit een XML-document. Voeg de queryparameter textType=html toe bij het vertalen van inhoud met tags. Daarnaast is het soms handig om specifieke inhoud uit te sluiten van vertaling. U kunt het kenmerk class=notranslate gebruiken om inhoud op te geven die in de oorspronkelijke taal moet blijven. In het volgende voorbeeld wordt de inhoud in het eerste div element niet vertaald, terwijl de inhoud in het tweede div element wordt vertaald.

<div class="notranslate">This will not be translated.</div>
<div>This will be translated. </div>

Hier volgt een voorbeeldaanvraag ter illustratie.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=zh-Hans&textType=html" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'<div class=\"notranslate\">This will not be translated.</div><div>This will be translated.</div>'}]"

Het antwoord is:

[
    {
        "translations":[
            {"text":"<div class=\"notranslate\">This will not be translated.</div><div>这将被翻译。</div>","to":"zh-Hans"}
        ]
    }
]

Uitlijningsgegevens verkrijgen

Uitlijning wordt geretourneerd als een tekenreekswaarde van deze volgende notatie voor elk woord van de bron. De informatie voor elk woord wordt gescheiden door een spatie, inclusief voor de niet-spatie gescheiden talen (scripts) zoals Chinees:

[[SourceTextStartIndex]:[SourceTextEndIndex]–[TgtTextStartIndex]:[TgtTextEndIndex]] *

Voorbeeld uitlijningstekenreeks: "0:0-7:10 1:2-11:20 3:4-0:3 3:4-4:6 5:5-21:21".

Oftewel, de dubbele punt scheidt de begin- en eindindex, het streepje scheidt de talen en de spatie scheidt de woorden. Eén woord kan worden uitgelijnd met nul, één of meerdere woorden in de andere taal en de uitgelijnde woorden kunnen niet-aaneengesloten zijn. Als er geen uitlijningsgegevens beschikbaar zijn, is het uitlijningselement leeg. De methode retourneert in dit geval geen fout.

Als u uitlijningsgegevens wilt ontvangen, geeft u includeAlignment=true de querytekenreeks op.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=fr&includeAlignment=true" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'The answer lies in machine translation.'}]"

Het antwoord is:

[
    {
        "translations":[
            {
                "text":"La réponse se trouve dans la traduction automatique.",
                "to":"fr",
                "alignment":{"proj":"0:2-0:1 4:9-3:9 11:14-11:19 16:17-21:24 19:25-40:50 27:37-29:38 38:38-51:51"}
            }
        ]
    }
]

De uitlijningsgegevens beginnen met 0:2-0:1, wat betekent dat de eerste drie tekens in de brontekst (The) zijn toegewezen aan de eerste twee tekens in de vertaalde tekst (La).

Beperkingen

Het verkrijgen van uitlijningsgegevens is een experimentele functie die we hebben ingeschakeld voor het maken van prototypen van onderzoek en ervaringen met mogelijke woordgroepentoewijzingen. Hier volgen enkele van de belangrijke beperkingen waarbij uitlijningen niet worden ondersteund:

Uitlijning is niet beschikbaar voor tekst in HTML-indeling, zoals textType=html
Uitlijning wordt alleen geretourneerd voor een subset van de taalparen:
- Engels naar/van een andere taal, behalve Chinees Traditioneel, Kantonees (traditioneel) of Servisch (Cyrillisch)
- van Japans naar Koreaans of van Koreaans naar Japans
- van Japans naar Vereenvoudigd Chinees en Vereenvoudigd Chinees naar Japans
- van Vereenvoudigd Chinees naar Traditioneel Chinees en Traditioneel Chinees naar Vereenvoudigd Chinees
U kunt de zin niet uitlijnen als de zin een canned-vertaling is. Voorbeeld van een canned-vertaling is This is a test, I love youen andere hoge frequentiezinnen
Uitlijning is niet beschikbaar wanneer u een van de methoden toepast om vertaling te voorkomen, zoals hier wordt beschreven

Zinsgrenzen verkrijgen

Als u informatie wilt ontvangen over de lengte van de zin in de brontekst en vertaalde tekst, geeft u includeSentenceLength=true de querytekenreeks op.

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=fr&includeSentenceLength=true" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'The answer lies in machine translation. The best machine translation technology cannot always provide translations tailored to a site or users like a human. Simply copy and paste a code snippet anywhere.'}]"

Het antwoord is:

[
    {
        "translations":[
            {
                "text":"La réponse se trouve dans la traduction automatique. La meilleure technologie de traduction automatique ne peut pas toujours fournir des traductions adaptées à un site ou des utilisateurs comme un être humain. Il suffit de copier et coller un extrait de code n'importe où.",
                "to":"fr",
                "sentLen":{"srcSentLen":[40,117,46],"transSentLen":[53,157,62]}
            }
        ]
    }
]

Vertalen met dynamische woordenlijst

Als u al weet welke vertaling u wilt toepassen op een woord of woordgroep, dan kunt u deze als markering opgeven in de aanvraag. De dynamische woordenlijst is alleen veilig voor zelfstandige naamwoorden, zoals persoonlijke namen en productnamen. Opmerking: de functie dynamische woordenlijst is hoofdlettergevoelig.

De op te geven opmaak maakt gebruik van de volgende syntaxis.

<mstrans:dictionary translation="translation of phrase">phrase</mstrans:dictionary>

Denk bijvoorbeeld aan de Engelse zin 'Het woord wordomatic is een woordenlijstvermelding'. Als u het woordmatisch in de vertaling wilt behouden, verzendt u de aanvraag:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=de" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'The word <mstrans:dictionary translation=\"wordomatic\">wordomatic</mstrans:dictionary> is a dictionary entry.'}]"

Het resultaat is:

[
    {
        "translations":[
            {"text":"Das Wort \"wordomatic\" ist ein Wörterbucheintrag.","to":"de"}
        ]
    }
]

Deze functie voor dynamische woordenlijst werkt op dezelfde manier met textType=text of met textType=html. De functie moet spaarzaam worden gebruikt. De juiste en veel betere manier om vertaling aan te passen is door Custom Translator te gebruiken. Custom Translator maakt volledig gebruik van de context- en statistische waarschijnlijkheden. Als u trainingsgegevens kunt maken waarin uw werk of woordgroep in context wordt weergegeven, krijgt u betere resultaten. Meer informatie over Custom Translator.

Volgende stappen

De snelstartgids translator uitproberen

Delen via

Translator 3.0: Vertalen

Aanvraag-URL

Aanvraagparameters

Vereiste parameters

Optionele parameters

Aanvraagtekst

Hoofdtekst van de reactie

Responsheaders

Antwoordstatuscodes

Voorbeelden

Eén invoer vertalen

Eén invoer vertalen met taal autodetection

Vertalen met transliteratie

Meerdere stukken tekst vertalen

Vertalen naar meerdere talen

Grof taalgebruik afhandelen

Inhoud vertalen die markeringen bevat

Uitlijningsgegevens verkrijgen

Beperkingen

Zinsgrenzen verkrijgen

Vertalen met dynamische woordenlijst

Volgende stappen

Feedback

Aanvullende resources