Delen via

SDK's voor documentomzetting

  • Artikel

Documentomzetting is een cloudgebaseerde REST API-functie van de Azure AI Translator-service. De API voor documentomzetting maakt snelle en nauwkeurige bron-naar-doel volledige documentvertalingen mogelijk, asynchroon, in ondersteunde talen en verschillende bestandsindelingen. De Sdk (Document Translation Software Development Kit) is een set bibliotheken en hulpprogramma's waarmee u de REST API-mogelijkheden voor documentvertaling eenvoudig kunt integreren in uw toepassingen.

Ondersteunde talen

Document Translation SDK ondersteunt de volgende programmeertalen:

Taal → SDK-versie Pakket Clientbibliotheek Ondersteunde API-versie
🆕 .NET/C# → 2.0.0-beta.1 NuGet Azure-SDK voor .NET Documentomzetting api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi Azure-SDK voor Python Documentomzetting api-version=2024-05-01

Changelog- en releasegeschiedenis

Deze sectie bevat een beschrijving op basis van een versie van de functie Documentvertaling en functiereleases, wijzigingen, updates en verbeteringen.

Documentomzettings-SDK gebruiken in uw toepassingen

De Document Translation SDK maakt het gebruik en beheer van de vertaalservice in uw toepassing mogelijk. De SDK bouwt voort op de onderliggende REST API's voor documentomzetting voor gebruik binnen uw programmeertaalparadigma. Kies de gewenste programmeertaal:

1. Installeer de SDK-clientbibliotheek

dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.1

Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1

2. Importeer de SDK-clientbibliotheek in uw toepassing

using System;
using Azure.Core;
using Azure.AI.Translation.Document;

3. De client verifiëren

Maak een exemplaar van het DocumentTranslationClient object om te communiceren met de Document Translation SDK en roep vervolgens methoden aan voor dat clientobject om met de service te communiceren. Dit DocumentTranslationClient is de primaire interface voor het gebruik van de clientbibliotheek voor documentomzetting. Het biedt zowel synchrone als asynchrone methoden voor het uitvoeren van bewerkingen.

Asynchrone batchomzetting

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

Synchrone vertaling van één document

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

4. Uw toepassing bouwen

Asynchrone batchomzetting

Batchinterfaces voor documentvertaling vereisen de volgende invoer:

  1. Upload uw bestanden naar een Azure Blob Storage-broncontainer (sourceUri).
  2. Geef een doelcontainer op waarin de vertaalde documenten kunnen worden geschreven (targetUri).
  3. Neem de doeltaalcode (targetLanguage) op.

Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";

DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)

Synchrone vertaling van één document

Vertaling van één document

Help-opties

De Microsoft Q&A en Stack Overflow-forums zijn beschikbaar voor de ontwikkelaarscommunity om vragen te stellen en te beantwoorden over Azure Text Translation en andere services. Microsoft bewaakt de forums en beantwoordt vragen die de community nog moet beantwoorden.

Tip

Om ervoor te zorgen dat we uw Q&A-vraag van Microsoft zien, tagt u deze met microsoft-translator. Om ervoor te zorgen dat we uw Stack Overflow-vraag zien, tagt u deze met Azure AI Translator.

Volgende stappen

Naslaginformatie over documentomzettings-SDK voor documentomzetting v1.1