다음을 통해 공유

Foundry Tools 3.0의 Azure Translator: 검색

텍스트 조각의 언어를 식별합니다.

요청 주소 (URL)

다음으로 요청을 보냅니다 POST .

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

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

요청 매개 변수

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

쿼리 매개 변수 Description
API 버전 필수 매개 변수입니다.
클라이언트에서 요청한 API의 버전입니다. 값은 3.0이어야 합니다.

요청 헤더에는 다음이 포함됩니다.

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

요청 메시지 본문

요청 본문은 JSON 배열입니다. 각 배열 요소는 문자열 속성이 있는 JSON 개체입니다 Text. 언어 검색은 속성 값에 적용됩니다 Text . 언어 자동 검색은 더 긴 입력 텍스트에서 더 잘 작동합니다. 샘플 요청 본문은 다음과 같습니다.

[
    { "text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

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

  • 배열에는 최대 100개 요소가 있을 수 있습니다.
  • 요청에 포함된 전체 텍스트는 공백을 포함하여 50,000자를 초과할 수 없습니다.

응답 본문

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

  • language: 검색된 언어의 코드입니다.

  • score: 결과의 신뢰도를 나타내는 부동 소수 자릿수 값입니다. 점수가 0에서 1 사이이고 낮은 점수는 신뢰도가 낮음을 나타냅니다.

  • isTranslationSupported: 검색된 언어가 텍스트 번역에 지원되는 언어 중 하나인 경우 true인 부울 값입니다.

  • isTransliterationSupported: 검색된 언어가 음역에 지원되는 언어 중 하나인 경우 true인 부울 값입니다.

  • alternatives: 다른 가능한 언어의 배열입니다. 배열의 각 요소는 다음과 같은 속성인 languagescoreisTranslationSupported다른 개체입니다. isTransliterationSupported

JSON 응답의 예는 다음과 같습니다.

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

응답 헤더

Headers Description
X-RequestId 요청을 식별하기 위해 서비스에서 생성되고 문제 해결 용도로 사용되는 값입니다.

응답 상태 코드

다음은 요청이 반환하는 가능한 HTTP 상태 코드입니다.

상태 코드 Description
200 성공.
400 쿼리 매개 변수 중 하나가 누락되었거나 유효하지 않습니다. 다시 시도하기 전에 요청 매개 변수를 수정합니다.
401 요청을 인증할 수 없습니다. 자격 증명이 지정되고 유효한지 확인합니다.
403 요청은 권한이 없습니다. 세부 정보 오류 메시지를 확인합니다. 이 코드는 종종 평가판 구독과 함께 제공되는 모든 무료 번역이 사용됨을 나타냅니다.
429 클라이언트가 요청 제한을 초과했기 때문에 서버가 요청을 거부했습니다.
500 예기치 않은 오류가 발생했습니다. 오류가 지속되면 오류 날짜 및 시간, 응답 헤더의 요청 식별자 및 요청 X-RequestId헤더X-ClientTraceId의 클라이언트 식별자를 사용하여 보고합니다.
503 서버를 일시적으로 사용할 수 없습니다. 요청을 다시 시도합니다. 오류가 지속되면 오류 날짜 및 시간, 응답 헤더의 요청 식별자 및 요청 X-RequestId헤더X-ClientTraceId의 클라이언트 식별자를 사용하여 보고합니다.

오류가 발생하면 요청은 JSON 오류 응답을 반환합니다. 오류 코드는 3자리 HTTP 상태 코드와 3자리 숫자를 결합하여 오류를 추가로 분류하는 6자리 숫자입니다. 일반적인 오류 코드는 v3 Translator 참조 페이지에서 찾을 수 있습니다.

예시

다음 예제에서는 텍스트 번역에 지원되는 언어를 검색하는 방법을 보여 줍니다.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"
  • Last updated on