Create Dubbing

Create Dubbing

curl --request POST \
  --url https://public.reap.video/api/v1/automation/create-dubbing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "uploadId": "<string>",
  "sourceLanguage": "<string>",
  "targetLanguage": "<string>"
}
'

import requests

url = "https://public.reap.video/api/v1/automation/create-dubbing"

payload = {
    "uploadId": "<string>",
    "sourceLanguage": "<string>",
    "targetLanguage": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({uploadId: '<string>', sourceLanguage: '<string>', targetLanguage: '<string>'})
};

fetch('https://public.reap.video/api/v1/automation/create-dubbing', 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://public.reap.video/api/v1/automation/create-dubbing",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uploadId' => '<string>',
    'sourceLanguage' => '<string>',
    'targetLanguage' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public.reap.video/api/v1/automation/create-dubbing"

	payload := strings.NewReader("{\n  \"uploadId\": \"<string>\",\n  \"sourceLanguage\": \"<string>\",\n  \"targetLanguage\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public.reap.video/api/v1/automation/create-dubbing")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"uploadId\": \"<string>\",\n  \"sourceLanguage\": \"<string>\",\n  \"targetLanguage\": \"<string>\"\n}")
  .asString();

{
  "id": "<string>",
  "title": "<string>",
  "thumbnail": "<string>",
  "billedDuration": 123,
  "status": "queued",
  "projectType": "clipping",
  "source": "Upload",
  "genre": "talking",
  "topics": [
    "<string>"
  ],
  "clipDurations": [
    [
      123
    ]
  ],
  "selectedStart": 123,
  "selectedEnd": 123,
  "exportResolution": 123,
  "exportOrientation": "landscape",
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojis": true,
  "enableHighlights": true,
  "language": "<string>",
  "dubbingLanguage": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    "<string>"
  ],
  "transcriptionScript": "native",
  "metadata": {
    "width": 123,
    "height": 123,
    "aspectRatio": "<string>",
    "size": 123,
    "bitrate": 123,
    "fps": 123,
    "duration": 123,
    "rotation": 123,
    "resolution": 123,
    "codec": "<string>",
    "codecFullName": "<string>",
    "codecTag": "<string>",
    "format": "<string>",
    "formatFullName": "<string>"
  },
  "urls": {
    "videoFile": "<string>",
    "audioFile": "<string>",
    "transcription": "<string>",
    "transcription_srt": "<string>",
    "transcription_vtt": "<string>",
    "transcription_csv": "<string>",
    "transcription_txt": "<string>"
  },
  "createdAt": 123,
  "updatedAt": 123
}

POST

automation

create-dubbing

Create Dubbing

curl --request POST \
  --url https://public.reap.video/api/v1/automation/create-dubbing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "uploadId": "<string>",
  "sourceLanguage": "<string>",
  "targetLanguage": "<string>"
}
'

import requests

url = "https://public.reap.video/api/v1/automation/create-dubbing"

payload = {
    "uploadId": "<string>",
    "sourceLanguage": "<string>",
    "targetLanguage": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({uploadId: '<string>', sourceLanguage: '<string>', targetLanguage: '<string>'})
};

fetch('https://public.reap.video/api/v1/automation/create-dubbing', 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://public.reap.video/api/v1/automation/create-dubbing",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uploadId' => '<string>',
    'sourceLanguage' => '<string>',
    'targetLanguage' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public.reap.video/api/v1/automation/create-dubbing"

	payload := strings.NewReader("{\n  \"uploadId\": \"<string>\",\n  \"sourceLanguage\": \"<string>\",\n  \"targetLanguage\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public.reap.video/api/v1/automation/create-dubbing")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"uploadId\": \"<string>\",\n  \"sourceLanguage\": \"<string>\",\n  \"targetLanguage\": \"<string>\"\n}")
  .asString();

{
  "id": "<string>",
  "title": "<string>",
  "thumbnail": "<string>",
  "billedDuration": 123,
  "status": "queued",
  "projectType": "clipping",
  "source": "Upload",
  "genre": "talking",
  "topics": [
    "<string>"
  ],
  "clipDurations": [
    [
      123
    ]
  ],
  "selectedStart": 123,
  "selectedEnd": 123,
  "exportResolution": 123,
  "exportOrientation": "landscape",
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojis": true,
  "enableHighlights": true,
  "language": "<string>",
  "dubbingLanguage": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    "<string>"
  ],
  "transcriptionScript": "native",
  "metadata": {
    "width": 123,
    "height": 123,
    "aspectRatio": "<string>",
    "size": 123,
    "bitrate": 123,
    "fps": 123,
    "duration": 123,
    "rotation": 123,
    "resolution": 123,
    "codec": "<string>",
    "codecFullName": "<string>",
    "codecTag": "<string>",
    "format": "<string>",
    "formatFullName": "<string>"
  },
  "urls": {
    "videoFile": "<string>",
    "audioFile": "<string>",
    "transcription": "<string>",
    "transcription_srt": "<string>",
    "transcription_vtt": "<string>",
    "transcription_csv": "<string>",
    "transcription_txt": "<string>"
  },
  "createdAt": 123,
  "updatedAt": 123
}

