다음을 통해 공유

문서 번역 SDK

  • 아티클

문서 번역은 Azure AI 번역기 서비스의 클라우드 기반 REST API 기능입니다. 문서 번역 API를 사용하면 지원되는 언어와 다양한 파일 형식으로 빠르고 정확한 원본-대상 전체 문서 번역을 비동기적으로 수행할 수 있습니다. 문서 번역 SDK(소프트웨어 개발 키트)는 문서 번역 REST API 기능을 애플리케이션에 쉽게 통합할 수 있는 라이브러리 및 도구 집합입니다.

지원되는 언어

문서 번역 SDK는 다음 프로그래밍 언어를 지원합니다.

언어 → SDK 버전 Package(패키지) 클라이언트 라이브러리 지원되는 API 버전
🆕 .NET/C# → 2.0.0-beta.1 NuGet .NET용 Azure SDK 문서 번역 api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi Python용 Azure SDK 문서 번역 api-version=2024-05-01

변경 로그 및 릴리스 로그

이 섹션에서는 문서 번역 기능과 기능 릴리스, 변경 내용, 업데이트 및 개선 사항에 대한 버전 기반 설명을 제공합니다.

애플리케이션에서 문서 번역 SDK 사용

문서 번역 SDK를 사용하면 애플리케이션에서 번역 서비스를 사용하고 관리할 수 있습니다. SDK는 프로그래밍 언어 패러다임 내에서 사용할 수 있도록 기본 문서 번역 REST API를 기반으로 빌드됩니다. 선호 프로그래밍 언어 선택:

1. SDK 클라이언트 라이브러리 설치

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. SDK 클라이언트 라이브러리를 애플리케이션으로 가져오기

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

3. 클라이언트 인증

문서 번역 SDK와 상호 작용할 DocumentTranslationClient 개체의 인스턴스를 만든 다음 해당 클라이언트 개체에 대한 메서드를 호출하여 서비스와 상호 작용합니다. DocumentTranslationClient는 문서 번역 클라이언트 라이브러리를 사용하기 위한 기본 인터페이스입니다. 작업을 수행하기 위한 동기식 및 비동기식 방법을 모두 제공합니다.

비동기식 일괄 처리 번역

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));

동기 단일 문서 번역

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. 애플리케이션 빌드

비동기식 일괄 처리 번역

문서 번역 일괄 처리 인터페이스에는 다음 입력이 필요합니다.

  1. Azure Blob Storage 원본 컨테이너(sourceUri)에 파일을 업로드합니다.
  2. 번역된 문서를 작성할 수 있는 대상 컨테이너(targetUri)를 제공합니다.
  3. 대상 언어 코드(targetLanguage)를 포함합니다.

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)

동기 단일 문서 번역

단일 문서 번역

도움말 옵션

Developer Community에서는 Microsoft Q&A 및 Stack Overflow 포럼을 통해 Azure Text Translation 및 기타 서비스에 대해 질문하고 답변할 수 있습니다. Microsoft는 포럼을 모니터링하고 커뮤니티에서 아직 답변하지 않은 질문에 답변합니다.

팁

사용자의 Microsoft Q&A 질문이 표시되도록 하려면 해당 질문에 microsoft-translator 태그를 지정합니다. Stack Overflow 질문이 표시되는지 확인하려면 해당 질문에 Azure AI Translator 태그를 지정합니다.

다음 단계

문서 번역 SDK 빠른 시작 문서 번역 v1.1 REST API 참조