migratie van Vertalen 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.
Het Microsoft Vertalen-team heeft versie 3 (V3) van de Vertalen uitgebracht. Deze release bevat nieuwe functies, afgeschafte methoden en een nieuwe indeling voor het verzenden naar en ontvangen van gegevens van de Microsoft Vertalen-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 er geen tekst wordt verzonden naar de V3-API, wordt opgeslagen door Microsoft.
- JSON - XML wordt vervangen door 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 'naar'-talen voor vertaling in één aanvraag. Een enkele aanvraag kan bijvoorbeeld 'van' Engels en 'naar' Duits, Spaans en Japans of een andere groep talen zijn.
- Tweetalige woordenlijst: er is een tweetalige woordenlijstmethode toegevoegd aan de API. Deze methode bevat opzoekacties en voorbeelden.
- Transliteratie: er is 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 'talen'-methode levert taalinformatie, in JSON-indeling, voor gebruik met de methoden 'vertalen', 'woordenlijst' en 'transliterate'.
- Nieuw bij Vertalen - Nieuwe mogelijkheden zijn toegevoegd aan de methode 'vertalen' ter ondersteuning van een aantal van de functies in de V2-API als afzonderlijke methoden. Een voorbeeld is TranslateArray.
- Methode Uitspreken: tekst-naar-spraakfunctionaliteit wordt niet meer ondersteund in de Microsoft Vertalen. 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 Vertalen Translation V2 heeft gegevens in XML-indeling geaccepteerd en geretourneerd. 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 u voor V2 gebruikt, 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, zodat u gemakkelijker nieuwe versies kunt vrijgeven terwijl u nog steeds migreert van V2-XML naar V3-JSON.
Prijsmodel
Microsoft Vertalen 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 worden ingediend en 5 talen die worden aangevraagd, zijn 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 Vertalen Hub wordt op 17 mei 2019 buiten gebruik gesteld. Bekijk belangrijke migratie-informatie en -datums.
Microsoft Vertalen V3 maakt standaard gebruik van neurale machinevertaling. Daarom kan deze niet worden gebruikt met de Microsoft Vertalen Hub. De Vertalen Hub ondersteunt alleen verouderde statistische machinevertaling. Aanpassing voor neurale vertaling is nu beschikbaar met behulp van de aangepaste Vertalen. 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, spraak, tech, generalnn).
| Versie | Eindpunt | AVG-processorcompatibiliteit | Vertalen Hub gebruiken | Aangepaste Vertalen gebruiken (preview) |
|---|---|---|---|---|
| Vertalen versie 2 | api.microsofttranslator.com | Nr. | Ja | Nr. |
| Vertalen versie 3 | api.cognitive.microsofttranslator.com | Ja | No | Ja |
Vertalen 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 aangepaste Vertalen (preview), de nieuwe Vertalen NMT-aanpassingsfunctie.
- Het biedt geen toegang tot aangepaste vertaalsystemen die zijn gemaakt met behulp van de Microsoft Vertalen Hub.
U gebruikt versie 3 van de Vertalen als u het api.cognitive.microsofttranslator.com-eindpunt gebruikt.
Vertalen 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 Vertalen aanpassing.
- Biedt toegang tot aangepaste vertaalsystemen die zijn gemaakt met behulp van de Microsoft Vertalen Hub.
- U gebruikt versie 2 van de Vertalen als u het api.microsofttranslator.com-eindpunt gebruikt.
Er wordt geen versie van de Vertalen een record van uw vertalingen gemaakt. Uw vertalingen worden nooit met iemand gedeeld. Meer informatie over de Vertalen webpagina Zonder tracering.
Koppelingen
- Privacybeleid van Microsoft
- Juridische informatie over Microsoft Azure
- Voorwaarden voor onlineservices