For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

Overview

Transform your video content with AI-powered voice dubbing. This endpoint creates natural-sounding voiceovers in different languages while preserving the original speaker’s tone and emotion. Perfect for localizing content for global audiences.

Rate Limiting

This endpoint allows 10 requests per minute per API key. Each endpoint has its own budget, so this allowance is not shared with the rest of the API — see Rate limiting.

Use the Get Dubbing Languages endpoint to retrieve all supported language codes.

Video Requirements

Duration

Minimum: 3 seconds
Maximum: 10 minutes

File Size

Maximum: 2 GB

Format

MP4 or MOV with clear audio

Content Type

Works best with clear speech and dialogue

Plan Limits

Plan	Concurrent Projects
Creator	3
Studio	10

Higher-tier plans allow you to process more videos simultaneously.

The Automation API requires an active subscription. View pricing to compare plans.

Response

string

Unique project identifier

string

Project title (usually the filename)

string

URL to the project thumbnail image

number

Duration in seconds that will be billed to your account

string

Current processing status (“processing”, “completed”, “failed”)

string

Type of project (“dubbing”)

string

Source of the original video (“Upload”)

string

Source language of the original video

string

Target language for dubbing

object

Video metadata including duration, resolution, format, etc.

object

Object containing project URLs and assets

integer

Unix timestamp when the project was created

integer

Unix timestamp when the project was last updated

Example Request

curl -X POST "https://public.reap.video/api/v1/automation/create-dubbing" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "sourceLanguage": "en-US",
    "targetLanguage": "es-MX"
  }'

const response = await fetch('https://public.reap.video/api/v1/automation/create-dubbing', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    uploadId: '65f1a2b3c4d5e6f7a8b9c0d1',
    sourceLanguage: 'en-US',
    targetLanguage: 'es-MX'
  })
});

const project = await response.json();
console.log('Dubbing project created:', project.id);
console.log('Status:', project.status);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

data = {
    'uploadId': '65f1a2b3c4d5e6f7a8b9c0d1',
    'sourceLanguage': 'en-US',
    'targetLanguage': 'es-MX'
}

response = requests.post(
    'https://public.reap.video/api/v1/automation/create-dubbing',
    headers=headers,
    json=data
)

project = response.json()
print(f"Dubbing project created: {project['id']}")
print(f"Status: {project['status']}")

<?php
$ch = curl_init('https://public.reap.video/api/v1/automation/create-dubbing');
$data = [
    'uploadId' => '65f1a2b3c4d5e6f7a8b9c0d1',
    'sourceLanguage' => 'en-US',
    'targetLanguage' => 'es-MX'
];
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$project = json_decode($response, true);
echo 'Dubbing project created: ' . $project['id'] . "\n";
echo 'Status: ' . $project['status'] . "\n";
?>

package main
import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)
func main() {
    url := "https://public.reap.video/api/v1/automation/create-dubbing"
    data := map[string]interface{}{
        "uploadId": "65f1a2b3c4d5e6f7a8b9c0d1",
        "sourceLanguage": "en-US",
        "targetLanguage": "es-MX",
    }
    payload, _ := json.Marshal(data)
    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
public class CreateDubbingExample {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://public.reap.video/api/v1/automation/create-dubbing");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
        conn.setRequestProperty("Content-Type", "application/json");
        conn.setDoOutput(true);
        String jsonInputString = "{" +
            "\"uploadId\": \"65f1a2b3c4d5e6f7a8b9c0d1\"," +
            "\"sourceLanguage\": \"en-US\"," +
            "\"targetLanguage\": \"es-MX\"}";
        try(OutputStream os = conn.getOutputStream()) {
            byte[] input = jsonInputString.getBytes("utf-8");
            os.write(input, 0, input.length);
        }
        BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "utf-8"));
        StringBuilder response = new StringBuilder();
        String responseLine;
        while ((responseLine = br.readLine()) != null) {
            response.append(responseLine.trim());
        }
        System.out.println("Dubbing project: " + response.toString());
    }
}

