Create Translation

This endpoint transforms your source text into fluent, natural-sounding translations in your target language, enabling seamless multilingual communication for your applications. When you provide text along with language preferences and customization options, our system initiates a translation task and returns a unique identifier you can use to track its progress.

​

Customizing Your Translation

​

Language Selection

For successful translation, you’ll need to specify both source and target languages:

• Source Language: The original language of your text
• Target Language: The language you want your text translated into

To see what’s available:

• Check the /source-languages or /target-languages endpoints for a complete list of supported languages with their corresponding IDs.

​

Style and Tone Customization

Our platform offers several ways to tailor translations to your specific audience:

• Formality: Adjust the formality level to match your context:

  • Formal (1): Professional communications, official documents
  • Informal (2): Casual conversations, social media content

• Gender: Specify grammatical gender preferences when relevant in the target language

• Age: Adjust vocabulary and expressions to be age-appropriate for your intended audience

​

Domain Expertise

For specialized content, you can enhance accuracy with domain-specific terminology:

• Chosen Dictionaries: Include specialized vocabulary dictionaries to ensure technical terms are translated appropriately for fields like medicine, law, technology, or other industries

​

How the Process Works

This endpoint uses an asynchronous workflow, allowing your application to continue operations while translation processing happens in the background:

This asynchronous approach is particularly effective for handling longer texts or processing multiple translations simultaneously without blocking your application’s workflow.

​

Example: Creating Your First Translation

Here’s a practical example showing how to translate business communications from English to Spanish:

import requests
import time

# Define the translation request
translation_payload = {
    "source_language": 1,     # English
    "target_language": 2,     # Spanish
    "texts": [
        "Thank you for your inquiry about our services.",
        "We would be happy to schedule a meeting next week to discuss your needs in detail.",
        "Please let us know what day works best for you."
    ],
    "formality": 1,           # Formal tone
    "gender": 1,              # Male grammatical forms when applicable
    "age": 30                 # Adult-appropriate language
}

# Set up your API credentials
headers = {
    "x-api-key": "your-api-key",  # Replace with your actual API key
    "Content-Type": "application/json"
}

# Step 1: Submit your translation request
response = requests.post(
    "https://client.camb.ai/apis/translate",
    json=translation_payload,
    headers=headers
)

# Check if the request was successful
response.raise_for_status()
task_data = response.json()
task_id = task_data["task_id"]
print(f"Translation task created! Task ID: {task_id}")

# Step 2: Check progress until complete
while True:
    status_response = requests.get(
        f"https://client.camb.ai/apis/translate/{task_id}",
        headers=headers
    )
    status_data = status_response.json()
    status = status_data["status"]
    print(f"Status: {status}")

    if status == "SUCCESS":
        run_id = status_data["run_id"]
        break
    elif status == "ERROR":
        print("Translation task failed!")
        break

    # Wait before checking again
    time.sleep(2)

# Step 3: Process your translated text
if status == "SUCCESS":
    print("✨ Translation complete!")
    print(f"Use the `run_id` {task_data.get('run_id')} to fetch your translation.")

With this approach, you can efficiently translate content across languages while maintaining appropriate tone, formality, and specialized terminology to ensure your message resonates with its intended audience.