Get Dubbing Result

GET

dub-result

{run_id}

Get Dubbed Run Info

curl --request GET \
  --url https://client.camb.ai/apis/dub-result/{run_id} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client.camb.ai/apis/dub-result/{run_id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client.camb.ai/apis/dub-result/{run_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/dub-result/{run_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "video_url": "<string>",
  "audio_url": "<string>",
  "transcript": [
    {
      "start": 123,
      "end": 123,
      "text": "<string>",
      "speaker": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Retrieve the completed results of your dubbing process with this endpoint. Once your dubbing task has finished processing, this API call provides access to the final dubbed media files along with a detailed transcript of the content. This allows you to seamlessly integrate the dubbed content into your applications, content management systems, or distribution platforms without requiring additional processing.

Understanding Dubbing Results

When you request the results of a completed dubbing task, our system returns a comprehensive package including:

Dubbed Video: A complete video file with the original visuals and newly generated voiceover in your target language.
Dubbed Audio: An isolated audio track containing only the synthesized speech in your target language.
Complete Transcript: A detailed, time-coded transcript of the dubbed content with speaker identification.

This multi-format approach gives you flexibility in how you utilize and distribute your newly localized content across various platforms and use cases.

Accessing You Dubbed content

To retrieve your dubbing results, you’ll need the run_id that was provided when during the polling of your dubbing task. This identifier uniquely tracks your specific dubbing task through our processing pipeline.

Example Request with Python

Here’s how to fetch your completed dubbing results 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"
}

def get_dubbing_result(run_id):
    """
    Retrieves the complete results of a finished dubbing task.
    Returns URLs to the final media files and a detailed transcript.
    """
    try:
        response = requests.get(
            f"https://client.camb.ai/apis/dub-result/{run_id}",
            headers=headers
        )

        # Verify the request was successful
        response.raise_for_status()

        # Extract the dubbing results
        result_data = response.json()

        print(f"Successfully retrieved dubbing results for Run ID: {run_id}")
        print(f"Video URL: {result_data['output_video_url']}")
        print(f"Audio URL: {result_data['output_audio_url']}")
        print(f"Transcript contains {len(result_data['transcript'])} dialogue entries")

        return result_data

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

run_id = 12345 # Replace with your actual `run_id` from the dubbing request
dubbing_results = get_dubbing_result(run_id)

# Process the transcript if results were successfully retrieved
if dubbing_results and 'transcript' in dubbing_results:
    print("\nTranscript Preview:")
    for i, dialogue in enumerate(dubbing_results['transcript'][:3]):  # Show first 3 entries
        print(f"Speaker {dialogue['speaker']}: {dialogue['text']} [{dialogue['start']} - {dialogue['end']}]")

    if len(dubbing_results['transcript']) > 3:
        print("... and more dialogue entries")

Authorizations

x-api-key

string

header

required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

run_id

integer

required

The unique identifier for the run, which was generated during the end to end dub creation process and returned upon task completion. The unique identifier for the run, which was generated during the creation process and returned upon task completion.

Response

Successful Response

video_url

string

Direct link to download the complete dubbed video file.

audio_url

string

Direct link to download the isolated dubbed audio track.

transcript

DialogueItem · object[]

Array of dialogue items containing speaker identification, timing information and textual transcript for each dialogue item.

Hide child attributes

transcript.start

number<float>

required

The start time (in seconds) of the dialogue.

transcript.end

number<float>

required

The end time (in seconds) of the dialogue.

transcript.text

string

required

The actual text content of the dialogue spoken by the speaker.

transcript.speaker

string

required

The name or identifier of the speaker delivering the dialogue.

Fetch Dubbing Results in BulkRetrieves the results of multiple dubbing runs simultaneously using an array of `run_id` values

Get Dubbed Run Info

curl --request GET \
  --url https://client.camb.ai/apis/dub-result/{run_id} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client.camb.ai/apis/dub-result/{run_id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client.camb.ai/apis/dub-result/{run_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/dub-result/{run_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "video_url": "<string>",
  "audio_url": "<string>",
  "transcript": [
    {
      "start": 123,
      "end": 123,
      "text": "<string>",
      "speaker": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Get Dubbing Result

Understanding Dubbing Results

Accessing You Dubbed content

Example Request with Python

Authorizations

Path Parameters

Response

​Understanding Dubbing Results

​Accessing You Dubbed content

​Example Request with Python

Authorizations

Path Parameters

Response

Understanding Dubbing Results

Accessing You Dubbed content

Example Request with Python