Text Translation

def TextTranslate(self, request: models.TextTranslateRequest) -> models.TextTranslateResponse:
    """
    Translate text from source language to target language.
    
    Args:
        request: TextTranslateRequest with translation parameters
        
    Returns:
        TextTranslateResponse with translated text and metadata
        
    Raises:
        TencentCloudSDKException: For various error conditions
    """

from tencentcloud.common import credential
from tencentcloud.tmt.v20180321.tmt_client import TmtClient
from tencentcloud.tmt.v20180321 import models

# Initialize client
cred = credential.Credential("SecretId", "SecretKey")
client = TmtClient(cred, "ap-beijing")

# Create translation request
req = models.TextTranslateRequest()
req.SourceText = "Hello, world!"
req.Source = "en"
req.Target = "zh"
req.ProjectId = 0

# Perform translation
resp = client.TextTranslate(req)
print(resp.TargetText)  # 你好，世界！
print(resp.Source)      # en (detected source)
print(resp.Target)      # zh (target language)

def TextTranslateBatch(self, request: models.TextTranslateBatchRequest) -> models.TextTranslateBatchResponse:
    """
    Translate multiple text strings in batch.
    
    Args:
        request: TextTranslateBatchRequest with batch parameters
        
    Returns:
        TextTranslateBatchResponse with list of translated texts
        
    Raises:
        TencentCloudSDKException: For various error conditions
    """

# Create batch translation request
req = models.TextTranslateBatchRequest()
req.Source = "en"
req.Target = "zh"
req.ProjectId = 0
req.SourceTextList = [
    "Hello, world!",
    "How are you?",
    "Thank you very much."
]
# Optional: Use terminology and sentence databases
# req.TermRepoIDList = ["term_repo_id_1", "term_repo_id_2"]
# req.SentRepoIDList = ["sent_repo_id_1"]

# Perform batch translation
resp = client.TextTranslateBatch(req)
for translated_text in resp.TargetTextList:
    print(translated_text)
print(f"Characters used: {resp.UsedAmount}")

def LanguageDetect(self, request: models.LanguageDetectRequest) -> models.LanguageDetectResponse:
    """
    Detect the language of input text.
    
    Args:
        request: LanguageDetectRequest with text to analyze
        
    Returns:
        LanguageDetectResponse with detected language code
        
    Raises:
        TencentCloudSDKException: For various error conditions
    """

# Create language detection request
req = models.LanguageDetectRequest()
req.Text = "Bonjour le monde"
req.ProjectId = 0

# Detect language
resp = client.LanguageDetect(req)
print(resp.Lang)  # fr (French detected)

class TextTranslateRequest:
    """
    Request parameters for text translation.
    
    Attributes:
        SourceText (str): Text to translate (max 6000 characters)
        Source (str): Source language code
        Target (str): Target language code  
        ProjectId (int): Project ID (default: 0)
        UntranslatedText (str): Text segments to keep untranslated
    """

class TextTranslateResponse:
    """
    Response from text translation.
    
    Attributes:
        TargetText (str): Translated text result
        Source (str): Detected/specified source language
        Target (str): Target language
        UsedAmount (int): Characters consumed for billing
        RequestId (str): Unique request identifier
    """

class TextTranslateBatchRequest:
    """
    Request parameters for batch text translation.
    
    Attributes:
        Source (str): Source language code
        Target (str): Target language code
        ProjectId (int): Project ID (default: 0)
        SourceTextList (list[str]): List of texts to translate
        TermRepoIDList (list[str]): List of terminology databases to use
        SentRepoIDList (list[str]): List of sentence databases to use
    """

class TextTranslateBatchResponse:
    """
    Response from batch text translation.
    
    Attributes:
        Source (str): Source language
        Target (str): Target language
        TargetTextList (list[str]): List of translated texts
        UsedAmount (int): Characters consumed for billing
        RequestId (str): Unique request identifier
    """

class LanguageDetectRequest:
    """
    Request parameters for language detection.
    
    Attributes:
        Text (str): Text to analyze for language detection
        ProjectId (int): Project ID (default: 0)
    """

class LanguageDetectResponse:
    """
    Response from language detection.
    
    Attributes:
        Lang (str): Detected language code
        RequestId (str): Unique request identifier
    """