Example Response

Processing Workflow

Audio Extraction

Extract and analyze the audio track from your video

Speech Recognition

Transcribe the original speech with precise timing

Language Translation

Translate the transcription to the target language

Voice Synthesis

Generate natural-sounding speech in the target language

Audio Synchronization

Sync the new audio with the original video timing

Final Rendering

Combine dubbed audio with original video

Language Pair Quality

Different language pairs have varying quality levels:

Premium Quality

English ↔ Spanish, French, German, Portuguese
Highest quality voice models and cultural adaptation

High Quality

English ↔ Italian, Dutch, Japanese, Korean
Excellent voice quality with good cultural nuances

Good Quality

English ↔ Chinese, Arabic, Hindi, Russian
Good voice quality, suitable for most content types

Standard Quality

Other language pairs
Standard quality, continuously improving

Monitoring Progress

Monitor the dubbing project using these endpoints:

Get Project Status - Quick status check
Get Project Details - Full project information
Get Project Clips - Retrieve finished dubbed video

Best Practices

Dubbing Optimization Tips:

Use high-quality source audio for better results
Choose appropriate regional language variants for your target audience
Test with shorter clips first to evaluate voice quality
Consider the cultural context of your target language
Ensure clear speech in the original video for best results

Common Use Cases

Global Content Platforms

Automatically localize content libraries for international audiences

E-Learning Providers

Scale course content to new markets without re-recording

Enterprise Communications

Dub internal videos for multinational teams

Media Localization Services

Offer AI dubbing as a service to your clients

Next Steps

After creating a dubbing project:

Monitor progress with Get Project Status
Retrieve the dubbed video with Get Project Clips
Use the dubbed content in your applications or download for distribution

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

uploadId

string

required

Upload ID from a previously uploaded file

sourceLanguage

string

required

Language code of the original video content (e.g. en-US, es-ES)

targetLanguage

string

required

Language code for the dubbing target (e.g. fr-FR, de-DE)

Response

200 - application/json

Successful response

string

title

string

thumbnail

string

billedDuration

number

status

enum<string>

Available options:

queued,

prepped,

draft,

processing,

finalizing,

completed,

invalid,

expired,

failed,

error

projectType

enum<string>

Available options:

clipping,

captions,

reframe,

dubbing,

transcription

source

enum<string>

Available options:

Upload,

Youtube,

Vimeo,

TwitchVod,

Twitter,

RumbleEmbed,

Generic

genre

enum<string>

default:talking

Available options:

talking,

screenshare,

gaming

topics

string[]

clipDurations

integer[][]

selectedStart

number | null

selectedEnd

number | null

exportResolution

integer

exportOrientation

enum<string>

Available options:

landscape,

portrait,

square

captionsPreset

string | null

enableCaptions

boolean

enableEmojis

boolean

enableHighlights

boolean

language

string | null

dubbingLanguage

string | null

translateTranscription

boolean

translationLanguages

string[]

transcriptionScript

enum<string>

default:native

Available options:

native,

roman

metadata

object

Show child attributes

urls

object

Presigned URLs for the project's assets. URLs expire — always use the most recent API response. The transcription_* subtitle/text exports are only present on transcription projects.

Show child attributes

createdAt

integer

updatedAt

integer

Getting Started

Presets & Languages

Upload Files

Create Projects

Track & Retrieve

Manage Projects

Publishing

Billing & Usage

Overview

Rate Limiting

Video Requirements

Duration

File Size

Format

Content Type

Plan Limits

Response

Example Request

Example Response

Processing Workflow

Language Pair Quality

Premium Quality

High Quality

Good Quality

Standard Quality

Monitoring Progress

Best Practices

Common Use Cases

Global Content Platforms

E-Learning Providers

Enterprise Communications

Media Localization Services

Next Steps

Authorizations

Body

Response

​Overview

​Rate Limiting

​Video Requirements

Duration

File Size

Format

Content Type

​Plan Limits

​Response

​Example Request

​Example Response

​Processing Workflow

​Language Pair Quality

Premium Quality

High Quality

Good Quality

Standard Quality

​Monitoring Progress

​Best Practices

​Common Use Cases

Global Content Platforms

E-Learning Providers

Enterprise Communications

Media Localization Services

​Next Steps

Authorizations

Body

Response

Overview

Rate Limiting

Video Requirements

Plan Limits

Response

Example Request

Example Response

Processing Workflow

Language Pair Quality

Monitoring Progress

Best Practices

Common Use Cases

Next Steps