language-translation

Effortless Language Translation and Detection with Dynamic Language Translation API

19 Jul 2025
Effortless Language Translation and Detection with Dynamic Language Translation API

In today’s interconnected world, the ability to communicate across different languages is crucial. The Dynamic Language Translation API offers powerful Cognitive Actions that allow developers to seamlessly integrate language translation and detection capabilities into their applications. With the ability to translate text into over 100 languages and automatically identify the language of a given text, this API simplifies the process of bridging language barriers, enhancing user experience, and expanding market reach.

Prerequisites

To get started with the Dynamic Language Translation API, you'll need a valid API key. Familiarity with general API call structures will also be beneficial for integrating these features into your applications.

Translate Text Across Languages

The Translate Text Across Languages action allows you to convert any text into more than 100 languages efficiently and affordably. This service is powered by the Translate Plus API, renowned for its speed and cost-effectiveness compared to other translation providers.

Input Requirements:

  • messageText: The content of the message to be translated (e.g., "Hello, How are you").
  • sourceLanguage: The language code of the original message (e.g., "en" for English).
  • targetLanguage: The language code for the target translation (e.g., "nl" for Dutch).

Expected Output: The response includes the original text, source language, target language, and the translated text. For instance, translating "Hello, How are you" from English to Dutch would yield "Hallo hoe is het".

Use Cases for this specific action:

  • Multilingual Applications: Enhance user engagement by providing content in multiple languages.
  • Customer Support: Facilitate communication with international customers by translating queries and responses.
  • Content Localization: Localize marketing materials or product descriptions for different regions.

```python
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "2dc1f609-b7ac-4ae7-b04d-8f705312ea40" # Action ID for: Translate Text Across Languages

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "messageText": "Hello , How are you",
  "sourceLanguage": "en",
  "targetLanguage": "nl"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")



## Detect Language
The **Detect Language** action enables your application to automatically identify the language of a provided text. This feature is particularly useful for applications that handle user-generated content in various languages, allowing for more tailored responses.

**Input Requirements:**
- `text`: The input text for the request, which should be a complete sentence or question (e.g., "How are you?").

**Expected Output:**
The API returns the detected language alongside the original text. For example, if the input is "How are you?", the output will indicate that the language is English.

**Use Cases for this specific action:**
- **Dynamic Content Handling**: Automatically adjust content presentation based on the detected language.
- **User Personalization**: Improve user experience by tailoring responses in the language identified.
- **Data Analysis**: Analyze text data from diverse sources to understand language demographics.


import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "2edaf06a-2b6e-4833-bfe4-be6dbc2fe055" # Action ID for: Detect Language

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "text": "How are you?"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")



### Conclusion
The Dynamic Language Translation API provides essential tools for developers looking to enhance their applications with language translation and detection capabilities. By leveraging these Cognitive Actions, you can improve communication, expand your audience reach, and create a more inclusive user experience. Whether you are building multilingual applications or simply need to identify languages quickly, this API offers the flexibility and efficiency needed to succeed in a global market. Start integrating these actions today and take your application to the next level!
← Back to All Articles