Migratie van Translator V2 naar V3
Notitie
V2 is afgeschaft op 30 april 2018. Migreer uw toepassingen naar V3 om te profiteren van nieuwe functionaliteit die exclusief beschikbaar is in V3. V2 is op 24 mei 2021 buiten gebruik gesteld.
Versie 3 (V3) van de Translator-service is algemeen beschikbaar. De release bevat nieuwe functies, afgeschafte methoden en een nieuwe indeling voor het verzenden naar en ontvangen van gegevens van de Microsoft Translator-service. Dit document bevat informatie over het wijzigen van toepassingen voor het gebruik van V3.
Het einde van dit document bevat nuttige koppelingen voor meer informatie.
Overzicht van functies
- Geen tracering- In V3 No-Trace is van toepassing op alle prijscategorieën in Azure Portal. Deze functie betekent dat de service geen tekst opslaat die is verzonden naar de V3-API.
- JSON - XML vervangt JSON. Alle gegevens die naar de service worden verzonden en ontvangen van de service, hebben de JSON-indeling.
- Meerdere doeltalen in één aanvraag: de vertaalmethode accepteert meerdere
to
talen voor vertaling in één aanvraag. Een enkele aanvraag kan bijvoorbeeld Engels ento
Duits, Spaans en Japans of een andere groep talen zijnfrom
. - Tweetalige woordenlijst: er wordt een tweetalige woordenlijstmethode toegevoegd aan de API. Deze methode omvat
lookup
enexamples
. - Transliteratie: er wordt een transliteratiemethode toegevoegd aan de API. Met deze methode worden woorden en zinnen in het ene script geconverteerd naar een ander script. Bijvoorbeeld Arabisch naar Latijns.
- Talen: een nieuwe
languages
methode levert taalinformatie, in JSON-indeling, voor gebruik met detranslate
,dictionary
entransliterate
methoden. - Nieuw bij Vertalen - Nieuwe mogelijkheden worden toegevoegd aan de
translate
methode ter ondersteuning van enkele van de functies in de V2-API als afzonderlijke methoden. Een voorbeeld is TranslateArray. - Spraakmethode: tekst-naar-spraakfunctionaliteit wordt niet meer ondersteund in Microsoft Translator. De functionaliteit tekst-naar-spraak is beschikbaar in Microsoft Speech Service.
De volgende lijst met V2- en V3-methoden identificeert de V3-methoden en API's die de functionaliteit bieden die bij V2 is geleverd.
Methode V2-API | Compatibiliteit met V3-API's |
---|---|
Translate |
Vertalen |
TranslateArray |
Vertalen |
GetLanguageNames |
Talen |
GetLanguagesForTranslate |
Talen |
GetLanguagesForSpeak |
Microsoft Speech Service |
Speak |
Microsoft Speech Service |
Detect |
Detecteren |
DetectArray |
Detecteren |
AddTranslation |
Functie wordt niet meer ondersteund |
AddTranslationArray |
Functie wordt niet meer ondersteund |
BreakSentences |
Onderbrekingen |
GetTranslations |
Functie wordt niet meer ondersteund |
GetTranslationsArray |
Functie wordt niet meer ondersteund |
Verplaatsen naar JSON-indeling
Microsoft Translator Translation V2 heeft gegevens geaccepteerd en geretourneerd in XML-indeling. In V3 hebben alle gegevens die zijn verzonden en ontvangen met behulp van de API de JSON-indeling. XML wordt niet meer geaccepteerd of geretourneerd in V3.
Deze wijziging is van invloed op verschillende aspecten van een toepassing die is geschreven voor de V2 Text Translation-API. Als voorbeeld: De Talen-API retourneert taalinformatie voor tekstomzetting, transliteratie en de twee woordenlijstmethoden. U kunt alle taalgegevens voor alle methoden in één aanroep aanvragen of ze afzonderlijk aanvragen.
Voor de taalmethode is geen verificatie vereist; door de volgende koppeling te selecteren, ziet u alle taalinformatie voor V3 in JSON:
Verificatiesleutel
De verificatiesleutel die wordt gebruikt voor V2 wordt geaccepteerd voor V3. U hoeft geen nieuw abonnement te krijgen. U kunt V2 en V3 in uw apps combineren tijdens de migratieperiode van het jaar, waardoor u gemakkelijker nieuwe versies kunt vrijgeven terwijl u migreert van V2-XML naar V3-JSON.
Prijsmodel
Microsoft Translator V3 wordt op dezelfde manier geprijsd als V2; per teken, inclusief spaties. De nieuwe functies in V3 brengen enkele wijzigingen aan in de tekens die worden geteld voor facturering.
V3-methode | Getelde tekens voor facturering |
---|---|
Languages |
Er worden geen tekens ingediend, geen geteld, geen kosten in rekening gebracht. |
Translate |
Aantal is gebaseerd op het aantal tekens dat wordt verzonden voor vertaling en in hoeveel talen de tekens worden vertaald. 50 tekens verzonden en 5 geteld als 50x5. |
Transliterate |
Het aantal tekens dat is verzonden voor transliteratie, wordt geteld. |
Dictionary lookup & example |
Het aantal tekens dat is verzonden voor opzoeken in woordenlijst en voorbeelden, wordt geteld. |
BreakSentence |
Geen kosten. |
Detect |
Geen kosten. |
V3-eindpunten
Globaal
- api.cognitive.microsofttranslator.com
V3 API-tekstvertalingenmethoden
Compatibiliteit en aanpassing
Notitie
De Microsoft Translator Hub wordt op 17 mei 2019 buiten gebruik gesteld. Bekijk belangrijke migratie-informatie en -datums.
Microsoft Translator V3 maakt standaard gebruik van neurale machinevertaling. Als zodanig kan het niet worden gebruikt met de Microsoft Translator Hub. Translator Hub ondersteunt alleen verouderde statistische machinevertaling. Aanpassing voor neurale vertaling is nu beschikbaar met behulp van Custom Translator. Meer informatie over het aanpassen van neurale machinevertaling
Neurale vertaling met de V3-tekst-API biedt geen ondersteuning voor het gebruik van standaardcategorieën (SMT
, speech
, tech
, ). generalnn
Versie | Eindpunt | AVG-processorcompatibiliteit | Translator Hub gebruiken | Custom Translator gebruiken (preview) |
---|---|---|---|---|
Translator versie 2 | api.microsofttranslator.com | Nr. | Ja | Nr. |
Translator versie 3 | api.cognitive.microsofttranslator.com | Ja | No | Ja |
Translator versie 3
- Het is algemeen beschikbaar en volledig ondersteund.
- Het voldoet aan de AVG als processor en voldoet aan alle ISO 20001- en 20018- en SOC 3-certificeringsvereisten.
- Hiermee kunt u de neurale netwerkomzettingssystemen aanroepen die u hebt aangepast met Custom Translator (Preview), de nieuwe functie voor het aanpassen van neurale machinevertaling (NMT).
- Het biedt geen toegang tot aangepaste vertaalsystemen die zijn gemaakt met behulp van de Microsoft Translator Hub.
U gebruikt versie 3 van translator als u het api.cognitive.microsofttranslator.com-eindpunt gebruikt.
Translator versie 2
- Voldoet niet aan alle ISO 20001.20018- en SOC 3-certificeringsvereisten.
- U kunt de neurale netwerkomzettingssystemen die u hebt aangepast niet aanroepen met de functie Translator-aanpassing.
- Biedt wel toegang tot aangepaste vertaalsystemen die zijn gemaakt met behulp van de Microsoft Translator Hub.
- Gebruikt het api.microsofttranslator.com-eindpunt.
Met geen enkele versie van Translator wordt een record van uw vertalingen gemaakt. Uw vertalingen worden nooit met iemand gedeeld. Meer informatie over de webpagina Translator No-Trace .
Koppelingen
- Privacybeleid van Microsoft
- Juridische informatie over Microsoft Azure
- Voorwaarden voor onlineservices
Volgende stappen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor