필수 항목입니다. 문자열 형식의 입력 콘텐츠입니다. 총 콘텐츠는 30,000개 미만의 코드 포인트가 권장됩니다. 이 필드의 최대 길이는 1024입니다.
mime_type
string
(선택사항) 소스 텍스트의 형식입니다(예: 'text/html', 'text/plain'). 비워 두면 MIME 유형은 기본적으로 'text/html'입니다.
source_language_code
string
(선택사항) 입력 텍스트의 BCP-47 언어 코드입니다(알려진 경우)(예: 'en-US' 또는 'sr-Latn'). 지원되는 언어 코드는 언어 지원에 나열되어 있습니다. 소스 언어가 지정되지 않으면 API에서 소스 언어를 자동으로 식별하려고 시도하고 응답 내에 소스 언어를 반환합니다.
target_language_code
string
필수 항목입니다. 입력 텍스트의 번역에 사용할 BCP-47 언어 코드입니다. 언어 지원에 나열된 언어 코드 중 하나로 설정됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-30(UTC)"],[[["\u003cp\u003eThis service translates text input into a specified target language, using a POST request to the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e parameter is required in the path, representing the caller's project in the format \u003ccode\u003e/projects/{project-id}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires \u003ccode\u003econtents\u003c/code\u003e (the text to translate) and \u003ccode\u003etarget_language_code\u003c/code\u003e (the desired translation language) fields, while \u003ccode\u003esource_language_code\u003c/code\u003e and \u003ccode\u003emime_type\u003c/code\u003e are optional.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eglossary_config\u003c/code\u003e field is optional and enables the use of a glossary for translation, supporting the \u003ccode\u003ecloudtranslate.glossaries.predict\u003c/code\u003e feature.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a \u003ccode\u003eTranslateTextResponse\u003c/code\u003e, and the total \u003ccode\u003econtents\u003c/code\u003e input should ideally be under 30k codepoints with a max length of 1024.\u003c/p\u003e\n"]]],[],null,["# Method: projects.translateText\n\nTranslates input text and returns translated text.\n\n### HTTP request\n\n`POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:translateText`\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [TranslateTextResponse](/distributed-cloud/hosted/docs/latest/gdch/apis/vertex-ai/translation/rest/v3/TranslateTextResponse)."]]