Create Translated Story

Expand your storytelling to global audiences with our comprehensive translation service. This powerful endpoint transforms your previously created stories into new languages, allowing your content to reach diverse linguistic communities. The system handles everything from translation to voice synthesis, delivering professional-quality results that preserve the original story’s essence while adapting it naturally to the target language.

​

The Translation Process

When you submit a story translation request, our system begins a sophisticated workflow:

Throughout this process, you can check on your task’s progress using the /translated-story/{task_id} endpoint with the task_id provided in your initial response.

​

Language Selection

Choosing the right target language is essential for effective story translation. Our system supports over 148 languages, giving you incredible global reach. To specify your desired language:

1. Use the appropriate language ID in your request (an integer value between 1 and 148).
2. For a complete list of supported languages and their corresponding IDs, query the /languages endpoint.

This ensures our system correctly processes your content for the intended audience.

​

Creating Your First Translated Story

Let’s examine how to initiate a story translation task using Python:

import requests
import json

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

# Define your translation request parameters
def translate_story(run_id, target_language):
    """
    Submits a new story translation task and returns the task ID for tracking.

    Parameters:
    - run_id: The ID of the original story to translate
    - target_language: The ID of the target language (check /languages for IDs)
    """
    try:
        # Prepare the request body
        payload = {
            "target_language": target_language
        }

        # Submit the translation request
        response = requests.post(
            f"https://client.camb.ai/apis/translated-story/{run_id}",
            headers=headers,
            data=json.dumps(payload)
        )

        # Verify the request was successful
        response.raise_for_status()

        # Extract the task ID from the response
        result = response.json()
        task_id = result.get("task_id")

        print(f"Story translation task submitted successfully! Task ID: {task_id}")
        return task_id

    except requests.exceptions.RequestException as e:
        print(f"Error submitting story translation task: {e}")
        if hasattr(e, 'response') and e.response is not None:
            print(f"Response content: {e.response.text}")
        return None

# Example usage
run_id = 12345  # Replace with your actual run_id
target_language = 5  # Example: Spanish (check /languages for IDs)
task_id = translate_story(run_id, target_language)

​

Monitoring Your Translation Progress

After submission, your story enters our translation pipeline. You can monitor the progress by polling the status endpoint:

def check_translation_status(task_id):
    """
    Checks the status of a story translation task.
    Returns the current status and any available result information.

    Parameters:
    - task_id: The ID of the translation task to check
    """
    if not task_id:
        print("No task ID provided.")
        return None

    try:
        response = requests.get(
            f"https://client.camb.ai/apis/translated-story/{task_id}",
            headers=headers
        )

        # Verify the request was successful
        response.raise_for_status()

        # Parse the status information
        status_data = response.json()
        print(f"Current status: {status_data['status']}")

        # If the translation is complete, display the results
        if status_data['status'] == "SUCCESS":
            print("Story translation completed successfully!")
            print(f"Translated story URL: {status_data.get('story_url')}")

        return status_data

    except requests.exceptions.RequestException as e:
        print(f"Error checking translation status: {e}")
        return None

# Check the status of your translation task
status_info = check_translation_status(task_id)

​

Best Practices for Optimal Results

To achieve the best possible translations of your stories, consider these professional recommendations:

1. Original Quality: Ensure your source story is of high quality, as the translation will preserve any issues present in the original.

2. Cultural Considerations: Some stories may contain cultural references that don’t translate directly. Consider this when selecting target languages.

3. Language Pairing: Some language pairs translate more smoothly than others. When possible, start with content that will translate well to your target language.

4. Sequential Translation: For best results, translate directly from the original language rather than creating “translations of translations.”

5. Test Translations: Consider testing with shorter stories first to ensure the target language delivers the tone and style you’re seeking.

​

Practical Applications

Our story translation functionality enables exciting opportunities across various fields:

• Global Education: Make educational stories accessible to learners worldwide in their native languages.

• Publishing: Quickly expand your literary works to international markets without the traditional translation timeline.

• Cultural Exchange: Share folktales and cultural narratives across language barriers, fostering global understanding.

• Language Learning: Create parallel versions of stories for language learners to compare with original texts.

• International Marketing: Adapt brand stories and narratives for diverse global audiences.

By integrating this translation capability into your workflow, you can efficiently extend your storytelling reach across linguistic boundaries, dramatically reducing the time and resources traditionally required for multilingual content creation while maintaining impressive quality and authenticity.