사용자 지정 번역 정의

완료됨

Azure AI 번역기에서 사용하는 기본 번역 모델은 일반 번역에는 효과적이지만 비즈니스 또는 산업에 사용하는 특정 용어를 위해 사용자 지정 번역이 필요한 번역 솔루션을 개발해야 할 수도 있습니다.

이 문제를 해결하기 위해 원본 및 번역 대상 용어의 자체 집합을 매핑하는 사용자 지정 모델을 만들 수 있습니다. 사용자 지정 모델을 만들려면 Custom Translator 포털을 사용하여 다음을 수행합니다.

  1. Azure AI 번역기 리소스에 연결된 작업 영역을 만듭니다.
  2. 프로젝트를 만듭니다.
  3. 학습 데이터 파일을 업로드하고 모델을 학습시킵니다.
  4. 모델을 테스트하고 모델을 게시합니다.
  5. API에 대한 번역 호출을 만듭니다.

Screenshot showing the Custom Translator portal.

사용자 지정 모델에는 고유한 범주 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과(와) 같은 오류 유형(누락 또는 잘못된 쿼리 매개 변수)에 따라 여러 다른 상태 코드가 반환될 수 있습니다. 전체 코드 목록과 관련 설명은 응답 상태 코드를 참조하세요.

참고 항목

사용자 지정 번역에 대한 자세한 내용은 빠른 시작: 사용자 지정 모델을 사용하여 빌드, 게시 및 번역을 참조하세요.