End to End Dubbing

Transform your media content for global audiences with our comprehensive dubbing solution. This powerful endpoint automates the entire dubbing process, taking your original media and producing a version that speaks naturally in your target language. The system handles everything from transcription to voice synthesis, delivering professional-quality results without requiring specialized audio engineering knowledge.

​

The Dubbing Process

When you submit a dubbing request, our system begins a multi-stage workflow:

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

​

Compatible Media Sources

Our dubbing service accommodates various media sources to fit your workflow needs. The video_url parameter in your request can point to any of the following:

​

Online Platforms

Use content directly from popular content platforms:

• YouTube videos: Simply provide the standard YouTube video URL.
• Google Drive: Link to media files stored in Google Drive (ensure they’re publicly accessible).
• Direct URLs: Any direct link to a media file that doesn’t require authentication.

​

Supported File Formats

Our system processes a wide range of professional and consumer media formats:

This flexibility allows you to work with both broadcast-quality content and consumer-grade media without conversion hassles.

​

Language Configuration

Specifying the right languages is crucial for successful dubbing. Your request needs to include:

• Source Language: The original language spoken in your media.
• Target Language(s): The language(s) you want your content to be dubbed into.

Both parameters require specific language identifiers from our system. To find the correct IDs:

1. Query the /source-languages endpoint for available source language options.
2. Check the /target-languages endpoint for supported target languages.

Using these official IDs ensures our system correctly processes your content.

​

Creating Your First Dubbing request

Let’s look at how to initiate a dubbing task with Python:

import requests
import json
import time

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

# Define your dubbing request parameters
dubbing_request = {
    "video_url": "https://www.youtube.com/watch?v=exampleVideo",  # Your media URL
    "source_language": 1,      # Example: English (check /source-languages for IDs)
    "target_languages": [5],   # Example: Spanish (check /target-languages for IDs)
}

# Submit the dubbing request
def submit_dubbing_task(payload):
    """
    Submits a new dubbing task and returns the task ID for tracking.
    """
    try:
        response = requests.post(
            "https://client.camb.ai/apis/dub",
            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"Dubbing task submitted successfully! Task ID: {task_id}")
        return task_id

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

# Call the function to submit your dubbing task
task_id = submit_dubbing_task(dubbing_request)

​

Monitoring Your Dubbing Progress

After submission, your content enters our processing pipeline. The time required depends on the length and complexity of your media. You can check progress by polling the status endpoint:

def check_dubbing_status(task_id):
    """
    Checks the status of a dubbing task.
    Returns the current status and any available result information.
    """
    if not task_id:
        print("No task ID provided.")
        return None

    try:
        response = requests.get(
            f"https://client.camb.ai/apis/dub/{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']}")

        return status_data

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

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

​

Best Practices for Optimal Results

To get the most from our dubbing service, consider these professional tips:

1. Source Quality Matters: Higher quality original media yields better dubbing results.
2. Language Selection: Choose the right language for your audience to ensure clarity and authenticity.

​

Practical Applications

Our end-to-end dubbing functionality opens exciting possibilities across industries:

• E-Learning: Make educational content accessible to global learners.
• Marketing: Localize promotional videos for international markets.
• Entertainment: Bring films and shows to new language audiences.
• Corporate Communications: Ensure company messages reach multilingual teams.
• Social Media: Expand your content’s reach across language barriers.

By integrating this API into your workflow, you can dramatically reduce the time and expense traditionally associated with professional dubbing while maintaining impressive quality.