Translator 3.0: Detect

아티클
09/02/2024

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

요청 URL

다음에 POST 요청을 보냅니다.

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

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

요청 매개 변수

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

쿼리 매개 변수	설명
api-version	필수 매개 변수입니다. 클라이언트에서 요청한 API 버전입니다. 값은 `3.0`이어야 합니다.

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

헤더	설명
인증 헤더	필요한 요청 헤더입니다. 인증에 사용할 수 있는 옵션을 참조하세요.
콘텐츠-형식	필요한 요청 헤더입니다. 페이로드의 콘텐츠 형식을 지정합니다. 가능한 값은 `application/json`입니다.
Content-Length	선택 사항. 요청 본문의 길이입니다.
X-ClientTraceId	선택 사항. 요청을 고유하게 식별하는 클라이언트 생성 ID입니다. 쿼리 매개 변수를 `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: 다른 가능한 언어의 배열입니다. 배열의 각 요소는 다음과 같은 속성인 scoreisTranslationSupportedisTransliterationSupported다른 개체입니다. language

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

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

응답 헤더

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

응답 상태 코드

요청을 반환하는 가능한 HTTP 상태 코드는 다음과 같습니다.

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

오류가 발생하면 요청은 JSON 오류 응답을 반환합니다. 오류 코드는 오류를 더 범주화하도록 뒤에 3자리 숫자가 오는 3자리 HTTP 상태 코드로 결합된 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?'}]"

다음을 통해 공유