Azure 텍스트 번역 SDK

아티클
09/29/2024

Azure Text Translation은 Azure AI Translator 서비스의 클라우드 기반 REST API 기능입니다. Text Translation API를 사용하면 원본-대상 텍스트 번역을 실시간으로 빠르고 정확하게 사용할 수 있습니다. Text Translation SDK(소프트웨어 개발 키트)는 Text Translation REST API 기능을 애플리케이션에 쉽게 통합할 수 있는 라이브러리 및 도구 세트입니다. Text Translation SDK는 C#/.NET, Java, JavaScript, Python의 프로그래밍 플랫폼에서 사용할 수 있습니다.

지원되는 언어

Text Translation SDK는 프로그래밍 언어와 플랫폼을 지원합니다.

언어 → SDK 버전	Package(패키지)	클라이언트 라이브러리	지원되는 API 버전
.NET/C# → 1.0.0	NuGet	.NET용 Azure SDK	Translator v3.0
Java✱ → 1.0.0	Maven 리포지토리	Java용 Azure SDK	Translator v3.0
JavaScript → 1.0.0	npm	JavaScript용 Azure SDK	Translator v3.0
Python → 1.0.1	PyPi	Python용 Azure SDK	Translator v3.0

✱ Java용 Azure Text Translation SDK는 Windows, Linux, macOS 플랫폼에서 테스트 및 지원됩니다. 다른 플랫폼에서는 테스트되지 않으며 Android 배포를 지원하지 않습니다.

변경 로그 및 릴리스 로그

이 섹션에서는 텍스트 번역 기능 및 기능 릴리스, 변경, 업데이트 및 향상된 기능에 대한 버전 기반 설명을 제공합니다.

Translator Text SDK 2024년 5월 GA 릴리스

이 릴리스에는 다음과 같은 업데이트 사항이 포함되어 있습니다.

Translator Text SDK 2023년 4월 미리 보기 릴리스

이 릴리스에는 다음과 같은 업데이트 사항이 포함되어 있습니다.

애플리케이션에서 Text Translation SDK 사용

Text Translation SDK를 사용하면 애플리케이션에서 텍스트 번역 서비스를 사용하고 관리할 수 있습니다. SDK는 프로그래밍 언어 패러다임 내에서 이런 API를 쉽게 사용할 수 있도록 기본 Text Translation REST API를 기반으로 합니다. 선호하는 프로그래밍 언어에 Text Translation SDK를 사용하는 방법은 다음과 같습니다.

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

dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1

Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-translation-text</artifactId>
    <version>1.0.0-beta.1</version>
</dependency>

implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

pip install azure-ai-translation-text==1.0.0b1

2. SDK 클라이언트 라이브러리를 애플리케이션으로 가져오기

using Azure;
using Azure.AI.Translation.Text;

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;

const {TextTranslationClient } = require("@azure-rest/ai-translation-text").default;

from azure.core.credentials import AzureKeyCredential
from azure.ai.translation.text import TextTranslationClient

3. 클라이언트 인증

클라이언트 라이브러리를 사용하는 Translator 서비스와의 상호 작용은 TextTranslationClient 클래스의 인스턴스를 만드는 것으로 시작합니다. 클라이언트 개체를 인스턴스화하려면 API 키와 지역이 필요합니다. Text Translation API 키는 Azure Portal에서 찾을 수 있습니다.

Azure Portal에서 키 및 엔드포인트 위치의 스크린샷

글로벌 엔드포인트 사용(기본값)

string key = "<your-key>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);

지역 엔드포인트 사용


Uri endpoint = new("<your-endpoint>");
string key = "<your-key>";
string region = "<region>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential, region);

글로벌 엔드포인트 사용(기본값)


String apiKey = "<your-key>";
AzureKeyCredential credential = new AzureKeyCredential(apiKey);

TextTranslationClient client = new TextTranslationClientBuilder()
            .credential(credential)
            .buildClient();

지역 엔드포인트 사용

String apiKey = "<your-key>";
String endpoint = "<your-endpoint>";
String region = "<region>";

AzureKeyCredential credential = new AzureKeyCredential(apiKey);

TextTranslationClient client = new TextTranslationClientBuilder()
.credential(credential)
.region(region)
.endpoint(endpoint)
.buildClient();


const TextTranslationClient = require("@azure-rest/ai-translation-text").default,

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";


from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"


credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

4. 애플리케이션 빌드

Text Translation SDK와 상호 작용할 클라이언트 개체를 만든 다음, 해당 클라이언트 개체에 대한 메서드를 호출하여 서비스와 상호 작용합니다. SDK는 동기 메서드와 비동기 메서드를 모두 제공합니다. 더 많은 인사이트를 얻으려면 .NET/C#용 Text Translation 샘플 리포지토리를 참조하세요.

도움말 옵션

Microsoft Q&A 및 Stack Overflow 포럼에서는 개발자 커뮤니티가 Azure Text Translation 및 기타 서비스에 대한 질문을 하고 답변할 수 있습니다. Microsoft는 포럼을 모니터링하고 커뮤니티에서 아직 답변하지 않은 질문에 답변합니다. 사용자의 질문을 확인하려면 azure-text-translation 태그를 지정합니다.

다음 단계

Text Translation 빠른 시작

Text Translation v3.0 참조 가이드

다음을 통해 공유