다음을 통해 공유

컨테이너: 텍스트 음역

  • 아티클

원본 언어의 문자 또는 문자를 대상 언어의 해당 문자 또는 문자로 변환합니다.

요청 URL

POST 요청:

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

Translator 서비스가 선택한 네트워크와 프라이빗 엔드포인트 구성 및 지원에 대해서는 Virtual Network 지원을 참조하세요.

요청 매개 변수

쿼리 문자열에 전달된 요청 매개 변수는 다음과 같습니다.

쿼리 매개 변수 설명 조건
api-version 클라이언트에서 요청한 API 버전입니다. 값은 3.0이어야 합니다. 필수 매개 변수
언어 한 스크립트에서 다른 스크립트로 변환할 텍스트의 원본 언어를 지정합니다. 필수 매개 변수
fromScript 입력 텍스트에서 사용하는 스크립트를 지정합니다. 필수 매개 변수
toScript 출력 스크립트를 지정합니다. 필수 매개 변수

요청 헤더

헤더 설명 조건
인증 헤더 인증에 사용 가능한 옵션 참조 필수 요청 헤더
콘텐츠-형식 페이로드의 콘텐츠 형식을 지정합니다. 가능한 값: application/json 필수 요청 헤더
Content-Length 요청의 길이 본문입니다. 선택 사항
X-ClientTraceId 요청을 고유하게 식별하는 클라이언트 생성 ID입니다. 쿼리 매개 변수를 ClientTraceId사용하여 쿼리 문자열에 추적 ID를 포함하는 경우 이 헤더를 생략할 수 있습니다. 선택 사항

응답 본문

성공적인 응답은 입력 배열의 각 요소에 대해 하나의 결과를 포함한 JSON 배열입니다. 결과 개체에는 다음 속성이 포함됩니다.

  • text: 입력 문자열을 출력 스크립트로 변환한 결과 문자열입니다.

  • script: 출력에 사용되는 스크립트를 지정하는 문자열입니다.

응답 헤더

헤더 설명
X-RequestId 요청을 식별하기 위해 서비스에서 생성한 값입니다. 문제 해결을 위해 사용할 수 있습니다.

샘플 요청

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

샘플 요청 본문

요청 본문은 JSON 배열입니다. 각 배열 요소는 변환할 문자열을 나타내는 문자열 Text속성이 있는 JSON 개체입니다.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

다음과 같은 제한 사항이 적용됩니다.

  • 배열에는 최대 10가지 요소가 있을 수 있습니다.
  • 배열 요소의 텍스트 값은 공백을 포함하여 1,000자를 초과할 수 없습니다.
  • 요청에 포함된 전체 텍스트는 공백을 포함하여 5,000자를 초과할 수 없습니다.

샘플 JSON 응답:

[
  {
    "text": "Kon'nichiwa​",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

참고 항목

  • 각 샘플은 localhost 명령을 사용하여 지정한 샘플에서 docker run 실행됩니다.
  • 컨테이너가 실행되는 localhost 동안 컨테이너 자체를 가리킵니다.
  • 를 사용할 localhost:5000필요가 없습니다. 호스트 환경에서 아직 사용되지 않는 모든 포트를 사용할 수 있습니다.

REST API를 사용하여 음역


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

다음 단계

텍스트 음역에 대해 자세히 알아보기