사용자 지정 번역 정의
Azure AI 번역기에서 사용하는 기본 번역 모델은 일반 번역에는 효과적이지만 비즈니스 또는 산업에 사용하는 특정 용어를 위해 사용자 지정 번역이 필요한 번역 솔루션을 개발해야 할 수도 있습니다.
이 문제를 해결하기 위해 원본 및 번역 대상 용어의 자체 집합을 매핑하는 사용자 지정 모델을 만들 수 있습니다. 사용자 지정 모델을 만들려면 Custom Translator 포털을 사용하여 다음을 수행합니다.
- Azure AI 번역기 리소스에 연결된 작업 영역을 만듭니다.
- 프로젝트를 만듭니다.
- 학습 데이터 파일을 업로드하고 모델을 학습시킵니다.
- 모델을 테스트하고 모델을 게시합니다.
- API에 대한 번역 호출을 만듭니다.
사용자 지정 모델에는 고유한 범주 ID(스크린샷에 강조 표시됨)가 할당됩니다. 이 ID는 범주 매개 변수를 사용하여 Azure AI 번역기 리소스에 대한 변환 호출에서 지정할 수 있으며, 이로써 기본 모델 대신 사용자 지정 모델에서 변환이 수행됩니다.
API를 호출하는 방법
번역을 시작하려면 POST 요청을 다음과 같은 요청 URL로 보냅니다.
https://api.cognitive.microsofttranslator.com/translate?api-version=3.0
요청에는 다음과 같은 몇 가지 매개 변수가 포함되어야 합니다.
api-version
: 필요한 API 버전.to
: 번역할 대상 언어. 예:to=fr
프랑스어.category
: 내 카테고리 ID.
요청에는 많은 필수 헤더도 포함되어야 합니다.
Ocp-Apim-Subscription-Key
. 클라이언트 키의 헤더. 예:Ocp-Apim-Subscription-Key=<your-client-key>
Content-Type
. 페이로드의 콘텐츠 형식입니다. 필수 형식은Content-Type: application/json; charset=UTF-8
입니다.
요청 본문에는 번역할 텍스트를 지정하는 Text
속성을 가진 JSON 개체가 있는 배열이 포함되어야 합니다.
[
{"Text":"Where can I find my employee details?"}
]
C#, Python 및 curl 사용을 포함하여 요청을 API에 보낼 수 있는 여러 가지 방법이 있습니다. 예를 들어 빠른 호출을 위해 curl을 사용하여 POST 요청을 보낼 수 있습니다.
curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"
위의 요청은 영어 문장을 네덜란드어로 번역하기를 호출합니다.
응답이 반환됨
응답은 요청이 성공한 경우 200
응답 코드를 반환합니다. 또한 다음과 같이 번역된 텍스트를 포함하는 응답 본문을 반환합니다.
[
{
"translations":[
{"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
]
}
]
요청이 성공하지 못한 경우 400
과(와) 같은 오류 유형(누락 또는 잘못된 쿼리 매개 변수)에 따라 여러 다른 상태 코드가 반환될 수 있습니다. 전체 코드 목록과 관련 설명은 응답 상태 코드를 참조하세요.
참고 항목
사용자 지정 번역에 대한 자세한 내용은 빠른 시작: 사용자 지정 모델을 사용하여 빌드, 게시 및 번역을 참조하세요.