Translator 3.0: BreakSentence

아티클
09/02/2024

텍스트에서 문장 경계의 위치를 식별합니다.

요청 URL

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

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

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

요청 매개 변수

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

쿼리 매개 변수	설명
api-version	필수 쿼리 매개 변수입니다. 클라이언트에서 요청한 API 버전입니다. 값은 `3.0`이어야 합니다.
language	선택적 쿼리 매개 변수입니다. 입력 텍스트의 언어를 식별하는 언어 태그입니다. 코드를 지정하지 않으면 자동 언어 검색이 적용됩니다.
스크립트	선택적 쿼리 매개 변수입니다. 입력 텍스트에서 사용하는 스크립트를 식별하는 스크립트 태그입니다. 스크립트를 지정하지 않으면 언어의 기본 스크립트가 가정됩니다.

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

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

요청 본문

요청 본문은 JSON 배열입니다. 각 배열 요소는 문자열 속성이 있는 JSON 개체입니다 Text. 문장 경계는 속성 값 Text 에 대해 계산됩니다. 텍스트의 한 부분을 포함하는 샘플 요청 본문은 다음과 같습니다.

[
    { "Text": "How are you? I am fine. What did you do today?" }
]

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

배열에는 최대 100개 요소가 있을 수 있습니다.
배열 요소의 텍스트 값은 공백을 포함하여 50,000자를 초과할 수 없습니다.
요청에 포함된 전체 텍스트는 공백을 포함하여 50,000자를 초과할 수 없습니다.
language 쿼리 매개 변수를 지정하는 경우 모든 배열 요소가 동일한 언어여야 합니다. 그렇지 않은 경우, 언어 자동 검색이 각 배열 요소에 독립적으로 적용됩니다.

응답 본문

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

sentLen: 텍스트 요소의 문장 길이를 나타내는 정수 배열입니다. 배열의 길이는 문장 수이며 값은 각 문장의 길이입니다.
detectedLanguage: 다음 속성을 통해 검색된 언어를 설명하는 개체입니다.
- language: 검색된 언어의 코드입니다.
- score: 결과의 신뢰도를 나타내는 부동 소수 자릿수 값입니다. 점수는 0(0)에서 1(1.0) 사이입니다. 낮은 점수(<= 0.4)는 신뢰도가 낮음을 나타냅니다.

이 detectedLanguage 속성은 언어 자동 검색이 요청된 경우에만 결과 개체에 있습니다.

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

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "sentLen": [
            13,
            11,
            22
        ]
    }
]

응답 헤더

헤더	설명
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/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"

다음을 통해 공유