Azure 텍스트 번역이란?

아티클
09/04/2024

Azure 텍스트 번역은 인공신경망 기계 번역 기술을 사용하여 모든 지원되는 언어에서 실시간으로 빠르고 정확한 소스-대상 텍스트 번역을 가능하게 하는 번역기 서비스의 클라우드 기반 REST API 기능입니다. 이 개요에서는 텍스트 번역 REST API를 사용하여 애플리케이션 및 워크플로를 위한 지능형 솔루션을 구축하는 방법을 알아봅니다.

텍스트 번역 설명서에는 다음과 같은 문서 유형이 포함되어 있습니다.

빠른 시작. 서비스에 대한 요청을 수행하는 과정을 안내하는 시작 지침입니다.
방법 가이드. 더 구체적이거나 사용자 지정된 방식으로 서비스 액세스 및 사용 지침이 포함되어 있습니다.
참조 문서. REST API 설명서 및 프로그래밍 언어 기반 콘텐츠입니다.

텍스트 번역 기능

텍스트 번역은 다음 방법을 지원합니다.

언어. 번역, 음역 및 사전 조회 작업에서 지원되는 언어의 목록을 반환합니다. 이 요청에는 인증이 필요하지 않습니다. 다음 GET 요청을 복사하여 원하는 REST API 도구나 브라우저에 붙여넣기만 하면 됩니다.
```
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
```
번역. 한 요청에서 단일 소스 언어 텍스트를 여러 대상 언어 텍스트로 렌더링합니다.
음역. 소스 언어의 문자 또는 글을 대상 언어의 해당 문자 또는 글로 변환합니다.
탐지. 소스 코드 언어 코드와, 검색된 언어에 대해 텍스트 번역 및 음역이 지원되는지 여부를 표시하는 부울 변수를 반환합니다.

참고 항목

단일 REST API 호출로 텍스트를 번역, 음역, 검색할 수 있습니다.
사전 조회. 소스 용어에 해당하는 단어를 대상 언어로 반환합니다.
사전 예제 소스 용어와 대상 용어 쌍의 문법 구조와 컨텍스트 예제를 반환합니다.

텍스트 번역 배포 옵션

다음 리소스를 사용하여 프로젝트 및 애플리케이션에 텍스트 번역을 추가합니다.

Azure에서 사용할 수 있는 REST API를 통해 클라우드 기반 번역기 서비스에 액세스합니다.
텍스트 번역 Docker 컨테이너를 사용하여 REST API 번역 요청을 사용합니다.
Important
- 번역기 컨테이너를 사용하려면 제어된 서비스용 Azure AI 서비스 애플리케이션 온라인 요청 양식을 작성하여 제출하고 컨테이너에 대한 액세스 권한을 얻도록 승인을 받아야 합니다.
- Translator 컨테이너 이미지는 클라우드 제품에 비해 제한된 기능을 지원합니다.

데이터 보존

텍스트 번역 데이터 보존은 Translator 리소스가 만들어진 Azure 지역에 따라 달라집니다.

텍스트 번역 데이터 보존

✔️ 기능: Translator Text

서비스 엔드포인트	요청 처리 데이터 센터
전역(권장): `api.cognitive.microsofttranslator.com`	가장 가까운 사용 가능한 데이터 센터입니다.
아메리카: `api-nam.cognitive.microsofttranslator.com`	미국 동부 2 • 미국 서부 2
아시아 태평양: `api-apc.cognitive.microsofttranslator.com`	일본 동부 • 동남 아시아
유럽(스위스 제외): `api-eur.cognitive.microsofttranslator.com`	프랑스 중부 • 서유럽
스위스: 자세한 내용은 스위스 서비스 엔드포인트 를 참조하세요.	스위스 북부 • 스위스 서부

스위스 서비스 엔드포인트

스위스 북부 또는 스위스 서부에 리소스가 있는 고객은 텍스트 API 요청이 스위스 내에서 처리되도록 할 수 있습니다. 요청이 스위스에서 처리되도록 하려면 Resource region Switzerland North 또는 Switzerland West에서 Translator 리소스를 만든 다음 API 요청에서 리소스의 사용자 지정 엔드포인트를 사용합니다.

예를 들어, Azure Portal에서 Resource region을 Switzerland North로 사용하여 Translator 리소스를 만들고 리소스 이름이 my-swiss-n인 경우 사용자 지정 엔드포인트는 https://my-swiss-n.cognitiveservices.azure.com입니다. 그리고 번역할 샘플 요청은 다음과 같습니다.

// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v

Custom Translator는 현재 스위스에서 사용할 수 없습니다.

텍스트 번역 시작

시작할 준비가 되셨나요?

Azure Portal에서 Translator 리소스를 만듭니다.
액세스 키와 API 엔드포인트를 가져옵니다. 인증에는 엔드포인트 URL 및 읽기 전용 키가 필요합니다.
다음 프로그래밍 언어에 대한 빠른 시작을 살펴보고 사용 사례 및 코드 샘플을 확인하세요.

다음 단계

텍스트 번역 REST API에 대해 자세히 알아봅니다.

REST API 참조 참고

다음을 통해 공유